CC Switch 配置教程：导入与切换国产模型
选择客户端和接口
CC Switch（也常写作 CCSwitch）用于管理客户端的供应商配置。先确认你要配置的是 Codex、Claude Code 还是使用 Chat Completions 的工具。三种请求格式不能互相替代。
- 登录本站，在 API 密钥页创建或选择对应接口分组的 Key。
- 优先使用密钥页的 CC Switch 导入入口，确认目标客户端、服务地址与模型后保存。
- 如果浏览器没有唤起应用，检查 CC Switch 是否安装并允许打开外部协议；也可以按下表手动配置。
- 在客户端新建会话，先发送简短问题，再检查站内使用记录和费用。
手动配置参考
| 协议 | 完整端点 | 常见用途 |
|---|---|---|
| Chat Completions | /v1/chat/completions | OpenAI 兼容聊天工具与 SDK |
| Messages | /v1/messages | Claude Code 等 Messages 客户端 |
| Responses | /v1/responses | Codex 等 Responses 客户端 |
Base URL 通常填写 https://tiantianapi.kdns.fr/v1；如果客户端会自动追加 /v1，则填写站点根地址。最终请求应与表中完整端点一致，避免出现重复路径。
切换模型与用量查询
选择该分组公开目录中的模型 ID。切换模型后新建会话，有助于避免旧会话携带不兼容参数。用量查询与客户端版本、供应商配置有关；导入后检查对应开关，本站使用记录是费用核对依据。
常见问题
401：检查 Key 是否完整且有效。404：检查地址是否重复拼接、模型是否可用。429：减少并发并退避重试。不要在公开截图或配置仓库中展示真实 Key。
接入参数参考
以上为通用接入参数，不是 CC Switch 导入文件；应用一键导入请使用本站 API 密钥页。