Claudectx

Fast way to switch between Claude Code configuration profiles

LLM Mart 14 views 713k listing impressions

Stop editing config files. Start switching in seconds.

Version License Tests


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

From the project's README.

Comments (0)

Sign in to join the conversation.

No comments yet.