Codex 接入教程

本页使用 Codex CLI + Noah API 的 OpenAI Responses 接口。无需 CC Switch，也不需要 ChatGPT 订阅登录。

示例模型为 gpt-6.1-sol。先确认你的令牌分组能调用它，并在模型广场确认 Responses 接口可用。

1. 安装 Codex CLI

安装 Node.js 的受支持版本，本教程建议 Node.js 22 或更新版本。已有 Codex 可跳过安装，先检查版本。

Windows PowerShell：

node --version
npm.cmd install -g @openai/codex
codex --version

macOS / Linux：

node --version
npm install -g @openai/codex
codex --version

也可以采用 Codex 官方 CLI 文档提供的安装方式。

2. 设置 API Key

在启动 Codex 的同一个终端里设置环境变量：

Windows PowerShell：

$env:NOAH_API_KEY = "sk-替换为你的Noah密钥"

macOS / Linux：

export NOAH_API_KEY='sk-替换为你的Noah密钥'

这只对当前终端和它启动的进程生效。新开终端需要重新设置；若希望长期保存，可使用系统用户环境变量或自己的密钥管理方式。配置文件中只保存变量名，不填真实密钥。

3. 编辑用户级配置

系统	文件位置
Windows	`%USERPROFILE%\.codex\config.toml`
macOS / Linux	`~/.codex/config.toml`

Windows 可以这样创建目录并打开文件：

New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
notepad "$HOME\.codex\config.toml"

将下面的字段合并到用户级配置中：

model = "gpt-6.1-sol"
model_provider = "noah"

[model_providers.noah]
name = "Noah API"
base_url = "https://ai.11451418.xyz/v1"
env_key = "NOAH_API_KEY"
wire_api = "responses"

model 和 model_provider 是根级字段，应放在所有 [表名] 之前。已有同名字段时修改原值，不要重复定义；保留自己已有的 MCP、项目和其他设置。

字段	作用
`model`	Noah 实际可用的模型 ID
`model_provider`	对应下方供应商表的 ID，这里用 `noah`
`base_url`	带 `/v1` 的地址，Codex 自动追加 `/responses`
`env_key`	从 `NOAH_API_KEY` 环境变量读取密钥
`wire_api`	使用 Responses 协议

4. 启动并验证

进入准备工作的项目目录，在刚才设置密钥的终端运行：

codex

输入 /status，检查模型与供应商配置。发送一个简短问题，然后到 Noah 控制台查看该令牌的请求记录。

修改配置或切换供应商后，退出并重新启动 Codex。若启动时仍要求 ChatGPT 登录，先检查是否加载了用户级配置、model_provider 是否为 noah，以及环境变量是否存在于启动进程中。

常见问题

现象	优先检查
提示缺少 `NOAH_API_KEY`	是否在当前终端设置；图形应用不会自动继承另一个终端的临时变量
`401` / `403`	密钥、有效期、余额、令牌权限和分组
`404`	Base URL 是否为 `.../v1`，是否误填完整 `/responses` 端点
模型不可用	模型 ID、令牌白名单、分组的模型和接口支持
能聊天但 Codex 调用失败	Chat Completions 可用不代表 Responses、流式和工具调用都可用
改了配置没有变化	是否改错文件，或旧 Codex 进程仍在运行

当前 Codex 原生使用 Responses。不要照搬旧教程把 wire_api 改为 chat 来尝试直连；只有 Chat 的模型需要额外协议转换。

如果想通过图形界面保存多套供应商，改用 CC Switch 教程。