claude-profile

Launch Claude Code with isolated config directories per profile. Each profile stores its own credentials and session history, so you can maintain multiple Claude accounts without re-authenticating.

Requirements

• uv — Python package manager used to install and run claude-profile
• claude — Claude Code CLI must be installed and on your PATH

Install

From GitHub (no clone required):

uv tool install git+https://github.com/quickvm/claude-profile

From a local clone:

uv tool install .

Usage

claude-profile add <name>        # create a new profile
claude-profile list              # list all profiles and auth status
claude-profile remove <name>     # delete a profile
claude-profile links <name>      # inspect or change directory symlinks
claude-profile <name> [args...]  # launch claude with the given profile

Creating a profile

add copies settings.json, statusline.sh, and CLAUDE.md from ~/.claude into the new profile directory, then prompts whether to symlink commands/ and skills/ to your global ~/.claude directories (default: yes). Decline to keep those directories isolated per profile.

claude-profile add work
# Link 'commands' to ~/.claude/commands? [Y/n]:
# Link 'skills' to ~/.claude/skills? [Y/n]:

Managing directory links

Use links to inspect or change how commands/ and skills/ are connected after a profile is created:

claude-profile links work                   # show link status for all dirs
claude-profile links work commands          # show link status for commands/ only

claude-profile links work --link            # symlink all dirs to ~/.claude
claude-profile links work commands --link   # symlink just commands/

claude-profile links work --unlink          # isolate all dirs
claude-profile links work skills --unlink   # isolate just skills/

Examples

claude-profile add work
claude-profile add personal
claude-profile work                   # launch claude with work profile
claude-profile personal --resume      # pass args through to claude

Add aliases to ~/.bashrc:

alias claude-work='claude-profile work'
alias claude-personal='claude-profile personal'

Configuration

Variable	Default	Description
CLAUDE_PROFILE_PROFILES_BASE	~/.claude-profiles	Directory where profiles are stored
CLAUDE_PROFILE_CLAUDE_BIN	claude	Path to the claude binary

License

MIT