fprochazka

Claude Code Auth Switch — Git skill for Claude Code

Git community

Note: This has only been tested on Linux.

How to install Claude Code Auth Switch

This entry records only its repository, not the path inside it, so there is no exact command to give. Open fprochazka/claude-code-auth-switch and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Code Auth Switch does

**Note:** This has only been tested on Linux. macOS and Windows may not work as expected — macOS in particular has a [Keychain collision bug](https://github.com/anthropics/claude-code/issues/20553)

Alternatives in Git

Worktree Deliver — Commit all work, push, and create a pull request from the current worktree 23.4k ★
Container Use — by dagger - Development environments for coding agents 3.6k ★
Swarm Parent — You are the swarm coordinator for the {{tentacleName}} tentacle 1.4k ★

README

claude-code-auth-switch

**Note:** This has only been tested on Linux. macOS and Windows may not work as expected — macOS in particular has a [Keychain collision bug](https://github.com/anthropics/claude-code/issues/20553) that breaks multi-account OAuth isolation.

Run multiple [Claude Code](https://docs.anthropic.com/en/docs/claude-code) accounts side-by-side with isolated credentials, shared configuration, and zero Docker overhead.

Each profile gets its own `claude-` command on your `$PATH`:

claude-personal     # Personal Anthropic subscription (OAuth)
claude-work-team    # Company team subscription (OAuth)
claude-work-vertex  # Company via Google Cloud Vertex AI

Run them in parallel across different project directories without credential collisions, file lock conflicts, or billing mix-ups.

How it works

Claude Code's `CLAUDE_CONFIG_DIR` environment variable redirects all configuration and credential storage to a custom directory. We [verified in the binary](docs/Binary-Analysis-and-Design-Decisions.md) that this provides **full isolation** — including the `~/.claude.json` state file, which contrary to [some reports](docs/Gemini-Symlink-Behavior-Research.md) is **not** hardcoded to the home directory.

The install script reads `~/.claude/auth-switch.yaml`, creates a profile directory per account under `~/.claude-profiles/`, and generates thin wrapper scripts that set the right environment variables before `exec`-ing `claude`:

~/.claude/
├── auth-switch.yaml          # Your profile definitions
└── auth-switch.secrets.yaml  # Secret env values (gitignored, optional)

~/.claude-profiles/
├── personal/                # Profile: claude-personal
│   ├── settings.json        # Copied from ~/.claude/ (mutable)
│   ├── settings.local.json  # Copied from ~/.claude/ (mutable)
│   ├── CLAUDE.md            # Copied from ~/.claude/ (mutable, plus any other *.md files)
│   ├── keybindings.json     # Copied from ~/.claude/ (mutable)
│   ├── commands