用 CC Switch 切换 Codex CLI 到 6星中转
Codex CLI 走 OpenAI 兼容协议，API URL 填 https://www.6xin.cc/v1。这里的 /v1 是核心差异，漏掉后通常会找不到接口。
先看结论：Codex CLI 速填表
| 配置项 | 6星中转 应该怎么填 | 错了会怎样 |
|---|---|---|
| 应用页 | 在 CC Switch 顶部选择 Codex。 | 配置写到 Claude 或 Gemini 页时，Codex 不会生效。 |
| API URL | https://www.6xin.cc/v1 |
漏掉 /v1 时，常见 404 或找不到 OpenAI 兼容接口。 |
| API Key | 使用能访问目标 OpenAI 兼容模型的 6星中转 令牌。 | 401、403 或 model_not_found。 |
| 验证方式 | 重开终端，让 Codex 输出短回复，再查 6星中转 用量日志。 | 只看模型列表，不能证明生成链路可用。 |
看这篇前
请先看 通用概念与配置：那里讲了安装、Provider 字段和 6星中转 令牌。本页只讲 Codex CLI 的差异。
一、什么情况适合切 Codex CLI
| 场景 | 是否适合 | 建议 |
|---|---|---|
| 同时使用官方 OpenAI Key 和 6星中转 令牌 | 适合 | 分别保存 Provider，需要时切换。 |
| 不同项目需要不同模型或额度 | 适合 | 按项目创建令牌和 Provider，例如 6星中转-Codex-client-a。 |
| 测试和生产令牌要隔离 | 适合 | 用命名区分 prod、test，减少误切。 |
| 长期只用一套 6星中转 配置 | 可选 | 可以用 CC Switch，也可以手动写 Codex 配置。 |
二、开始前准备
- 已经创建 Codex 或 OpenAI 兼容模型可用的 6星中转 令牌。
- 本机已经安装 Codex CLI。
- 知道自己要用的模型 ID，并确认该令牌分组有权限。
codex --version| 你需要的值 | 填写内容 | 注意 |
|---|---|---|
| API URL | https://www.6xin.cc/v1 |
Codex 必须带 /v1。 |
| API Key | sk-你的 6星中转 令牌 |
令牌需要能访问你填写的模型。 |
| Model | OpenAI 兼容模型 ID | 以 6星中转 模型广场当前显示为准。 |
三、在 CC Switch 里添加 Codex 配置
打开 CC Switch
顶部应用切换到 Codex。
添加 Provider
点击 Add Provider，名称建议写成 6星中转-Codex 或 6星中转-Codex-prod。
填写 API URL 和 Key
API URL 填 https://www.6xin.cc/v1，API Key 填 6星中转 令牌。不要使用 Claude 的根地址写法。
保存、启用、重开终端
保存后点击 Enable，关闭旧 Codex 终端，再打开新终端验证。
| 字段 | 示例 | 说明 |
|---|---|---|
| Name | 6星中转-Codex | 本地显示名。 |
| Provider / App | Codex | 写入 Codex CLI 配置。 |
| API URL | https://www.6xin.cc/v1 | 必须带 /v1。 |
| API Key | sk-你的令牌 | 6星中转 令牌。 |
| Model | gpt-4.1-mini 或其他可用模型 | 示例模型仅作占位，实际以模型广场为准。 |
四、为什么 Codex 要带 /v1
Codex CLI 使用 OpenAI 兼容接口。OpenAI 兼容请求路径通常从 /v1 开始，例如模型列表、聊天补全等。因此 Base URL 需要直接填到 /v1 这一层。
| 写法 | 结果 | 判断 |
|---|---|---|
https://www.6xin.cc/v1 |
Codex 能按 OpenAI 兼容路径请求。 | 正确 |
https://www.6xin.cc |
客户端可能请求到错误路径。 | 常见 404 或找不到接口 |
五、验证切到 6星中转
- 关闭所有旧 Codex 终端。
- 打开新终端。
- 启动 Codex CLI。
- 发送短指令。
codex输出：OK能正常返回后，再到 6星中转 控制台用量日志里按时间点查记录。如果日志能对上，说明请求确实走了 6星中转。
六、完成标准
| 检查项 | 应该看到什么 | 不满足时回到哪里 |
|---|---|---|
| CC Switch 启用项 | Codex 应用下 6星中转-Codex 处于使用中。 |
添加 Codex 配置 |
| API URL | 是 https://www.6xin.cc/v1，带 /v1。 |
/v1 规则 |
| 新终端短问答 | Codex CLI 能正常输出 OK。 | 验证切到 6星中转 |
| 6星中转 用量日志 | 能看到刚才那次 Codex 请求。 | 常见误区 |
七、只有某个项目失败时，先查项目级覆盖
Codex CLI 常用于具体代码项目。全局配置已经切到 6星中转，但某个项目仍失败时，优先怀疑项目目录里的配置、环境变量或启动脚本覆盖了 CC Switch 写入的结果。
| 覆盖来源 | 怎么安全检查 | 处理方式 |
|---|---|---|
| 当前终端环境变量 | printenv OPENAI_BASE_URLtest -n "$OPENAI_API_KEY" && echo OPENAI_API_KEY=set |
如果指向旧后端，先清理当前终端变量或新开终端。 |
项目 .env 或启动脚本 |
只查看变量名，不复制完整密钥。 | 把旧地址改成 6星中转，或让项目脚本读取 CC Switch 写入的配置。 |
| 项目级 Codex 配置 | 检查当前项目是否有单独 provider、model 或 base URL 设置。 | 删除旧覆盖，或在项目级也同步 6星中转 配置。 |
| Shell alias / wrapper | type codex |
如果 wrapper 写死旧 Key，先改 wrapper 再验证。 |
八、失败时按这个顺序排查
Codex CLI 失败时，先把“地址层”和“配置来源层”分开。它走 OpenAI 兼容协议，漏掉 /v1 和项目级配置覆盖是最常见的两类问题。
确认切的是 Codex 应用
打开 CC Switch 顶部应用切换，确认当前在 Codex 页，并且 6星中转-Codex 处于使用中。
重开终端再启动 Codex
关闭旧 Codex CLI 进程，重新打开终端。只点 Enable 不会让已启动进程自动换配置。
核对 /v1
API URL 应该是 https://www.6xin.cc/v1。如果写成根地址，OpenAI 兼容路径通常会找不到接口。
排除项目级覆盖
如果只有某个项目失败，检查项目目录里的 Codex 配置或环境变量是否覆盖了 CC Switch 写入的全局配置。
核对日志和模型
短请求成功后，到 6星中转 用量日志按时间点找记录。401 看令牌，404 看路径，model_not_found 看模型 ID 和分组。
这些情况先停下来，不要继续改 Codex 配置
Codex CLI 走 OpenAI 兼容协议，最常见的问题是漏掉 /v1、旧终端没重开，或项目级配置覆盖。先定位这一层，再动模型和令牌。
| 现象 | 先停止什么 | 下一步只做这一件事 |
|---|---|---|
| 404 / 找不到接口 | 不要重装 Codex CLI。 | 只确认 API URL 是 https://www.6xin.cc/v1。 |
| 仍访问旧地址 | 不要继续新建 Provider。 | 检查项目级配置和 shell wrapper 是否覆盖。 |
model_not_found |
不要把所有模型都塞进配置。 | 换成当前令牌分组明确可用的一个模型。 |
| 6星中转 日志没有记录 | 不要只在 Codex 里反复重试。 | 说明请求没有到 6星中转，回到 provider 和 Base URL 排查。 |
九、切回原来的后端
切回官方 OpenAI 或其他后端时，在 Codex 配置列表里启用原来的 Provider，然后关闭当前 Codex 终端并重新打开。
Codex-official、6星中转-Codex-prod、6星中转-Codex-test。名字越清楚，误切概率越低。
十、常见误区
| 现象 | 原因 | 处理 |
|---|---|---|
| 404 / 找不到接口 | API URL 漏了 /v1。 |
改成 https://www.6xin.cc/v1。 |
invalid_api_key 或 401 |
令牌错误、过期、没有在当前终端生效。 | 重新复制 6星中转 令牌，确认没有多余空格。 |
model_not_found |
模型 ID 不在当前令牌分组中。 | 去 6星中转 模型广场复制可用 ID，或换对应分组令牌。 |
| 429 / rate limit | 并发过高、额度不足或上游限流。 | 降低并发，看 6星中转 余额、状态页和日志。 |
| 启用后仍访问旧地址 | 旧终端没重开，或项目级配置覆盖。 | 重开终端，并检查项目目录里的 Codex 配置。 |
十一、日常使用建议
- 开发、测试、生产分别建令牌和 Provider。
- 每次切换后先发短请求，不要直接让 Codex 改大范围代码。
- 不要把 6星中转 令牌写进项目仓库。
- 长期不用的旧 Provider 及时删除或改名标记，避免误用。
Codex CLI 仍然不通时，提交这些定位信息
Codex CLI 的定位重点是 OpenAI 兼容地址必须带 /v1、当前项目是否覆盖用户级配置，以及新终端是否真的读到了 Provider。
| 信息 | 建议内容 | 不要提供什么 |
|---|---|---|
| Provider 配置 | Provider 名称、API URL 是否为 https://www.6xin.cc/v1、模型 ID。 |
不要提交完整令牌。 |
| 配置来源 | 用户级配置、项目级配置、环境变量或 CC Switch 当前启用项。 | 不要只说“某个项目不能用”。 |
| 复现位置 | 全局都失败，还是只有某个项目目录失败；发生时间和命令入口。 | 不要混用多个项目的报错截图。 |
| 6星中转 回证 | 新终端短问答是否成功，用量日志是否出现对应时间点。 | 不要把完整业务 prompt 放进工单。 |