主题
CC Switch 配置 Codex
这篇教程用 Windows 截图演示。不同版本的 CC Switch 界面可能略有变化，但主要按钮和流程基本一致。
Codex 是什么
Codex 是一个在命令行里使用的 AI 编程工具。 你可以在项目目录里运行 codex，让它帮你读代码、解释报错、修改文件、执行命令和完成工程任务。
CC Switch 的作用是帮 Codex 管理 API 地址、API Key 和模型配置。配置完成后，你在 PowerShell 里运行 codex，就可以通过爱次元 API 使用 Codex。
开始前准备
你需要先准备好：
- 已安装并能打开的 CC Switch
- 已安装并能运行的 Codex
- 一个可用的爱次元 API Key
如果还没有安装 CC Switch，先看：CC Switch 安装教程。 如果还没有 API Key，先看：API 密钥。 如果还没有安装 Codex，请先完成 Codex 的本地安装。
需要填写什么
先记住这几项，后面按截图填写即可：
| 配置项 | 填写内容 |
|---|---|
| 供应商类型 | 统一供应商 |
| 预设类型 | NewAPI |
| 名称 | 爱次元AI |
| API 地址 | 以 API 地址 文档为准 |
| API Key | 你的爱次元 API Key |
| 官网地址 | https://acy7.com |
| Codex 模型 | gpt-5.5 |
| Reasoning Effort | high |
注意
API Key 是你的私密凭证，不要发给别人，也不要提交到代码仓库。
1. 打开新增供应商
打开 CC Switch，点击右上角的 + 新增供应商。
进入添加页面后，选择 统一供应商，再点击右下角 添加统一供应商。
2. 填写供应商信息
预设类型选择 NewAPI，然后填写：
- 名称：
爱次元AI - API 地址：打开 API 地址，复制当前推荐地址
- API Key：粘贴你的爱次元 API Key
- 官网地址：
https://acy7.com - 备注：可以继续写
爱次元AI
截图里的 API 地址只是示例。实际填写时，请以 API 地址 文档里的最新说明为准。
API Key 可以在爱次元后台的 API 密钥 页面复制。 点击密钥右侧的复制按钮即可，不建议手动输入。
回到 CC Switch，把复制好的 Key 粘贴到 API Key 输入框。
3. 填写 Codex 模型
往下找到 模型配置。 在 Codex 区域里填写：
| 配置项 | 填写内容 |
|---|---|
| 模型 | gpt-5.5 |
| Reasoning Effort | high |
如果页面里还有 Claude、Gemini 等区域，不用时可以先保持默认；如果系统要求填写，也可以先同样填 gpt-5.5。
填完后点击右下角 添加。
4. 同步配置到 Codex
添加完成后，会回到统一供应商列表。 能看到 爱次元AI，说明供应商已经创建成功。
接着点击卡片上的 同步 图标。
弹出确认窗口后，点击 同步。
回到 CC Switch 首页，确认上方选中的是 Codex。 看到绿色提示，例如 爱次元AI 运行正常，说明 CC Switch 已经能正常连接。
5. 打开 Codex 测试
打开 PowerShell，先进入你的项目目录，再运行：
powershell
cd "E:\AI-DOC"
codex这里的 E:\AI-DOC 只是截图示例。你应该换成自己的项目目录。
第一次在某个项目目录运行 Codex 时，可能会提示是否信任当前目录。 如果这是你自己的项目，选择：
text
1. Yes, continue然后按回车继续。
进入 Codex 后，可以发送一句测试：
text
你是什么模型？如果能正常回复，并且界面里能看到 gpt-5.5 high，就说明 Codex 已经通过 CC Switch 使用爱次元配置。
常见问题
API 地址要不要加 /v1？
按 API 地址 文档说明填写。 如果文档说明当前工具需要 /v1，就按文档要求添加；如果不需要，就不要额外添加。
提示找不到 codex 命令怎么办？
先确认 Codex 已经安装。 如果刚安装完，关闭 PowerShell 后重新打开，再执行：
powershell
codex --version还是不行的话，先检查 Codex 是否已经正确安装，并确认重新打开过 PowerShell。
提示鉴权失败怎么办？
优先检查 API Key：
- 是否复制完整
- 前后是否多了空格
- 密钥是否仍然启用
- 账户余额是否充足
Codex 没有走 CC Switch 怎么办？
先回到 CC Switch，确认：
- 顶部选中的是 Codex
- 供应商卡片显示为使用中
- 已点击同步，并出现运行正常提示
确认后重新打开 PowerShell，再运行 codex 测试。