# 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 (Light/Dark Theme)** ![Analytics Light](assets/screenshots/analytics-light.png) ![Analytics Dark](assets/screenshots/analytics.png) **API Profiles & OAuth Providers** ![API Profiles](assets/screenshots/api_profiles.png) ![CLIProxy](assets/screenshots/cliproxy.png)
## 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 | | **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/`. > [!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 configures MCP-based web search as a fallback. ### How It Works | Profile Type | WebSearch Method | |--------------|------------------| | Claude (native) | Anthropic WebSearch API | | OAuth providers | MCP web-search-prime (auto-configured) | | API profiles | MCP web-search-prime (auto-configured) | ### Configuration Configure via dashboard (**Settings** page) or `~/.ccs/config.yaml`: ```yaml websearch: enabled: true # Enable/disable auto-config provider: auto # auto | web-search-prime | brave | tavily fallback: true # Enable fallback chain ``` ### Optional API Keys For additional search providers, set environment variables: ```bash export BRAVE_API_KEY="your-key" # Free tier: 15k queries/month export TAVILY_API_KEY="your-key" # AI-optimized search (paid) ``` > [!NOTE] > `web-search-prime` works without API keys. Brave/Tavily are optional fallbacks. 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) | | 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).
--- **[ccs.kaitran.ca](https://ccs.kaitran.ca)** | [Report Issues](https://github.com/kaitranntt/ccs/issues) | [Star on GitHub](https://github.com/kaitranntt/ccs)