claude-code-swap (ccs)

Switch Claude Code provider profiles with one command.

Claude Code is locked to Anthropic models by default. ccs (Claude Code Switch) lets you manage multiple provider profiles — Ollama, OpenRouter, Gemini, OpenAI, or any OpenAI-compatible endpoint — and launch Claude Code with the right environment variables in a single command.

No proxy layer. No added latency. Just environment variables.

Install

# Homebrew (recommended):
brew install tensakulabs/tap/claude-code-swap

# npm (shim — requires the binary on PATH):
npm install -g @tensakulabs/ccs

Or download a pre-built binary from Releases.

Quick Start

# First-time setup
ccs init

# Switch to Ollama
ccs use ollama

# Launch Claude Code (uses active profile automatically)
ccs

# Switch back to Anthropic subscription
ccs use default
ccs

Commands

# Launch (uses active profile)
ccs                             # Launch with active profile
ccs run ollama                  # One-shot with specific profile (doesn't change active)

# Switching
ccs use ollama                  # Set ollama as active (persists across sessions)
ccs use default                 # Back to Anthropic subscription
ccs status                      # Show active profile and its config

# Profile management
ccs profile list                # List all profiles (* = active)
ccs profile add mywork          # Add a new profile interactively
ccs profile add mywork --preset openrouter   # Add from a preset
ccs profile edit mywork         # Edit in $EDITOR
ccs profile remove mywork       # Delete a profile
ccs profile show mywork         # Show full profile config

# Diagnostics
ccs test                        # Test active profile connectivity
ccs test ollama                 # Test specific profile
ccs doctor                      # System health check
ccs config                      # Open config.yaml in $EDITOR
ccs --version

How It Works

ccs stores your profiles in ~/.claude-code-swap/config.yaml. When you run ccs, it:

1. Reads the active profile from ~/.claude-code-swap/state.yaml
2. Resolves any ${ENV_VAR} references from your shell environment
3. Constructs the appropriate ANTHROPIC_* environment variables
4. Execs claude — replacing its own process with Claude Code

No proxy. No subprocess. No added latency. After exec, ccs is completely out of the picture.

Configuration

~/.claude-code-swap/config.yaml — your profiles:

profiles:
  default: {}  # No overrides — uses Anthropic subscription as-is

  ollama:
    base_url: http://localhost:11434/v1
    auth_token: ollama
    models:
      haiku: llama3.2:3b
      sonnet: llama3.1:8b
      opus: llama3.1:70b

  openrouter:
    base_url: https://openrouter.ai/api/v1
    auth_token: ${OPENROUTER_API_KEY}   # resolved from your shell env at launch
    api_key: ""
    models:
      haiku: qwen/qwen3-4b:free
      sonnet: qwen/qwen3-coder:free
      opus: deepseek/deepseek-r1-0528:free

  gemini:
    base_url: https://generativelanguage.googleapis.com/v1beta/openai
    auth_token: ${GEMINI_API_KEY}
    api_key: ""
    models:
      haiku: gemini-2.0-flash
      sonnet: gemini-2.5-flash
      opus: gemini-2.5-pro

~/.claude-code-swap/state.yaml — active profile (written by ccs use):

active: ollama

State is separated from config so ccs use never touches your hand-edited profiles.

Environment Variable Mapping

| Profile field | Environment variable | |---|---| | base_url | ANTHROPIC_BASE_URL | | auth_token | ANTHROPIC_AUTH_TOKEN | | api_key | ANTHROPIC_API_KEY | | models.haiku | ANTHROPIC_DEFAULT_HAIKU_MODEL | | models.sonnet | ANTHROPIC_DEFAULT_SONNET_MODEL | | models.opus | ANTHROPIC_DEFAULT_OPUS_MODEL | | env.* | Passed through as-is |

The default profile sets none of these — Claude Code runs with your existing environment untouched.

Provider Presets

ccs profile add myprofile --preset openrouter pre-fills defaults:

| Preset | Base URL | |---|---| | ollama | http://localhost:11434/v1 | | openrouter | https://openrouter.ai/api/v1 | | gemini | https://generativelanguage.googleapis.com/v1beta/openai | | openai | https://api.openai.com/v1 | | custom | (you provide) |

Security

• Never hardcode API keys — always use ${ENV_VAR} references. ccs warns you if it detects a key-like string in your config.
• ~/.claude-code-swap/ is created with 0700, files with 0600.
• ccs makes no network calls during normal launch — only during ccs test.
• State file contains only a profile name, no secrets.

Requirements

• Claude Code (npm install -g @anthropic-ai/claude-code)

License

MIT — see LICENSE