How It Works
Claude Code stores its configuration and auth credentials in~/.claude by default. The CLAUDE_CONFIG_DIR environment variable overrides this location. By creating a separate config directory per account - each with its own OAuth credentials - and symlinking shared resources back to a canonical source, you get:
- Separate billing/authentication per account
- Shared sessions - resume any session from either account
- Shared settings, plugins, commands, plans, and skills - configure once, use everywhere
One-Time Setup
This setup is done once on your machine, outside of Maestro.1. Authenticate Each Account
Start Claude Code normally and complete OAuth for your first account:The main
~/.claude/ directory doesn’t need its own .claude.json. It serves as the canonical source for shared resources.2. Symlink Shared Resources
For each account directory, replace local copies with symlinks back to~/.claude so settings, plugins, and sessions stay in sync:
What’s Shared vs. Account-Specific
Configuring Agents in Maestro
Once your config directories exist, point each Maestro agent at the right one using theCLAUDE_CONFIG_DIR environment variable.
When Creating a New Agent
- Click + in the sidebar to create a new agent
- Select Claude Code as the provider
- Expand the Environment Variables section
- Click + Add Variable
- Set
CLAUDE_CONFIG_DIRto your account’s config path (e.g.,/Users/you/.claude-personal)
When Editing an Existing Agent
- Right-click an agent in the sidebar → Edit Agent, or use
Cmd+E/Ctrl+E - Scroll to the Environment Variables section
- Add
CLAUDE_CONFIG_DIRwith the path to the desired account’s config directory

Recommended Setup
Create one agent per account and name them clearly:
This way you can see at a glance which account’s quota you’re using. When one account hits its limit, switch to the other.
Tips
- Session resume works cross-account - because
projects/is symlinked, you can start a session on one account and resume it on another. - Don’t run both on the same project simultaneously - two Claude instances writing to the same session files can cause contention. Use one at a time per project.
- Symlinks may break after Claude Code updates - if an update recreates a directory, re-run the symlink commands from step 2.