Codex CLI 教程

Codex CLI 使用 Responses API。请先确认密钥所属分组和模型支持 /v1/responses。

1. 安装

需要 Node.js 和 npm：

npm install -g @openai/codex
codex --version

2. 创建配置目录

Windows PowerShell：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex"

Linux/macOS：

mkdir -p ~/.codex

3. 配置 config.toml

文件位置：

• Windows：%USERPROFILE%\.codex\config.toml
• Linux/macOS：~/.codex/config.toml

写入：

model_provider = "OpenAI"
model = "MODEL_ID"
review_model = "MODEL_ID"
disable_response_storage = true

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://ai.zjtzsmc.com/v1"
wire_api = "responses"
requires_openai_auth = true

请把两个 MODEL_ID 都替换成本站模型广场中的准确模型 ID。

4. 配置 auth.json

在同一目录创建 auth.json：

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

Linux/macOS 建议限制权限：

chmod 600 ~/.codex/auth.json ~/.codex/config.toml

5. 启动

进入项目目录：

codex

修改配置后必须完全退出旧的 Codex 进程并重新启动。

常见问题

• 401：检查 auth.json、密钥状态和 requires_openai_auth。
• 404：检查 Base URL 是否为 /v1，以及线路是否支持 Responses。
• 模型不存在：从模型广场重新复制 ID。
• 一直要求登录：确认配置文件位于当前系统用户的 .codex 目录。
• Chat Completions 可用但 Codex 不可用：当前线路可能只支持 /v1/chat/completions，Codex 需要 Responses。

官方配置字段可参考 OpenAI Codex 配置文档。