Appearance
Codex 配合 CC Switch 接入应天AI
本教程介绍如何使用 Codex + CC Switch 接入应天AI的中转服务。Codex 用于执行对话和编程任务，CC Switch 用于保存、导入和切换 Codex 的 Provider 配置；应天AI负责提供兼容的模型服务。
完成后，你可以在 Codex 中使用应天AI模型，并通过 CC Switch 在不同服务配置之间切换，而不需要反复手动修改本地配置文件。
Codex、CC Switch 的菜单名称可能会随版本变化。若界面与截图略有差异，请优先寻找“设置”“Provider”“导入配置”或“自定义服务”等相近入口。
网络提示： Codex 客户端运行时需要访问 Codex 相关服务。使用前请确保当前网络环境能够正常访问所需服务；如果所在网络无法直接连接，需先准备可用的网络代理或其他合规的网络访问方式。CC Switch 只负责管理和切换 Provider，不会替代网络连接能力。
一、开始前准备
请先准备以下内容：
| 项目 | 说明 |
|---|---|
| 应天AI账号 | 用于登录控制台并创建 API Token |
| 应天AI API Token | 建议为 Codex 单独创建，便于后续停用和追踪用量 |
| 可用模型名称 | 从应天AI模型广场复制，必须与平台显示完全一致 |
| Codex | 已安装并能正常启动的 Codex 客户端 |
| CC Switch | 已安装并能打开主界面的 CC Switch，尚未安装请先阅读 CC Switch 安装教程 |
可以从以下入口获取平台信息：
二、先创建专用 API Token
- 登录应天AI控制台。
- 打开 API 密钥 页面。
- 创建一枚专门用于 Codex 的 Token，例如命名为
codex。 - 根据需要设置模型权限、额度、有效期或 IP 限制。
- 创建完成后立即复制 Token，并妥善保存。
不要把真实 Token 放入截图、聊天记录、公开文档或代码仓库。如果 Token 已经泄露，请先删除旧 Token，再重新创建。
三、从控制台打开 CC Switch 配置窗口
如果应天AI控制台的令牌操作菜单中提供 CC Switch 快捷入口，可以直接使用导入流程：
- 在令牌列表中找到刚创建的 Codex Token。
- 打开该 Token 的操作菜单。
- 选择 CC Switch。
- 浏览器或系统可能会弹出确认窗口，询问是否允许打开 CC Switch。
- 选择允许打开，进入配置弹窗。
如果点击后没有反应，请确认 CC Switch 已安装，并检查系统是否已将
ccswitch://链接交给 CC Switch 处理。也可以先手动打开 CC Switch，再回到控制台重试。
四、在弹窗中生成 Codex 配置
在 CC Switch 配置弹窗中，按以下方式填写：
- 将目标应用切换为 Codex。
- 为配置填写便于识别的名称，例如
应天AI Codex。 - 选择应天AI模型广场中实际可用的模型。
- 确认配置中的 API Token 对应当前创建的 Codex Token。
- 点击导入或打开 CC Switch，继续完成配置。
模型名称不要凭印象填写。请直接从模型广场复制准确名称，避免大小写、连接符或空格不一致。
五、在 CC Switch 中检查配置
完成导入后，打开 CC Switch 主界面：
- 找到顶部或侧边的 Codex 分类。
- 查看刚刚导入的 Provider 名称。
- 打开该 Provider 的配置详情，核对服务地址、Token 和模型。
- 确认没有误选其他应用的配置。
配置内容通常应对应以下信息：
| 配置项 | 应填写的内容 |
|---|---|
| 应用 | Codex |
| 服务地址 | 应天AI提供的 Codex 兼容接口地址 |
| API Token | 刚创建的 Codex 专用 Token |
| 模型 | 应天AI模型广场中的准确模型名称 |
不同版本的 CC Switch 可能以 Provider、服务商或配置方案称呼同一类对象，字段名称以当前版本界面为准。
六、启用 Provider
在 Codex 配置列表中，选择刚导入的应天AI Provider，并执行启用或切换操作。
启用后，请确认界面显示“已启用”“使用中”或同等状态。CC Switch 的作用是写入或切换 Codex 使用的配置；配置成功后通常不需要让 CC Switch 一直保持在前台运行。
如果 Codex 已经在运行，建议在切换 Provider 后完全退出并重新打开 Codex，让新的配置被重新加载。
七、启动 Codex 并完成验证
- 启动或重启 Codex。
- 新建一个对话或任务。
- 确认当前使用的是刚才导入的 Provider 或对应模型。
- 发送一条简单测试消息：
text
请只回复：应天AI Codex 接入成功
出现正常回复后，再尝试执行简单的代码阅读或文件修改任务。首次验证不建议直接运行复杂任务，以便快速区分配置、权限和项目本身的问题。
八、在控制台确认请求记录
Codex 返回结果后，登录应天AI控制台，打开使用日志或数据看板，检查：
- 请求时间是否与测试时间一致
- 实际调用的模型是否正确
- 请求状态是否成功
- Token 消耗和额度变化是否正常
Codex 能返回内容且控制台能找到对应记录，才表示请求已经通过中转服务完成。
常见问题
CC Switch 没有被唤起
请检查 CC Switch 是否已经安装并能正常启动；然后重新点击控制台中的 CC Switch 入口。如果系统询问是否允许打开外部应用，请选择允许。
导入后 Codex 仍使用旧配置
先在 CC Switch 中确认应天AI Provider 已经处于启用状态，再完全退出并重启 Codex。若同时存在多个 Provider，请确认当前启用的是目标配置。
返回 401 或 Token 无效
检查 Token 是否完整、是否包含前后空格、是否已经过期或被删除。还要确认使用的是 API Token，而不是应天AI官网登录密码。
返回 403 或无权限
检查当前 Token 是否允许访问所选模型、是否配置了 IP 白名单，以及账号余额或 Token 配额是否充足。
返回 404 或接口地址错误
检查 CC Switch 中的服务地址是否使用应天AI提供的 Codex 兼容地址。不要把控制台网页地址当作 API 地址，也不要在客户端自动拼接路径的情况下重复填写路径。
Codex 没有返回内容，但控制台没有日志
这通常表示请求尚未到达应天AI。优先检查 Provider 是否真的启用、Codex 是否已经重启，以及本机网络、代理和服务地址是否正常。
模型不存在
重新打开模型广场，复制当前可用模型的完整名称，并确认 Token 对该模型具有访问权限。
安全建议
- 为 Codex 单独创建 API Token，不要与其他客户端共用。
- 不要在公开截图或配置文件中展示完整 Token。
- 不要把 Token 提交到 Git 仓库。
- 不再使用某个 Provider 时及时停用或删除对应 Token。
- 定期查看使用日志，发现异常消耗时立即停用 Token。
下一步
如果还没有安装 CC Switch，请先阅读 CC Switch 安装教程，完成安装和首次启动后再返回本页。
完成 Codex 接入后，可以继续阅读：