Codex CLI 接入 6星中转:Base URL 使用 /v1
Codex CLI 走 OpenAI 兼容接口时,Base URL 通常填写 https://www.6xin.cc/v1。如果你不想手动改配置,建议优先使用 CC Switch 一键导入。
等不及了,先照这张表填
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
按当前 Codex CLI 版本支持的配置项设置自定义 OpenAI 兼容 provider,并通过环境变量读取 6星中转 令牌。
确认 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 专用令牌
在 6星中转 令牌管理里创建 OpenAI 兼容分组令牌,名称建议写成 local-codex-cli。
设置 OPENAI_API_KEY
先在当前终端临时设置,确认能跑通后再写入 shell 配置文件或密码管理器。
跑最小 curl 直测
先确认 https://www.6xin.cc/v1/chat/completions 能返回短文本。
添加 6星中转 provider
在 ~/.codex/config.toml 里添加自定义 provider,并把 model_provider 指向它。
新开终端启动 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。