用 CC Switch 配置 API

添加模型供应商、填写API Key，再把配置交给Claude Code、Codex或Pi。

CC Switch 是一个本地配置管理工具。你可以在窗口里保存不同模型服务，再选择要交给 Agent 使用的配置，少写一些环境变量和配置文件。

先安装你要用的 Agent，再申请模型服务的 API Key。CC Switch 不提供模型额度，也不会替你创建服务商账号。

1. 下载并安装

打开CC Switch 官方发布页，选择适合自己系统的安装包。本文对应 v3.20.3；旧版本界面或预设可能不同，更新前先备份现有客户端配置。

首次启动可以手动导入已有客户端配置，保留为默认供应商。确认新配置能用后再清理旧条目；配置备份也可能含密钥，不要放进公开仓库。

Pi 用户先复制一份 ~/.pi/agent/models.json；Windows 通常在用户文件夹下的 .pi\agent\models.json。如果文件还不存在，可跳过这一步。将副本留在自己的私有目录，恢复前比较新增供应商和模型条目。

打开 CC Switch，选择应用页签。当前版本支持 Claude Code、Codex 和 Pi；DeepSeek Harness 继续使用自己的模型设置页面。

不同页签的同名供应商可能使用不同协议，不要把一份配置复制到所有应用。

先在API 与配置准备好自己的 Key，再回到 CC Switch：

保存后会出现供应商卡片。先核对卡片属于正确的应用，再继续切换。

没有合适预设时，才按服务商的专门教程使用自定义配置。普通 API、Coding Plan 和 Token Plan 的 Key、地址和调用规则可能不同，不能只选相似名字就直接套用。

在 Claude Code 页签找到刚添加的卡片，点击启用。看到“当前启用”后，回到Claude Code 入门做该页的简短验证。

Claude Code 接 DeepSeek 属于供应商适配路线。Anthropic 官方不支持经网关路由到非 Claude 模型；CC Switch 管理配置不会改变这个支持边界。

若之前手动设置过同名环境变量，先退出旧终端，避免旧值继续影响新会话。不要在不知道用途时删除整份配置。

在 Codex 页签重新添加 DeepSeek 预设，再填写 Key、保存并启用。关闭旧 Codex 会话，重新打开终端启动。操作同上

CC Switch 的专门指南说明，从 v3.19.1 起新添加的 DeepSeek 预设使用原生 Responses 直连并读取官方模型目录；该路线要求 Codex 0.144.0 或更新版本。先运行 codex --version 确认。

旧供应商条目不会自动变成新预设。如果卡片仍显示 Needs Routing，先按DeepSeek 专门指南检查旧配置，别同时叠加旧脚本和新预设。

保存后确认模型能被客户端识别，再回到Codex 入门做该页的简短验证。

在 Pi 页签添加 DeepSeek 预设，填写 Key，检查模型列表并保存。确认供应商已加入 Pi 配置；尚未启用时，使用卡片的启用操作。然后回到 Pi，使用 /model 选择新供应商的模型。预设里的旧模型名可能需要按服务商当前目录调整。

CC Switch 只管理 Pi 的 models.json 显式供应商，不写入 auth.json、不代办 OAuth，也不会替 Pi 更改默认模型或接管代理。详细步骤见Pi 入门。

DeepSeek Harness 不在该版本应用列表中。打开它自己的 Web UI，在模型设置中添加 DeepSeek Key，步骤见DeepSeek Harness 入门。

保存并启用后，先回到对应的 Claude Code 入门、Codex 入门、Pi 入门或DeepSeek Harness 入门做该页的简短验证，再按第一项任务完成完整文件任务。还没有 API Key 时，先从API 与配置开始。

如果新服务无法使用，Claude Code 或 Codex 可以先切回保留的旧供应商卡片，再新开会话。手动恢复文件前先比较备份，保留后来添加的 MCP 等设置。

Coding Plan 使用允许的客户端交互方式测试，不默认运行额外的批量测速或脚本调用。不要把完整 Key 放到报错截图中。

资料整理于2026-09-13；界面流程依据官方文档和源码，尚未实际安装或调用模型。