OpenAI Codex CLI 配置教程

📋 前置准备

在开始之前，请确保你已经：

• 注册了 Koze 账号并登录
• 在 API 管理 页面创建了一把 API Key
• 已安装 Codex CLI（npm install -g @openai/codex）

🚀 步骤一：配置 Codex 配置文件

在 ~/.codex/config.toml 文件开头添加以下配置：

model_provider = "koze"
model = "gpt-4.1"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.koze]
name = "koze"
base_url = "https://api.kozeai.com/v1"
wire_api = "responses"
requires_openai_auth = true

💡 提示：将 https://api.kozeai.com/v1 替换为你的实际 Koze 代理地址。model 字段可以根据你的套餐选择不同模型。

🔑 步骤二：配置 API 密钥

在 ~/.codex/auth.json 文件中配置你的 API 密钥：

{
  "OPENAI_API_KEY": "你的Koze API密钥"
}

🎯 步骤三：启动 Codex

配置完成后，直接在终端启动：

codex

Codex CLI 会自动使用 Koze 代理进行 API 请求。

📌 可用模型

你可以在配置文件的 model 字段使用以下模型（取决于你的 Koze 套餐）：

模型名称	说明
gpt-5.3-codex	gpt-5.3-codex，适合日常编程任务
gpt-5.4-mini	GPT-4.1 Mini，性价比更高
gpt-5.4	GPT-5.4 多模态模型

⚠️ 常见问题

问题	解决方案
提示 "Authentication failed"	检查 auth.json 中的 API Key 是否正确
config.toml 不生效	确保配置写在文件开头，且 model_provider 名称与 [model_providers.xxx] 一致
使用 Nginx 反代时失效	在 Nginx http 块中添加 underscores_in_headers on;，否则 Nginx 默认丢弃带下划线的请求头