使用文档 / Codex Mac

Codex Mac

Codex Mac 使用教程。

建议分组 gpt-pro建议模型 gpt-6-astra

Base URL（OpenAI 兼容）：https://api.ai-trailblazer.com/v1

(一) 安装 Node.js 环境

Mac 安装方法

brew install node

验证：

node --version
npm --version

(二) 安装 Codex

npm install -g @openai/codex --registry=https://registry.npmmirror.com

验证：

codex --version

(三) 配置 Codex

打开 ~/.codex/config.toml，不存在就创建，写入：

disable_response_storage = true
model = "gpt-6-astra"
model_reasoning_effort = "high"
model_provider = "trailblazer"

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

配置节名（model_providers.trailblazer 与 model_provider）可自取，但不能叫 openai（Codex 保留）。name = "OpenAI" 建议保持。

然后编辑 ~/.codex/auth.json，把 Key 写在这里：

{
  "OPENAI_API_KEY": "sk-xxxxx"
}

(四) 开始使用

在项目目录运行：

codex

首次运行按提示确认。

(五) 常见问题

401 / invalid_api_key：Key 填错或已禁用，回控制台核对。
model_not_found：模型名写错。可用：gpt-6.1-sol、gpt-6-astra、gpt-6-sol、gpt-5.6-terra、gpt-5.6-sol、gpt-5.5、codex-auto-review。
连不上：确认 base_url 是 https://api.ai-trailblazer.com/v1（带 /v1）。