CCS CLI
CCS - Claude Codex Switch
A CLI that switches Claude Code between accounts, providers and local models without editing configs
- 2,892 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Stores OAuth tokens and API keys for several providers
- Proxies all agent traffic through a local server
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/ccs-claude-codex-switchDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Stores OAuth tokens and API keys for several providers
- Proxies all agent traffic through a local server
This is third-party code. Review the repository files before installing.
What it does
CCS stores profiles and launches the right runtime with one command: ccs for Claude, ccs codex, ccs glm, ccs ollama and more. It keeps several Claude subscriptions in isolated contexts, connects OAuth providers through the bundled CLIProxy and API-key profiles such as OpenRouter or GLM. A local Anthropic-compatible proxy lets Claude Code talk to OpenAI-style providers. A web dashboard manages profiles, and it can run in Docker.
Who it is for. For developers who use Claude Code with several accounts or want to plug other models into it.
Good fit when
- You need to switch between work and personal Claude accounts without breaking sessions
- You want to run Claude Code on GLM, Kimi, OpenRouter or a local model
- You need to swap providers per task quickly
Not a fit when
- One account and one model are enough
- Company policy forbids a proxy between the agent and the provider
Example request
Set up a CCS profile for GLM and launch Claude Code with itLimitations
Requires Node.js or Docker. Cloud providers need their own accounts and keys; the Anthropic and OpenAI APIs are unreachable from Russia without a VPN, while local models via Ollama work offline. Using multiple subscriptions and OAuth proxying may conflict with provider terms. Qwen Code account linking is not supported yet.
How to disable. Remove the package with npm uninstall -g @kaitranntt/ccs or stop the containers with docker compose down.
FAQ
How does CCS differ from claude-code-router?
Per the README, claude-code-router is a standalone router, while CCS adds profile management and a single ccs command on top of similar routing.
Can it run in Docker?
Yes, the README provides docker-compose; the dashboard is on port 3000 and CLIProxy on 8317.
How is CCS different from claude-code-router?
CCS stores profiles and launches the needed runtime with one command: ccs for Claude, ccs codex, ccs glm, ccs ollama. It keeps several Claude subscriptions in isolated contexts and connects OAuth accounts and local models without editing configs.
How do I install CCS for Claude Code?
Run npm install -g @kaitranntt/ccs and ccs config. Then launch the profile you need: ccs for Claude, ccs codex, ccs glm or ccs ollama. Risk is high because the tool works with your accounts and tokens.
Discussion
No questions or reviews yet.
Related
CLI toolsA desktop app to switch providers and manage MCP servers, prompts and skills for Claude Code, Codex, Gemini CLI and other agents
A local gateway for Claude Code, Codex, OpenCode and other agents: pick model providers, route requests, set fallbacks and read logs
A CLI that plugs third-party models into Claude Code orchestration: workflows, agent teams and subagents on DeepSeek, GLM, Kimi, Qwen or a Codex subscription
Multi-agent orchestration for Claude Code: teams, roles, autopilot and task routing across skills and subagents
An environment for Claude Code that keeps context across sessions via hooks, ledgers and handoffs, orchestrates agents and saves tokens
One runtime for Claude Code, Codex, OpenCode and more: a run counts as done only when checks the agent did not write pass
README in short
The README opens with a Docker Compose quick start and npm install. It explains what CCS switches between: Claude Code, Droid and Codex runtimes, Claude subscriptions, OAuth providers and API-key profiles. A section covers routing to OpenAI-compatible providers through a local proxy and compares it with claude-code-router. Docs are at docs.ccs.kaitran.ca. MIT licensed.