Claude Code Switch - Instant profile switching between Claude Sonnet 4.5 and GLM 4.6
npm install @kaitranntt/ccs


| Capability | What It Does | Manage Via |
|------------|--------------|------------|
| Multiple Claude Accounts | Run work + personal Claude subs simultaneously | Dashboard |
| OAuth Providers | Gemini, Codex, Antigravity - zero API keys needed | Dashboard |
| API Profiles | GLM, Kimi, or any Anthropic-compatible API | Dashboard |
``bash`
npm install -g @kaitranntt/ccs
Alternative package managers
`bash`
yarn global add @kaitranntt/ccs # yarn
pnpm add -g @kaitranntt/ccs # pnpm (70% less disk space)
bun add -g @kaitranntt/ccs # bun (30x faster)
`bash`
ccs configOpens http://localhost:3000
Want to run the dashboard in Docker? See docker/README.md.
The dashboard provides visual management for all account types:
- Claude Accounts: Create isolated instances (work, personal, client)
- OAuth Providers: One-click auth for Gemini, Codex, Antigravity
- API Profiles: Configure GLM, Kimi with your keys
- Health Monitor: Real-time status across all profiles
Analytics Dashboard
Live Auth Monitor
CLI Proxy API & Copilot Integration
WebSearch Fallback
| Provider | Auth Type | Command | Best For |
|----------|-----------|---------|----------|
| Claude | Subscription | ccs | Default, strategic planning |ccs gemini
| Gemini | OAuth | | Zero-config, fast iteration |ccs codex
| Codex | OAuth | | Code generation |ccs copilot
| Copilot | OAuth | or ccs ghcp | GitHub Copilot models |ccs kiro
| Kiro | OAuth | | AWS CodeWhisperer (Claude-powered) |ccs agy
| Antigravity | OAuth | | Alternative routing |ccs openrouter
| OpenRouter | API Key | | 300+ models, unified API |ccs ollama
| Ollama | Local | | Local open-source models, privacy |ccs ollama-cloud
| Ollama Cloud | API Key | | Cloud-hosted open-source models |ccs glm
| GLM | API Key | | Cost-optimized execution |ccs kimi
| Kimi | API Key | | Long-context, thinking mode |ccs foundry
| Azure Foundry | API Key | | Claude via Microsoft Azure |ccs mm
| Minimax | API Key | | M2 series, 1M context |ccs deepseek
| DeepSeek | API Key | | V3.2 and R1 reasoning |ccs qwen
| Qwen | API Key | | Alibaba Cloud, qwen3-coder |
OpenRouter Integration (v7.0.0): CCS v7.0.0 adds OpenRouter with interactive model picker, dynamic discovery, and tier mapping (opus/sonnet/haiku). Create via ccs api create --preset openrouter or dashboard.
Ollama Integration: Run local open-source models (qwen3-coder, gpt-oss:20b) with full privacy. Use ccs api create --preset ollama - requires Ollama v0.14.0+ installed. For cloud models, use ccs api create --preset ollama-cloud.
Azure Foundry: Use ccs api create --preset foundry to set up Claude via Microsoft Azure AI Foundry. Requires Azure resource and API key from ai.azure.com.
> OAuth providers authenticate via browser on first run. Tokens are cached in ~/.ccs/cliproxy/auth/.
Powered by:
- CLIProxyAPIPlus - Extended OAuth proxy with Kiro (@fuko2935, @Ravens2121) and Copilot (@em4go) support
- CLIProxyAPI - Core OAuth proxy for Gemini, Codex, Antigravity
- copilot-api - GitHub Copilot API integration
> [!TIP]
> Need more? CCS supports any Anthropic-compatible API. Create custom profiles for self-hosted LLMs, enterprise gateways, or alternative providers. See API Profiles documentation.
`bash`
ccs # Default Claude session
ccs gemini # Gemini (OAuth)
ccs codex # OpenAI Codex (OAuth)
ccs kiro # Kiro/AWS CodeWhisperer (OAuth)
ccs ghcp # GitHub Copilot (OAuth device flow)
ccs agy # Antigravity (OAuth)
ccs ollama # Local Ollama (no API key needed)
ccs glm # GLM (API key)
Run multiple terminals with different providers:
`bashTerminal 1: Planning (Claude Pro)
ccs work "design the authentication system"
$3
Create isolated Claude instances for work/personal separation:
`bash
ccs auth create workRun concurrently in separate terminals
ccs work "implement feature" # Terminal 1
ccs "review code" # Terminal 2 (personal account)
`
Maintenance
$3
`bash
ccs doctor
`Verifies: Claude CLI, config files, symlinks, permissions.
$3
`bash
ccs update # Update to latest
ccs update --force # Force reinstall
ccs update --beta # Install dev channel
`$3
`bash
ccs sync
`Re-creates symlinks for shared commands, skills, and settings.
$3
`bash
ccs cliproxy doctor # Check quota status for all agy accounts
`Auto-Failover: When an Antigravity account runs out of quota, CCS automatically switches to another account with remaining capacity. Shared GCP project accounts are excluded (pooled quota).
Configuration
CCS auto-creates config on install. Dashboard is the recommended way to manage settings.
Config location:
~/.ccs/config.yaml
Custom Claude CLI path
If Claude CLI is installed in a non-standard location:
`bash
export CCS_CLAUDE_PATH="/path/to/claude" # Unix
$env:CCS_CLAUDE_PATH = "D:\Tools\Claude\claude.exe" # Windows
`
Windows symlink support
Enable Developer Mode for true symlinks:
1. Settings → Privacy & Security → For developers
2. Enable Developer Mode
3. Reinstall:
npm install -g @kaitranntt/ccsWithout Developer Mode, CCS falls back to copying directories.
WebSearch
Third-party profiles (Gemini, Codex, GLM, etc.) cannot use Anthropic's native WebSearch. CCS automatically provides web search via CLI tools with automatic fallback.
$3
| Profile Type | WebSearch Method |
|--------------|------------------|
| Claude (native) | Anthropic WebSearch API |
| Third-party profiles | CLI Tool Fallback Chain |
$3
CCS intercepts WebSearch requests and routes them through available CLI tools:
| Priority | Tool | Auth | Install |
|----------|------|------|---------|
| 1st | Gemini CLI | OAuth (free) |
npm install -g @google/gemini-cli |
| 2nd | OpenCode | OAuth (free) | curl -fsSL https://opencode.ai/install \| bash |
| 3rd | Grok CLI | API Key | npm install -g @vibe-kit/grok-cli |$3
Configure via dashboard (Settings page) or
~/.ccs/config.yaml:`yaml
websearch:
enabled: true # Enable/disable (default: true)
gemini:
enabled: true # Use Gemini CLI (default: true)
model: gemini-2.5-flash # Model to use
opencode:
enabled: true # Use OpenCode as fallback
grok:
enabled: false # Requires XAI_API_KEY
`> [!TIP]
> Gemini CLI is recommended - free OAuth authentication with 1000 requests/day. Just run
gemini once to authenticate via browser.See docs/websearch.md for detailed configuration and troubleshooting.
Remote CLIProxy
CCS v7.x supports connecting to remote CLIProxyAPI instances, enabling:
- Team sharing: One CLIProxyAPI server for multiple developers
- Cost optimization: Centralized API key management
- Network isolation: Keep API credentials on a secure server
$3
Configure via dashboard (Settings > CLIProxy Server) or CLI flags:
`bash
ccs gemini --proxy-host 192.168.1.100 --proxy-port 8317
ccs codex --proxy-host proxy.example.com --proxy-protocol https
`$3
| Flag | Description |
|------|-------------|
|
--proxy-host | Remote proxy hostname or IP |
| --proxy-port | Remote proxy port (default: 8317 for HTTP, 443 for HTTPS) |
| --proxy-protocol | http or https (default: http) |
| --proxy-auth-token | Bearer token for authentication |
| --local-proxy | Force local mode, ignore remote config |
| --remote-only | Fail if remote unreachable (no fallback) |See Remote Proxy documentation for detailed setup.
Documentation
| Topic | Link |
|-------|------|
| Installation | docs.ccs.kaitran.ca/getting-started/installation |
| Configuration | docs.ccs.kaitran.ca/getting-started/configuration |
| OAuth Providers | docs.ccs.kaitran.ca/providers/oauth-providers |
| Multi-Account Claude | docs.ccs.kaitran.ca/providers/claude-accounts |
| API Profiles | docs.ccs.kaitran.ca/providers/api-profiles |
| Remote Proxy | docs.ccs.kaitran.ca/features/remote-proxy |
| CLI Reference | docs.ccs.kaitran.ca/reference/cli-commands |
| Architecture | docs.ccs.kaitran.ca/reference/architecture |
| Troubleshooting | docs.ccs.kaitran.ca/reference/troubleshooting |
Uninstall
`bash
npm uninstall -g @kaitranntt/ccs
`
Alternative package managers
`bash
yarn global remove @kaitranntt/ccs
pnpm remove -g @kaitranntt/ccs
bun remove -g @kaitranntt/ccs
``- YAGNI: No features "just in case"
- KISS: Simple, focused implementation
- DRY: One source of truth (config)
See CONTRIBUTING.md.
MIT License - see LICENSE.

---