Codex CLI 配置指南

最近更新：2026 年 10 月 17 日（Asia/Shanghai）

关联：帮助中心 · 大模型 API · VS Code

适用：使用 OpenAI Codex CLI，把请求指向词源探索网关。

配置要点

项	值
Node.js	≥ 18（推荐 20/22 LTS）
Base URL	https://ai.afp.net/v1（必须带 /v1，与 Claude Code 不同）
协议	常用 wire_api = "responses"；若不兼容可改为 Chat Completions 相关设置（视 Codex 版本）

INFO

Codex 面向 OpenAI Responses / Chat Completions 生态。词源探索模型列表以 Claude、Gemini、Kimi、DeepSeek、GLM、Qwen、Seedance 等为主——请先用 GET /v1/models 确认当前令牌可用模型，再写入 config.toml 的 model。若某模型不支持 Responses，接入前请做一次最小测试，或改用 Claude Code / OpenCode。

---

1. 环境与令牌

node --version

控制台创建专用令牌（如名称 codex），复制 sk- 密钥。

---

2. 安装

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

---

3. 配置文件

~/.codex/config.toml

model_provider = "ciyuan"
model = "claude-sonnet-4-6"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.ciyuan]
name = "词源探索"
base_url = "https://ai.afp.net/v1"
wire_api = "responses"
requires_openai_auth = true

把 model 换成你令牌实际可用、且经测试支持当前 wire_api 的模型 ID。若 Responses 报错，可查阅当前 Codex 文档，尝试将 wire_api 调整为其所支持的 Chat Completions 模式（不同版本字段名可能略有差异）。

~/.codex/auth.json

{
  "OPENAI_API_KEY": "sk-xxxxxxxx"
}

Windows 路径一般为 %USERPROFILE%\.codex\。

---

4. 验证

codex "写一个 hello world"
# 或指定模型（示例）
codex --model claude-sonnet-4-6 "实现快速排序并附测试"

---

5. 故障排查

现象	处理
404 / 连不上	确认 base_url 包含 /v1；重启终端
模型不存在	对照 /v1/models；检查令牌分组与可用模型白名单
Responses 4xx	该模型可能不支持 Responses → 换模型或换 wire_api / 换其它 CLI
Node 过旧	升到 18+ 后重装
额度不足	控制台充值或提高令牌额度

---

返回：帮助中心