# CCS - Claude Code Switch ![CCS Logo](assets/ccs-logo-medium.png) ### The universal AI profile manager for Claude Code. Run Claude, Gemini, GLM, and any Anthropic-compatible API - concurrently, without conflicts. [![License](https://img.shields.io/badge/license-MIT-C15F3C?style=for-the-badge)](LICENSE) [![npm](https://img.shields.io/npm/v/@kaitranntt/ccs?style=for-the-badge&logo=npm)](https://www.npmjs.com/package/@kaitranntt/ccs) [![PoweredBy](https://img.shields.io/badge/PoweredBy-ClaudeKit-C15F3C?style=for-the-badge)](https://claudekit.cc?ref=HMNKXOHN) **[Features & Pricing](https://ccs.kaitran.ca)** | **[Documentation](https://docs.ccs.kaitran.ca)**

## The Three Pillars | 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 |
## Quick Start ### 1. Install ```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) ```
### 2. Open Dashboard ```bash ccs config # Opens http://localhost:3000 ``` ### 3. Configure Your Accounts 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** ![Analytics](assets/screenshots/analytics.webp) **Live Auth Monitor** ![Live Auth Monitor](assets/screenshots/live-auth-monitor.webp) **CLI Proxy API & Copilot Integration** ![CLIProxy API](assets/screenshots/cliproxyapi.webp) ![Copilot API](assets/screenshots/copilot-api.webp) **WebSearch Fallback** ![WebSearch](assets/screenshots/websearch.webp)
## Built-in Providers | Provider | Auth Type | Command | Best For | |----------|-----------|---------|----------| | **Claude** | Subscription | `ccs` | Default, strategic planning | | **Gemini** | OAuth | `ccs gemini` | Zero-config, fast iteration | | **Codex** | OAuth | `ccs codex` | Code generation | | **Copilot** | OAuth | `ccs copilot` | GitHub Copilot models | | **Antigravity** | OAuth | `ccs agy` | Alternative routing | | **GLM** | API Key | `ccs glm` | Cost-optimized execution | | **Kimi** | API Key | `ccs kimi` | Long-context, thinking mode | > **OAuth providers** authenticate via browser on first run. Tokens are cached in `~/.ccs/cliproxy/auth/`. **Powered by:** - [CLIProxyAPI](https://github.com/router-for-me/CLIProxyAPI) - OAuth proxy for Gemini, Codex, Antigravity - [copilot-api](https://github.com/ericc-ch/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](https://docs.ccs.kaitran.ca/providers/api-profiles).
## Usage ### Basic Commands ```bash ccs # Default Claude session ccs agy # Antigravity (OAuth) ccs gemini # Gemini (OAuth) ccs glm # GLM (API key) ``` ### Parallel Workflows Run multiple terminals with different providers: ```bash # Terminal 1: Planning (Claude Pro) ccs work "design the authentication system" # Terminal 2: Execution (GLM - cost optimized) ccs glm "implement the user service from the plan" # Terminal 3: Review (Gemini) ccs gemini "review the implementation for security issues" ``` ### Multi-Account Claude Create isolated Claude instances for work/personal separation: ```bash ccs auth create work # Run concurrently in separate terminals ccs work "implement feature" # Terminal 1 ccs "review code" # Terminal 2 (personal account) ```
## Maintenance ### Health Check ```bash ccs doctor ``` Verifies: Claude CLI, config files, symlinks, permissions. ### Update ```bash ccs update # Update to latest ccs update --force # Force reinstall ccs update --beta # Install dev channel ``` ### Sync Shared Items ```bash ccs sync ``` Re-creates symlinks for shared commands, skills, and settings.
## 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/ccs` Without 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. ### How It Works | Profile Type | WebSearch Method | |--------------|------------------| | Claude (native) | Anthropic WebSearch API | | Third-party profiles | CLI Tool Fallback Chain | ### CLI Tool Fallback Chain 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` | ### Configuration 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](./docs/websearch.md) for detailed configuration and troubleshooting.
## Documentation | Topic | Link | |-------|------| | Installation | [docs.ccs.kaitran.ca/getting-started/installation](https://docs.ccs.kaitran.ca/getting-started/installation) | | Configuration | [docs.ccs.kaitran.ca/getting-started/configuration](https://docs.ccs.kaitran.ca/getting-started/configuration) | | OAuth Providers | [docs.ccs.kaitran.ca/providers/oauth-providers](https://docs.ccs.kaitran.ca/providers/oauth-providers) | | Multi-Account Claude | [docs.ccs.kaitran.ca/providers/claude-accounts](https://docs.ccs.kaitran.ca/providers/claude-accounts) | | API Profiles | [docs.ccs.kaitran.ca/providers/api-profiles](https://docs.ccs.kaitran.ca/providers/api-profiles) | | Remote Proxy | [docs.ccs.kaitran.ca/features/remote-proxy](https://docs.ccs.kaitran.ca/features/remote-proxy) | | CLI Reference | [docs.ccs.kaitran.ca/reference/cli-commands](https://docs.ccs.kaitran.ca/reference/cli-commands) | | Architecture | [docs.ccs.kaitran.ca/reference/architecture](https://docs.ccs.kaitran.ca/reference/architecture) | | Troubleshooting | [docs.ccs.kaitran.ca/reference/troubleshooting](https://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 ```

## Philosophy - **YAGNI**: No features "just in case" - **KISS**: Simple, focused implementation - **DRY**: One source of truth (config)
## Contributing See [CONTRIBUTING.md](./CONTRIBUTING.md).
## License MIT License - see [LICENSE](LICENSE).
## Star History [![Star History Chart](https://api.star-history.com/svg?repos=kaitranntt/ccs&type=date&legend=top-left)](https://www.star-history.com/#kaitranntt/ccs&type=date&legend=top-left) --- **[ccs.kaitran.ca](https://ccs.kaitran.ca)** | [Report Issues](https://github.com/kaitranntt/ccs/issues) | [Star on GitHub](https://github.com/kaitranntt/ccs)