ccs
Switch between Claude accounts, Gemini, Copilot, OpenRouter (300+ models) via CLIProxyAPI OAuth proxy. Visual dashboard, remote proxy support, WebSearch fallback. Zero-config to production-ready.
CCS (Claude Codex Switch) is a multi-provider profile and runtime manager for Claude Code and compatible command-line interfaces. It enables developers to seamlessly switch between multiple Claude accounts, Gemini, GitHub Copilot, OpenRouter's 300+ models, and local providers like Ollama without config file rewrites. The tool includes a visual dashboard, OAuth proxy support via CLIProxyAPI, WebSearch fallback capabilities, and a macOS menu bar companion for quota monitoring. CCS bridges Claude Code to OpenAI-compatible providers through a local Anthropic-compatible proxy and supports both zero-config Docker deployment and npm host installation.
Key Features
Use Cases
- 01Switch between Claude Pro and Team accounts without breaking active coding sessions
- 02Route design work to Claude and implementation tasks to cheaper API providers like GLM or OpenRouter
- 03Use local Ollama models for privacy-sensitive code review or offline development work
- 04Monitor usage and costs across multiple AI subscriptions from a unified analytics dashboard
- 05Bridge Claude Code to OpenAI-compatible providers like Hugging Face or Fireworks AI
- 06Track live authentication state and provider health without editing raw config files
Related Plugins
View moreandrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
claude-mem
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Understand-Anything
Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
rtk
CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies
ccs — FAQ
What is CCS and what does it do?+
CCS (Claude Codex Switch) is a profile and runtime manager that lets you switch between multiple Claude accounts, AI providers (Gemini, Copilot, OpenRouter, xAI), and local models through a unified CLI. It eliminates config file thrashing and provides a visual dashboard for monitoring usage, costs, and authentication status.
How do I install CCS?+
Install globally via npm with 'npm install -g @kaitranntt/ccs' then run 'ccs config' to initialize, or use Docker by downloading the compose file and running 'docker compose up -d'. The Docker deployment provides a dashboard at http://localhost:3000.
Which AI clients work with CCS?+
CCS works with Claude Code, Codex CLI, Factory Droid, and other Anthropic-compatible command-line interfaces. It can also bridge Claude Code to OpenAI-compatible providers through its local proxy.
Do I need API keys or accounts to use CCS?+
You need credentials for whichever providers you want to use—Claude accounts for Claude profiles, API keys for providers like GLM, OpenRouter, or Kimi, and local model installations for Ollama or llama.cpp. CCS manages OAuth flows for supported providers like Codex and xAI.
Is CCS free to use?+
CCS itself is open source and free under the MIT license. However, you still pay for the underlying AI services—Claude subscriptions, API usage fees for OpenRouter or other providers, etc.
How do I switch between different AI providers?+
Use commands like 'ccs' for default Claude, 'ccs codex' for Codex CLI, 'ccs glm' for GLM API, or 'ccs ollama' for local Ollama models. CCS provides runtime aliases like 'ccs xai' (also 'ccs grok') for quick switching without config edits.
How do I install ccs?+
Open the source repository on GitHub and follow its README. ccs is a plugin — MCP Agents Market links you directly to the official repo.
Is ccs free?+
ccs is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.