Config manager Windows, macOS, Linux

CC Switch for Claude Code and Codex configs

CC Switch is useful when you switch between official accounts, API proxy providers, local models, and multiple AI coding CLIs. Use it after you have already tested a working Base URL and API key manually.

Download from GitHub
cc switch ccswitch claude code config manager codex config manager

Install and Download

Download the latest Windows, macOS, or Linux build from GitHub Releases. On macOS, the README also documents Homebrew installation:

brew install --cask cc-switch

After adding or switching a provider, restart the terminal or target CLI so Claude Code, Codex, Gemini CLI, OpenCode, or OpenClaw reads the new configuration. For Linux, choose the release asset that matches your distribution, such as .deb, .rpm, or AppImage.

Key Features

The project README describes CC Switch as a cross-platform desktop manager for Claude Code, Codex, Gemini CLI, OpenCode, and OpenClaw.

Core functions include provider management, one-click switching, more than 50 provider presets, import/export, system tray quick switching, and universal provider sync for some apps.

It also covers MCP, prompts, skills, usage and cost tracking, session browsing, cloud sync, local proxy mode, failover, and automatic backups.

Proxy Setup Checks

Before adding a proxy provider, confirm the Base URL, API key, and model name work in the target CLI without CC Switch.

Check whether the provider expects OpenAI-compatible chat, Anthropic-compatible calls, or a tool-specific format before switching a coding CLI profile.

If a switch does not take effect, restart the terminal or CLI first. The CC Switch README notes that most tools need a restart after provider changes.

When It Is Useful

  • You use Claude Code, Codex, Gemini CLI, OpenCode, or similar tools at the same time.
  • You often switch between official APIs, OpenAI-compatible proxy providers, and local model endpoints.
  • You want to avoid manually editing shell profiles, settings files, and config.toml for every provider change.
  • You already tested one working provider setup and now need safer switching and organization.

Sources

Related tools

API Relay Check: API relay checker for fake models and model swapping A practical API relay verification entry point for checking model swapping, fake model identity, hidden injection, token usage anomalies, TTFT, SSE streaming, and Claude Code / Codex setup risk. Codex++ tweak system for the Codex desktop app An unofficial Codex desktop tweak system that injects a loader, installs a runtime outside the app bundle, adds a Tweaks settings tab, and manages tweak modules.

Related guides

Use CC Switch to manage Claude Code and Codex proxy configs Use CC Switch to manage API proxy providers, Base URLs, API keys, config switching, and sync for Claude Code, Codex, and other AI coding CLIs. Quickstart: connect Claude Code, Codex, or Cursor to an AI API proxy Before connecting Claude Code, Codex, or Cursor to an AI API proxy, confirm the tool, protocol compatibility, Base URL, API key, and model name. Codex OpenAI-compatible proxy Base URL setup guide Install the OpenAI Codex CLI and configure API keys, Base URL, config.toml, and provider switching for an OpenAI-compatible proxy.

Related topics

OpenAI API Proxy Providers Compare OpenAI API proxy and OpenAI-compatible providers by Base URL support, models, pricing, payment methods, and public verification signals. Claude API Proxy Providers Compare Claude API proxy and Anthropic-compatible providers by models, Base URL setup, pricing notes, payment methods, and verification signals. AI API Directory Browse an AI API directory of OpenAI-compatible, Claude-compatible, and multi-model proxy providers with pricing, payment, model, and verification fields.

FAQ

Common questions

Does CC Switch make an API proxy compatible with Codex or Claude Code?

No. CC Switch manages configuration. The provider still needs to support the protocol, model name, streaming behavior, and Base URL format required by the target tool.

Should I use CC Switch before testing a provider manually?

It is safer to test a minimal setup first. Confirm the Base URL, API key, and model name work in the target CLI, then add that working setup to CC Switch.