指南

平台优势、可用模型、接入示例与常见问题。

CLI 配置

Codex

OpenAI 协议，配置 config.toml 与 auth.json。

1
安装工具
任选一种方式安装，第一种为推荐方式，无需 Node.js：
官方脚本推荐
macOS / Linux
bash
Windows PowerShell
powershell
npm
终端
bash
此方式需先安装 Node.js（22+）。安装 Node.js
2
首次运行
运行一次，出现欢迎界面或选项即说明安装成功：
终端
bash
```
codex
```
重要
首次运行才会在用户目录生成配置目录。请务必先运行一次，再继续下面的配置。
3
打开配置目录
进入下方配置目录。若目录或对应文件不存在，请先手动创建：
Windows%USERPROFILE%\.codex
macOS~/.codex
macOS：在访达中按 ⇧⌘G，粘贴上面的路径前往。
Windows：在文件资源管理器地址栏粘贴上面的路径后回车。

写入配置

把配置写入文件，下面两种方式任选其一。

方式一 · 终端一次性写入（推荐，存在即覆盖）：

bash

mkdir -p ~/.codex

cat > ~/.codex/config.toml <<'EOF'
disable_response_storage = true
model = "gpt-5.5"
model_provider = "openai-next"
model_reasoning_effort = "xhigh"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.openai-next]
base_url = "https://api.openai-next.com/v1"
name = "openai-next"
requires_openai_auth = true
wire_api = "responses"
EOF

cat > ~/.codex/auth.json <<'EOF'
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}
EOF

方式二 · 在上述目录手动新建对应文件，粘贴内容保存（存在即覆盖）：

~/.codex/config.toml

toml

disable_response_storage = true
model = "gpt-5.5"
model_provider = "openai-next"
model_reasoning_effort = "xhigh"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.openai-next]
base_url = "https://api.openai-next.com/v1"
name = "openai-next"
requires_openai_auth = true
wire_api = "responses"

~/.codex/auth.json

json

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

auth.json 单独存放密钥；同目录下的 AGENTS.md 为可选文件，用于设置 Codex 的全局提示词。

5
填入 API Key
把 YOUR_API_KEY 替换为活动发放给你的 API Key。
还没有 API Key？前往控制台
6
测试对话
再次运行命令，出现对话界面并能正常回复，即配置成功。
终端
bash
```
codex
```

指南

Codex

安装工具

首次运行

打开配置目录

写入配置

填入 API Key

测试对话