01 · 模型与运行框架

模型负责内容生成；文件访问、命令执行与工具调用由运行框架提供。

harness 是模型的运行框架，负责工具调度与执行，将模型输出接入文件、终端和外部工具。

02 · CC Switch 解决什么问题

CC Switch 提供图形化配置界面，用于管理供应商参数、API Key 与模型配置。切换前应核对目标工具支持的接口和模型。

03 · 下载 CC Switch

官网    https://www.ccswitch.io/zh/download
GitHub  https://github.com/farion1231/cc-switch

04 · 创建 API Key（以 DeepSeek 为例）

打开platform.deepseek.com→ 左侧点API keys→ 创建 API key → 填写名称 → 复制密钥。

提示

API Key 仅在创建时完整显示一次，请及时保存至密码管理器。

提示

调用前检查账户余额与服务状态，避免将账户问题误判为配置错误。

提示

API Key 属于访问凭据。不要写入代码、提交至 Git 或通过公开渠道分享。

05 · 安装 Codex

从官方渠道安装 Codex。

首次启动后检查默认配置是否生成，再退出应用和托盘进程，避免配置修改与运行中的应用冲突。

06 · 在 CC Switch 里配置

1. 打开 CC Switch，在首页选 Codex 的图标
2. 点右上角 + 号，进入配置界面
3. 供应商选 DeepSeek
4. 把第 04 步存好的 API Key 填进去
5. 往下拉，点「获取模型列表」，在下拉框里选一个模型
6. 点保存
7. 回到主界面，激活刚才创建的这条配置

07 · 连接验证

启动 Codex 后发送测试请求，确认模型响应与工具连接正常。