Codex 配置(CLI 方式)

前置:已完成 环境检查。

Windows

1. Win+R 输入 %userprofile%\.codex 打开配置目录
2. 关键三个文件:
   • config.toml — Codex / 中转 / MCP 配置
   • auth.json — API Key 凭据
   • AGENTS.md — Codex 全局提示词(可选)

新装的 Codex 可能没有这些文件,需要手工创建。

配置 config.toml

disable_response_storage = true
model = "gpt-5.5"
model_provider = "opusclaw"
model_reasoning_effort = "high"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.opusclaw]
name = "opusclaw"
base_url = "https://api.opusclaw.me/v1"
wire_api = "responses"
requires_openai_auth = true

配置 auth.json

{
  "OPENAI_API_KEY": "xxx"
}

把 xxx 替换为 OpusClaw 控制台为 chatgpt 分组创建的令牌。

测试

codex

进入对话即代表配置成功。

macOS

1. Finder Cmd+Shift+G 输入 ~/.codex
2. 同样三个文件
3. config.toml 内容:

model_provider = "opusclaw"
model = "gpt-5-codex"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"

[model_providers.opusclaw]
name = "opusclaw"
base_url = "https://api.opusclaw.me/v1"
wire_api = "responses"
requires_openai_auth = true

4. auth.json 同 Windows
5. 终端 codex 验证

字段说明

字段	说明
model_provider	自定义供应商名称,自己起一个就行,这里用 opusclaw
model	默认模型,推荐 gpt-5.5 通用 / gpt-5-codex Coding
base_url	OpusClaw API 入口 + /v1,固定 https://api.opusclaw.me/v1
wire_api	responses(推荐)
requires_openai_auth	走 OpenAI 鉴权头
disable_response_storage	不让 Codex 把响应留在远端

仍报错?

→ Codex FAQ