multicc

Fast, cross-platform multi-account manager for Claude Code. Maintains isolated config directories per profile and sets CLAUDE_CONFIG_DIR before launching Claude.

Features

• Named Profiles - Create and switch between multiple Claude Code accounts
• Auth Flexibility - Supports OAuth, API key, Bedrock, Vertex and Foundry
• Secure Storage - API keys stored in OS keyring with plaintext fallback
• Shell Integration - Works with bash, zsh, fish and PowerShell
• Cross-Platform - Works on Windows, macOS and Linux

Installation

npm install -g multicc

Requirements

• Node.js 18+
• Native keyring (@napi-rs/keyring) ships precompiled binaries for the common targets — Apple Silicon and Intel macOS, Windows x64/arm64, Linux x64/arm64 (glibc & musl). No build step is required on a normal install.
• Build tools are only needed if a prebuilt binary isn't available for your platform (rare):
  • Windows: Visual C++ Build Tools
  • macOS: Xcode Command Line Tools (xcode-select --install)
  • Linux: build-essential and libsecret-1-dev

macOS note: The first time multicc set-key stores an API key, macOS will show a Keychain prompt asking whether node may access the keyring. Click Always Allow to avoid being asked again. If you decline, the API key falls back to a chmod 600 file at ~/.multicc/profiles/<name>/.api-key.

Quick Start

# Create a profile
multicc create work --auth-type oauth

# Launch Claude Code (authenticates on first run)
multicc launch work

Usage

Profile Management

multicc create <name>          # Create a new profile
multicc list                   # List all profiles
multicc use <name>             # Switch active profile
multicc profile show [name]    # Show profile details
multicc profile delete <name>  # Delete a profile
multicc profile import         # Import existing Claude config

Session Commands

multicc launch [name]          # Launch Claude Code with a profile
multicc set-key [name]         # Store an API key
multicc status                 # Show status of all profiles

Advanced

multicc exec [name] -- <cmd>   # Run a command with profile environment
multicc shell [name]           # Open a subshell with profile environment
multicc shell-init             # Output shell integration code

Shell Integration

Add to your shell profile for automatic profile activation:

eval "$(multicc shell-init)"

Data Layout

~/.multicc/
  config.json              # Profile registry and active profile
  profiles/
    <name>/                # Each profile becomes a CLAUDE_CONFIG_DIR
      .credentials.json    # OAuth tokens
      .api-key             # Plaintext API key fallback
      settings.json        # Claude Code settings

Development

# Clone the repository
git clone https://github.com/fmdz387/multicc.git
cd multicc

# Install dependencies
pnpm install

# Build
pnpm build

# Run from source
pnpm dev

# Type checking
pnpm typecheck

# Link globally for testing
pnpm link:global

# Unlink when done
pnpm unlink:global

License

MIT - Copyright (c) 2025 fmdz387