claudectx

Launch Claude Code with different profiles

What is this?

claudectx manages multiple Claude Code profiles (Claude Max, Claude Team, personal) and launches Claude with the selected profile. Each profile is a complete claude.json config with its own account, MCP servers, and settings. Inspired by kubectx.

How it works

1. Save: claudectx save work copies ~/.claude.json to ~/.claudectx/work.claude.json
2. Launch: claudectx work switches ~/.claude.json symlink → profile, then launches claude

The symlink ensures Claude reads the correct account configuration.

Features

• Profile switching - Symlink-based switching for proper account isolation
• Direct launch - Launches Claude automatically after switching
• Save profiles - Store complete Claude configurations locally
• Quick switch - Interactive selection with arrow keys
• Pass-through args - Forward arguments to Claude: claudectx work -- --dangerously-skip-permissions
• Auto-slugify - Profile names are normalized (FG@Work → fg-work)
• Zero config - Works out of the box

Sponsors

Natalia 24/7 AI voice and whatsapp agent for customer services

NoBullshitConseil 360° tech consulting

Hook0 Open-Source Webhooks-as-a-Service

France-Nuage Sovereign cloud hosting in France

Interested in sponsoring? Get in touch

Quick Start

# 1. Install
brew install FGRibreau/tap/claudectx

# 2. Save your current account as a profile
claudectx save work

# 3. Launch Claude with the profile
claudectx work

Installation

macOS

# Homebrew (recommended)
brew install FGRibreau/tap/claudectx

# or with Cargo
cargo install claudectx

Linux

# Debian/Ubuntu (.deb)
curl -LO https://github.com/FGRibreau/claudectx/releases/latest/download/claudectx_0.1.0_amd64.deb
sudo dpkg -i claudectx_0.1.0_amd64.deb

# Cargo (all distros)
cargo install claudectx

# or download binary
curl -LO https://github.com/FGRibreau/claudectx/releases/latest/download/claudectx_linux_x86_64.tar.gz
tar -xzf claudectx_linux_x86_64.tar.gz
sudo mv claudectx /usr/local/bin/

Windows

# Chocolatey
choco install claudectx

# Scoop
scoop bucket add extras
scoop install claudectx

# or with Cargo
cargo install claudectx

All platforms

git clone https://github.com/FGRibreau/claudectx.git
cd claudectx
cargo build --release
sudo cp target/release/claudectx /usr/local/bin/

Usage

Examples

# Launch Claude with "work" profile
claudectx work

# Launch with extra arguments
claudectx work -- --dangerously-skip-permissions

# Save current ~/.claude.json as "personal" profile
claudectx save personal

# Interactive selection then launch
claudectx

# List all profiles (* marks current)
claudectx list
# Output:
# work - FG @ Company *
# personal - FG @ Personal

Configuration

Storage

Profiles are stored as individual JSON files in ~/.claudectx/:

~/.claudectx/
├── work.claude.json
├── personal.claude.json
└── side-project.claude.json

When you run claudectx <profile>:

1. ~/.claude.json becomes a symlink → ~/.claudectx/<profile>.claude.json
2. Claude is launched and reads from the symlinked config

Each profile is a complete copy of ~/.claude.json, including:

• OAuth account (email, organization)
• MCP servers configuration
• Claude Code settings
• API keys

Profile Names

Profile names are automatically slugified:

• My Work Profile → my-work-profile
• FG@Company → fg-company
• Test Name → test-name

License

MIT