1 前置条件

Codex 通过 Responses API 与模型交互。先安装 Codex CLI，并至少运行一次以创建 ~/.codex 目录。

安装

npm install -g @openai/codex

首次启动

codex

2 配置 APIKEY

Linux / macOS

export APIKEY="<你的 APIKEY>"

Windows PowerShell

$env:APIKEY="<你的 APIKEY>"

3 配置 ~/.codex/config.toml

推荐配置

model = "spark-x2.5"
model_provider = "spark"
preferred_auth_method = "apikey"
forced_login_method = "api"
model_reasoning_effort = "high"

[model_providers.spark]
name = "Spark X2.5"
base_url = "https://maas-api.cn-huabei-1.xf-yun.com/v1"
wire_api = "responses"
env_key = "APIKEY"
env_key_instructions = "设置 APIKEY 为讯飞平台 APIKEY"

Codex 使用 wire_api = "responses" 并在 Base URL 后请求 /responses，因此 Base URL 使用 https://maas-api.cn-huabei-1.xf-yun.com/v1。

4 启动与验证

启动

cd /path/to/your/project
codex

建议依次验证纯文本输出、Responses 流式事件、reasoning summary 和 function call。