CC Switch 接入
CC Switch 是第三方多客户端供应商管理工具，可统一管理 Claude Code、Codex、Gemini CLI 等应用。本页演示在 Codex 面板中接入 NaNLab API。
准备工作
- 在 NaNLab API 控制台创建 API Key，并确认 Key 所属分组可调用 Codex 模型。
- 从 CC Switch Releases或官方站点下载安装包。
- 确认 Codex 已安装并至少启动过一次，然后关闭正在运行的 Codex。
第三方工具
CC Switch 不是 OpenAI 或 Sub2API 官方组件。它会管理本机 Codex 配置和认证文件，请只从项目列出的官方渠道下载。
添加 Codex 供应商
打开 CC Switch，切换到 Codex 面板，点击右上角 +，选择“自定义”供应商并填写：
| 项目 | 填写内容 |
|---|---|
| 供应商名称 | NaNLab API |
| API Key | sk-YOUR_NANLAB_API_KEY |
| API 端点 / Base URL | https://sub.nanlabapi.top/v1 |
| API 格式 | Responses |
| 模型 | YOUR_OPENAI_MODEL_ID |
NaNLab 的 Codex 接口原生支持 Responses 协议，不需要开启“本地路由映射”。该开关主要用于只有 Chat Completions 接口的供应商。
如果界面提供“获取模型”按钮，可在填好地址和 Key 后尝试获取；如果实例未开放 /v1/models 或返回格式不兼容，请从 NaNLab 控制台手动复制模型 ID。
启用并验证
- 保存供应商，在供应商卡片上点击“启用”。
- 退出并重新启动 Codex；已经运行的 Codex 不会自动重载配置。
- 新建会话并发送一条简短消息。
- 到 NaNLab 控制台检查请求日志、模型名和用量。
CC Switch 通常会更新 ~/.codex/config.toml 和 ~/.codex/auth.json。如果需要排查，可确认生成的配置等价于：
toml
model_provider = "nanlab"
model = "YOUR_OPENAI_MODEL_ID"
[model_providers.nanlab]
name = "NaNLab API"
base_url = "https://sub.nanlabapi.top/v1"
wire_api = "responses"
requires_openai_auth = true认证文件中的 OPENAI_API_KEY 应为你的 NaNLab API Key。不要在反馈问题时公开该文件内容。
常见问题
401：检查 Key 是否正确；重新启用供应商后重启 Codex。403：检查 Key 分组权限、余额和订阅额度。404：确认地址末尾只有一个/v1，并关闭“本地路由映射”。- 找不到模型：手动填写控制台显示的准确模型 ID。
- 修改未生效：完全退出所有 Codex 进程，再重新打开。
- 想恢复官方登录：在 CC Switch 中启用 OpenAI 官方供应商，不要手工混合两套认证文件。
密钥安全
API Key 会保存在本机配置中。不要把真实 Key 放入截图、日志、Issue 或公开仓库；怀疑泄露时立即轮换。