目录

步骤 1：添加服务提供商

步骤二：更换服务提供商

步骤 3：激活

验证配置

自定义配置（Codex）

CC Switch 是一款跨平台桌面应用程序，专为使用 AI 编码工具的开发人员而设计。它可以帮助您集中管理五种主要 AI 编码工具的配置：Claude Code、Codex、Gemini CLI、OpenCode和OpenClaw。

1. 点击主界面右上角的“+”按钮。
2. 从“预设”下拉菜单中选择您的提供商
   • 常用预设：Zhipu GLM、MiniMax、DeepSeek、Kimi、PackyCode
   • 或者选择“自定义”进行手动配置
3. 请输入您的API 密钥
4. 点击“添加”

提示：预设会自动填充端点 URL，因此您只需输入 API 密钥即可。

添加后，提供商会出现在列表中。

选项 1：从主界面切换

• 点击提供商卡上的“启用”按钮。

选项 2：通过系统托盘快速切换

• 右键单击系统托盘中的 CC Switch 图标
• 直接点击提供商名称

切换服务提供商后，每个 CLI 工具的激活方式都不同：

如果 Claude Code 在首次启动时提示您登录或显示引导向导，请在 CC Switch 中启用“跳过 Claude Code 首次运行确认”选项：

1. 打开 CC 开关“设置 > 常规”
2. 启用“跳过 Claude Code 首次运行确认”开关
3. 重启Claude Code
    

注意：此选项会将该skipIntroduction字段写入目标位置~/.claude/settings.json，跳过正式的注册流程。

重启后，启动相应的命令行工具，并输入一个简单的问题进行测试：

# Claude Code - enter a test question after launching
claude
> Hello, please briefly introduce yourself

# Codex - enter a test question after launching
codex
> Hello, please briefly introduce yourself

# Gemini - enter a test question after launching
gemini
> Hello, please briefly introduce yourself

如果人工智能做出正常反应，则配置成功。

自定义配置（Codex）

Codex 使用两个配置文件：

1. auth.json ( ~/.codex/auth.json) - 存储 API 密钥：

{
  "OPENAI_API_KEY": "your-api-key"
}

2. config.toml ( ~/.codex/config.toml) - 存储模型和端点配置：

# Basic configuration
model_provider = "custom"
model = "gpt-5.2"
model_reasoning_effort = "high"
disable_response_storage = true

# Custom provider configuration
[model_providers.custom]
name = "custom"
base_url = "https://api.example.com/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json 字段描述：

config.toml 字段描述：