Stop editing config files. Start switching in seconds.
Why claudectx?
The Problem: You're juggling multiple Claude Code setups—work account, personal projects, different API providers, client-specific instructions. Every time you need to switch, you're manually editing settings.json, swapping CLAUDE.md files, and hoping you don't break something.
The Solution: claudectx lets you switch your entire Claude Code configuration with a single command. No more file editing. No more mistakes. Just type claudectx work and you're done.
# Before: Edit files, copy settings, pray nothing breaks
vim ~/.claude/settings.json # 😰
# After: One command, instant switch
claudectx work # ✅
Why Developers Choose claudectx
| Pain Point | How claudectx Helps |
|---|---|
| "I keep overwriting my settings" | Automatic backups before every switch |
| "Switching takes 5+ minutes" | Switch in under 1 second |
| "I broke my config and lost work" | Instant rollback if anything fails |
| "I have 4 different API providers" | Unlimited profiles, easy toggle |
| "My team needs the same setup" | Export/import profiles as JSON |
| "I need work and personal open at the same time" | claudectx run launches per-session without touching global config |
Who Benefits Most
- Consultants & Freelancers — Switch between client configs instantly
- Teams — Share standardized profiles across developers
- Power Users — Test different models, API providers, and MCP servers
- Anyone who's tired of manual configuration management
What is claudectx?
claudectx is a command-line tool that lets you quickly switch between different Claude Code configurations. Think of it like profiles for your browser, but for Claude Code.
Perfect for:
- 👔 Switching between work and personal Claude accounts
- 🏢 Managing different client configurations
- 🔌 Testing different API providers (Anthropic, Bedrock, OpenRouter, Z.AI, custom endpoints)
- 🛠️ Using different tool permissions and MCP servers
- 📝 Maintaining separate instruction sets (CLAUDE.md files)
Quick Start
Interactive Mode
The easiest way to switch profiles:
claudectx
Use ↑/↓ arrow keys to navigate, Enter to select:
Select a profile:
work
❯ personal (current)
client-acme
Use ↑/↓ to navigate, Enter to select, Esc/Ctrl+C to cancel
Direct Switch
If you know the profile name:
claudectx work
Run a Single Session Without Switching
Open a Claude session using a profile without changing your global config.
Useful when you want work and personal sessions open at the same time:
claudectx run work
Pass extra Claude flags after --:
claudectx run work -- --model opus
claudectx run review -- -p "Review this diff"
Preview the command without launching:
claudectx run work --dry-run
See Switch vs Run for a full comparison.
Toggle Between Profiles
Quickly switch back and forth:
claudectx -
Installation
macOS / Linux (Homebrew)
brew install foxj77/tap/claudectx
This will install claudectx and shell completions automatically.
Manual Installation
Option 1: Install to your user directory (no sudo required)
cd ~/Downloads
git clone https://github.com/foxj77/claudectx.git
cd claudectx
make install-user
This installs to ~/go/bin/claudectx. Make sure ~/go/bin is in your PATH:
# For bash
echo 'export PATH="$PATH:~/go/bin"' >> ~/.bashrc
source ~/.bashrc
# For zsh
echo 'export PATH="$PATH:~/go/bin"' >> ~/.zshrc
source ~/.zshrc
Option 2: Install system-wide
No comments yet.