OpenAI 兼容工具

Codex CLI 接入 6星中转:Base URL 使用 /v1

Codex CLI 走 OpenAI 兼容接口时,Base URL 通常填写 https://www.6xin.cc/v1。如果你不想手动改配置,建议优先使用 CC Switch 一键导入。

预计阅读 5 分钟 适合手动配置 Codex CLI、重点确认 /v1 地址的用户
核心规则:带 /v1 OPENAI_API_KEY config.toml 模型 ID

等不及了,先照这张表填

Codex CLI 走 OpenAI 兼容接口,和 Claude Code 正好相反:这里要带 /v1。

要配置什么填写值最容易错的点
Base URL https://www.6xin.cc/v1 不要填成 Claude Code 的根地址。
API Key OPENAI_API_KEY=sk-你的6星中转令牌 在启动 Codex 的同一个终端里必须有值。
Provider 自定义 comeu provider 不要覆盖内置 openai provider 名称。
模型 模型广场复制的 OpenAI 兼容模型 ID 模型和令牌分组不匹配会 403。

确认 Codex CLI 能打开

OpenAI 官方 Codex CLI 支持安装脚本、npm、Homebrew 和二进制包等方式。6星中转 教程只负责接入配置,先确认本机命令可用。

检查命令应该看到什么
命令是否存在which codex能输出可执行文件路径。
版本或帮助codex --version 或 codex --help能正常输出,不是 command not found。
安装方式npm install -g @openai/codex 或 brew install --cask codex按你自己的系统选择,不要在生产机上随意全局安装。

一、设置令牌环境变量

先把 6星中转 令牌放进环境变量,避免把完整密钥写死在配置文件里。

export OPENAI_API_KEY="sk-你的令牌"

如果你使用 zsh,可以放到 ~/.zshrc;临时测试时只在当前终端执行即可。

二、先用 OpenAI 兼容接口直测

在改 Codex 配置前,先确认 6星中转 令牌能通过 OpenAI 兼容接口完成最小调用:

curl "https://www.6xin.cc/v1/chat/completions" \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1-mini",
    "messages": [
      {"role": "user", "content": "回复 OK"}
    ]
  }'

这一步成功后,再配置 Codex。否则 Codex 报错时很难判断是本地配置问题还是令牌问题。

三、配置 OpenAI 兼容端点

不同 Codex CLI 版本的配置字段可能略有差异,原则是:provider 指向 6星中转,Base URL 使用 https://www.6xin.cc/v1,令牌从 OPENAI_API_KEY 读取。

# ~/.codex/config.toml 示例,按你的 Codex CLI 版本校准字段
model = "gpt-4.1-mini"
model_provider = "comeu"

[model_providers.comeu]
name = "6星中转"
base_url = "https://www.6xin.cc/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"
如果你的 Codex CLI 版本提示字段名不同,以该版本的命令输出和官方说明为准;不要为了套示例强行保留旧字段。

手动配置步骤

1

创建 Codex 专用令牌

在 6星中转 令牌管理里创建 OpenAI 兼容分组令牌,名称建议写成 local-codex-cli。

2

设置 OPENAI_API_KEY

先在当前终端临时设置,确认能跑通后再写入 shell 配置文件或密码管理器。

3

跑最小 curl 直测

先确认 https://www.6xin.cc/v1/chat/completions 能返回短文本。

4

添加 6星中转 provider

在 ~/.codex/config.toml 里添加自定义 provider,并把 model_provider 指向它。

5

新开终端启动 Codex

用一个短任务确认配置生效,再让 Codex 修改真实项目文件。

四、选择模型

模型 ID 从 6星中转 模型广场复制。首次测试建议选择响应快、成本低、分组确定可用的模型。

目标建议原因
验证连通性 选择轻量模型 快速确认令牌和 Base URL 正确。
代码修改 选择能力更强的代码模型 更适合跨文件理解、重构和测试修复。
稳定使用 选择稳定线路分组可用模型 减少高峰期失败和重试。

五、确认 Codex 读到了你的配置

很多失败来自“配置文件写了,但工具没有读到”。按下面顺序定位:

检查项现象处理
配置文件路径 改了文件但请求仍走旧地址。 确认当前用户目录下的 ~/.codex/config.toml 是否是实际读取路径。
环境变量 401 或提示缺少 API Key。 在启动 Codex 的同一个终端里只确认 OPENAI_API_KEY 是否有值,不要输出完整密钥。
项目级覆盖 只有某个仓库里配置不生效。 检查项目内是否有覆盖 provider、model 或 profile 的配置。
模型字段 请求能发出,但 404 或模型不存在。 换成模型广场里当前分组明确可用的模型。

这些情况先停下来,不要继续改更多配置

