环境配置

三步完成最小可用配置。

推荐方式

更倾向一键配置（自动写入 ~/.codex/config.toml 与 ~/.codex/auth.json），请使用：一键脚本配置。

三步最小可用配置

1. 创建配置目录

在用户主目录下创建 .codex 文件夹：

macOS / Linux

mkdir -p ~/.codex

# 之后可在访达按 Command + Shift + G，输入 ~/.codex 回车打开该目录

Windows

mkdir $env:USERPROFILE\.codex

# 之后可按 Win + R，输入 %USERPROFILE%\.codex 回车打开该目录

2. 创建 config.toml

在 .codex 目录中创建 config.toml，写入以下内容：

model_provider = "codexzh"
model = "gpt-5.6-terra"
model_reasoning_effort = "medium"
# 缓存优化配置
cache_size_mb = 512
cache_ttl = "30m"
smart_cache = true
cache_compression = true

[model_providers.codexzh]
name = "codexzh"
base_url = "https://api.codexzh.com/v1"
wire_api = "responses"
requires_openai_auth = true
web_search = "live"

[features]
collaboration_modes = true
unified_exec = false
multi_agent = true
search_tool = true
steer = true

3. 创建 auth.json

同目录创建 auth.json，将 OPENAI_API_KEY 替换为控制台里 sk- 开头的真实密钥：

{
  "OPENAI_API_KEY": "sk-你的实际密钥"
}

验证配置

完成后启动测试：

codex

能进入对话界面并正常回复，即配置成功。

想把默认模型改成 Grok，只改 config.toml 里的 model 即可，见使用 Grok 模型。

遇到问题？

1. 先查 服务运行状态，排除服务端问题
2. 再回 Codex CLI 集成 确认本机环境正常
3. 仍有报错，看 错误排查指南 或 常见问题解答