CCS is a TypeScript-based CLI/dashboard that manages multiple AI runtimes and profiles (Claude, Codex, Droid, GLM, OpenRouter, etc.) via a centralized CLIProxy API-based proxy and visual dashboard. It supports multi-account switching, OAuth providers, and local model profiles with a focus on reducing config churn.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
CCS - Claude Code Switch is described as a multi-provider profile and runtime manager for Claude Code and compatible CLIs. It enables running Claude Code, Factory Droid, Codex CLI, and other runtimes, supporting multiple Claude subscriptions and isolated account contexts, with OAuth providers and Copilot compatibility. It also covers API and local-model profiles like GLM, Kimi, OpenRouter, Ollama, llama.cpp, and others. The project emphasizes avoiding config thrash and moving between providers quickly.
How it works
The repository offers a single command surface (ccs) to switch between providers and profiles, leveraging an embedded proxy (CLIProxyAPI) with optional Plus/maintained forks for provider routing. It includes an OpenAI-compatible routing layer via a local Anthropic-compatible proxy, enabling provider routing and explicit activation helpers. It also provides a dashboard for usage analytics, live auth monitoring, and an OAuth/provider control center. Specific concepts mentioned include: multiple runtimes, multiple subscriptions, OAuth providers, API/local-model profiles, and a local proxy with routing capabilities.
Getting started
Install on host (npm):
npm install -g @kaitranntt/ccs
ccs config
Then launch runtimes, for example:
ccs
ccs codex
ccs xai # Alias: ccs grok
ccs --target droid glm
ccs glm
ccs ollama
The README also includes a Docker quick start and a note about a deprecated CLI image:
curl -fsSL https://ccs.kaitran.ca/docker-compose.yaml -o docker-compose.yaml
docker compose up -d
Dashboard is available at http://localhost:3000 and CLIProxy at http://localhost:8317.
Recent releases
Latest releases include v8.8.1-dev.16 (2026-08-03) with changes related to diverged settings, filesystem inventory hardening, and shared-manager improvements. Prior release v8.8.1-dev.15 (2026-07-31) included ai-review-luna-xhigh, explicit reasoning effort for reviews, and other CI-related updates. Earlier updates include v8.8.1-dev.9 (2026-07-29) with fixes for concurrent account locks and proxy resilience, and v8.8.1-dev.8 (2026-07-29) adding Brazilian Portuguese locale support. The releases section lists several intermediate fixes and feature additions.
Traction
Stars: 2779; Forks: 252; Open issues: 31. Created in 2025-11-01; last push 2026-08-03. Language: TypeScript; License: MIT.
Behind the repo
Related project note: claude-code-router mentioned as a related project for routing Claude Code requests to OpenAI-compatible providers. CCS integrates with CLIProxyAPI/Plus and references a dashboard and proxy control surfaces.
Caveats
License: MIT. Open issues: 31. Created: 2025-11-01. Last push: 2026-08-03. Docker image usage notes indicate deprecation of the CLI dashboard image in favor of the main CCS image and migration guidance in the repo and docker/README.md. Privacy/security considerations are implied by hardening and proxy components but no explicit details are provided in the README excerpt.