CC Switch == 配置指南

目录

[步骤 1：添加服务提供商](#步骤 1：添加服务提供商)

步骤二：更换服务提供商

[步骤 3：激活](#步骤 3：激活)

验证配置

自定义配置（Codex）

---

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

• 繁琐的多提供商切换：使用不同的 API 提供商（官方、代理服务）需要手动编辑配置文件
• 配置分散：Claude、Codex、Gemini、OpenCode 和 OpenClaw 各自拥有格式不同的独立配置文件。
• 缺乏使用情况监控：无法查看 API 调用次数或调用费用。
• 服务不稳定：当单个服务提供商出现故障时，您的整个工作流程都会中断。

CC Switch 通过统一的界面解决了这些问题。

Application	Description
Claude Code	Anthropic's official AI coding assistant
Codex	OpenAI's code generation tool
Gemini CLI	Google's AI command-line tool
OpenCode	Open-source AI coding terminal tool
OpenClaw	Open-source AI coding assistant (multi-provider gateway)

步骤 1：添加服务提供商

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

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

步骤二：更换服务提供商

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

选项 1：从主界面切换

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

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

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

步骤 3：激活

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

应用	激活方法
Claude Code	即时生效（支持热重载）
Codex	需要关闭并重新打开终端。
Gemini	立即生效（每次请求时重新读取配置）

Claude Code 代码首次启动提示

如果 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 字段描述：

Field	必需的	描述
OPENAI_API_KEY	是的	API密钥

config.toml 字段描述：

Field	必需的	描述
model_provider	是的	模型提供商名称（必须匹配[model_providers.xxx]）
model	是的	使用的模型（例如gpt-5.2，，gpt-4o）
model_reasoning_effort	不	推理努力：low/ medium/high
disable_response_storage	不	是否禁用响应存储
base_url	是的	API 端点 URL
wire_api	不	API 协议类型（通常responses）
requires_openai_auth	不	是否使用 OpenAI 身份验证