Skip to main content

​
开始前

请先确认你已经完成以下准备：
  • 已在服务控制台创建 API 密钥
  • 本地已安装 Codex CLI

​
配置步骤

​
macOS / Linux / WSL

写入配置文件： 
~/.codex/config.toml
~/.codex/auth.json
config.toml 示例： 
model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://as.sub2api.dev"
wire_api = "responses"
requires_openai_auth = true
auth.json 示例： 
{
  "OPENAI_API_KEY": "你的API密钥"
}
如目录不存在，可先执行： 
mkdir -p ~/.codex

​
Windows

写入配置文件： 
%userprofile%\.codex\config.toml
%userprofile%\.codex\auth.json
config.toml 示例： 
model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://as.sub2api.dev"
wire_api = "responses"
requires_openai_auth = true
auth.json 示例： 
{
  "OPENAI_API_KEY": "你的API密钥"
}
如目录不存在，请先手动创建。

​
验证方式

配置完成后，建议执行以下验证：
  1. 重新打开终端
  2. 启动 Codex CLI
  3. 发送一个简单问题，例如 hi
  4. 若模型能正常返回结果，则说明配置成功

​
常见问题

​
config.toml 和 auth.json 缺一不可吗？

通常需要两者同时存在：前者负责模型与服务配置，后者负责 API 密钥。

​
修改配置后不生效怎么办？

请先确认文件路径是否正确，并重新打开终端或重新启动 Codex CLI。

​
相关页面