快速开始

Codex (OpenAI) 配置教程

安装并配置 Codex CLI，通过配置文件把请求接到甜酒的兼容接口。

这篇文档给的是甜酒版接入方式，结构参考主流 CLI 文档，但具体配置项按甜酒的域名、密钥和模型映射来写。

第一步：安装 Codex

Codex CLI 本身通过 npm 分发。先确认 Node.js 环境已经准备好，再安装最新版本。

npm install -g @openai/codex@latest

安装完成后，先用版本号命令确认二进制已经进入 PATH。

codex --version

第二步：创建配置目录

Codex 会从家目录下读取配置文件。建议先把旧的实验性目录清理掉，再创建一个干净的 `.codex` 目录。

if (Test-Path "$env:USERPROFILE\\.codex") { Remove-Item -Recurse -Force "$env:USERPROFILE\\.codex" }
New-Item -ItemType Directory -Path "$env:USERPROFILE\\.codex"

第三步：创建配置文件

甜酒版配置的核心是把默认提供商换成你自己的兼容端点。这里需要两个文件：`config.toml` 和 `auth.json`。

@"
model_provider = "tianjiu"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.tianjiu]
name = "tianjiu"
base_url = "https://api.tianjiu.ai/v1"
wire_api = "responses"
requires_openai_auth = true
"@ | Out-File -FilePath "$env:USERPROFILE\\.codex\\config.toml" -Encoding utf8

@"
{
  "OPENAI_API_KEY": "YOUR_TIANJIU_API_KEY"
}
"@ | Out-File -FilePath "$env:USERPROFILE\\.codex\\auth.json" -Encoding utf8

把 `YOUR_TIANJIU_API_KEY` 替换成你实际拿到的密钥。如果你们团队还有模型映射层，`model` 字段要替换成当前真实开放的模型名。

第四步：开始使用

配置写好后，先直接启动 Codex，跑一个简单任务确认会话、模型和错误回传都正常。

codex

如果提示鉴权失败，先检查 `auth.json` 是否写在正确目录。
如果提示模型不可用，优先和你的对接人确认当前开放的模型名。
如果能启动但响应慢，先记录任务类型和时间，再看是否是上游拥塞或限流。