Before you add a Claude Code account
A variable such asANTHROPIC_API_KEY, or apiKeyHelper in Claude Code’s settings, makes Claude Code ignore the login Pitboard switches. Changes to Claude Code accounts still go ahead, with the warning auth_overridden. Variables that override the login lists them all. To check, run:
what a session authenticates with line warns and names the setting when Claude Code signs in another way.
While CLAUDE_CODE_CUSTOM_OAUTH_URL is set, Pitboard refuses every change to Claude Code accounts with custom_oauth_endpoint. Custom OAuth endpoint says why.
Add Claude Code accounts
Add each one as Add another account shows. In the app, choose Claude Code if the dialog has a Tool pop-up menu. A label with no prefix enrols a Claude Code account:pitboard enroll work --sign-in adds one. pitboard enroll personal enrols the account Claude Code is signed in to, as Add the account you are signed in to shows. Where another tool also has a work, other commands need claude/work: see Labels.
Do not add an account with Claude Code’s /login, as Add another account warns.
If Pitboard says claude is not on this machine, see Pitboard cannot find a tool.
How Claude Code accounts differ
- Open Claude Code sessions follow a switch with no restart. How open sessions follow a switch says how soon, and what can pin them.
- Pitboard switches only Claude Code by itself: see Switch before an account runs out.
- Pitboard warms up only Claude Code accounts: see Warm up accounts.
pitboard statuslineshows each Claude Code account’s usage in Claude Code’s status line: see Show usage in Claude Code’s status line.- Pitboard asks Anthropic to identify a Claude Code login: see How Pitboard knows whose login it is.
/statusin Claude Code can name another account than Pitboard shows: see Claude Code shows another account than Pitboard.- A parked Claude Code login expires if Pitboard does not run to renew it: see Keep parked logins alive.
- In the app, a Claude Code account’s account window opens claude.ai.