Codex 配置
配置 OpenAI Codex CLI 通过 APIMaster OpenAI 兼容接口调用 GPT 模型。
Codex 配置
请先完成 环境检查 与 获取 API Key。
Codex 走 OpenAI 兼容 接口,Base URL 为 https://apimaster.ai/v1。
Windows
1. 打开配置目录
Win + R 后输入:
%userprofile%\.codex
2. 需要的文件
| 文件 | 作用 |
|---|---|
config.toml |
核心配置:中转、model_provider、模型名 |
auth.json |
API Key |
AGENTS.md |
可选,全局提示词 |
初次安装可能没有这些文件,请手动创建。
3. config.toml
disable_response_storage = true
model = "gpt-5.4"
model_provider = "apimaster"
model_reasoning_effort = "high"
model_verbosity = "high"
[features]
web_search_request = true
[model_providers.apimaster]
base_url = "https://apimaster.ai/v1"
name = "apimaster"
requires_openai_auth = true
wire_api = "responses"
model可改为gpt-5.5等,见 支持的模型。若 CLI 版本不支持wire_api = "responses",可改为wire_api = "chat"或删除该行后重试。
4. auth.json
{
"OPENAI_API_KEY": "YOUR_API_KEY"
}
YOUR_API_KEY 为 控制台 创建的 APIMaster 令牌。
5. 测试
codex
能对话并收到回复即成功。
macOS
1. 打开目录
Command + Shift + G:
~/.codex
2. config.toml
model_provider = "apimaster"
model = "gpt-5.4"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
model_verbosity = "high"
[model_providers.apimaster]
name = "apimaster"
base_url = "https://apimaster.ai/v1"
wire_api = "responses"
requires_openai_auth = true
3. auth.json
{
"OPENAI_API_KEY": "YOUR_API_KEY"
}
4. 测试
codex
排错
| 现象 | 建议 |
|---|---|
| 401 | 检查 auth.json 与控制台 Key |
| 404 / model | 确认 model 与账户可用模型一致 |
| 连接超时 | 检查 base_url 必须为 https://apimaster.ai/v1(含 /v1) |