Codex CLI 的关键是 OpenAI 兼容入口、配置文件路径和 provider 名称。排障时一次只改一个变量,才能判断是哪一层出了问题。

现象先停在哪里下一步只做这一件事
接口直测失败 不要继续编辑 Codex 配置。 先让 6星中转 的 /v1/chat/completions 最小请求通过。
仍然访问官方默认地址 不要换模型。 检查 model_provider 是否指向 6星中转 provider,以及配置文件路径是否正确。
提示 provider 无效 不要复制一整份复杂示例。 只保留最小 provider、Base URL、env key 和模型字段。
返回 401 不要在页面或截图里暴露完整密钥。 确认启动 Codex 的同一终端里能读取到 OPENAI_API_KEY。
403 或模型不存在 不要把所有模型都加进配置。 只换成当前令牌分组明确可用的一个模型。
6星中转 用量日志没有记录 不要只在 Codex 内继续重试。 说明请求没有打到 6星中转,回到 provider 和 Base URL 排查。

六、验证与排障

现象原因处理
401 OPENAI_API_KEY 未生效或令牌错误。 在同一终端只确认 OPENAI_API_KEY 是否有值,不要输出完整密钥。
404 Base URL 没带 /v1,或模型 ID 错。 确认配置里是 https://www.6xin.cc/v1,模型从模型广场复制。
403 令牌分组和模型不匹配。 换可用模型或创建匹配分组的令牌。
仍然访问官方默认地址 Codex 没读到你修改的配置文件。 检查当前用户目录、配置文件路径和启动时的工作环境。
提示 provider 配置无效 字段名、provider id 或 TOML 格式不符合当前版本。 先备份配置,只保留最小 provider;不要用 openai、ollama、lmstudio 作为自定义 provider id。
为什么 curl 成功,Codex 还是 401?

多数是 Codex 启动时没有读到同一个 OPENAI_API_KEY。在启动 Codex 的同一终端里检查变量是否有值,注意不要截图完整令牌。

为什么一直走默认 OpenAI 地址?

检查 model_provider 是否真的指向 6星中转 provider,以及配置文件是否写在当前用户会读取的位置。不同启动方式可能读取不同用户目录。

wire_api 应该怎么选?

6星中转 的 Codex 手动配置示例按聊天兼容口径写。若你的 Codex CLI 版本提示字段或 wire API 名称不同,以该版本官方配置说明为准,先保持最小 provider 跑通。

完成标准

检查项应该看到什么不满足时先看
令牌变量 OPENAI_API_KEY 在启动 Codex 的同一终端里有值。 设置令牌
接口直测 /v1/chat/completions 最小请求能返回文本。 接口直测
配置文件 Codex 读取到 6星中转 provider,Base URL 是 https://www.6xin.cc/v1。 配置读取
6星中转 用量日志 能看到刚才那次 Codex 请求时间点。 验证与排障

多项目使用建议

如果你在多个项目里使用 Codex,建议按项目或用途拆分令牌和模型配置。生产代码仓库使用稳定模型,本地试验仓库使用轻量模型,避免一次配置影响所有项目。

  • 令牌名称写清楚项目和用途,例如 codex-local-project。
  • 不要把 OPENAI_API_KEY 写进项目仓库的脚本里。
  • 切换模型后,先做小任务验证,再让工具改动大范围文件。

恢复或切回默认

临时测试只设置了环境变量时,关闭终端即可恢复。改过配置文件时,建议先备份再删除 6星中转 provider 配置块。

# 建议备份后再改
cp ~/.codex/config.toml ~/.codex/config.toml.bak

Codex CLI 仍然不通时,提交这些定位信息

Codex CLI 手动配置失败时,先确认 OpenAI 兼容直测能不能成功,再判断 Codex 是否读到了同一套 provider。不要只看配置文件存在。

信息建议内容不要提供什么
令牌变量 OPENAI_API_KEY 是否在启动 Codex 的同一终端里有值,只给脱敏片段。 不要输出完整令牌。
接口直测结果 /v1/chat/completions 是否成功,Base URL 是否为 https://www.6xin.cc/v1。 不要把 Claude 根地址规则套进 Codex。
配置来源 用户级配置、项目级配置、环境变量、当前工作目录,以及是否有旧 provider 覆盖。 不要混用多个项目的报错。
模型和分组 模型 ID、令牌分组、/v1/models 是否能看到目标模型。 不要用“默认模型”代替模型 ID。
6星中转 回证 Codex 短问答是否在用量日志里出现对应时间点。 不要只说“Codex 没反应”。

如果只有某个项目失败,优先检查项目级配置;如果希望减少手动配置,改看 CC Switch 切换 Codex CLI。