Codex CLI

1. 安装

npm install -g @openai/codex

2. 配置

Codex CLI 读取 ~/.codex/config.toml。新增一个指向本服务的 provider：

model = "gpt-5"
model_provider = "higan"

[model_providers.higan]
name = "Higan API"
base_url = "https://api.higanai.top/v1"
env_key = "HIGAN_API_KEY"
wire_api = "responses"   # 若报错可改为 "chat"

写入密钥（不要写进配置文件）：

# Linux / macOS
echo 'export HIGAN_API_KEY="sk-你的密钥"' >> ~/.bashrc

# Windows PowerShell
setx HIGAN_API_KEY "sk-你的密钥"

3. 验证

codex "用一句话解释什么是递归"

4. 常见问题

现象	处理
`401`	密钥没读到。重开一个终端，或检查 `env_key` 名称一致
`model not found`	模型名写错。跑 `curl https://api.higanai.top/v1/models -H "Authorization: Bearer sk-xxx"` 看可用列表
输出卡住然后一次性刷出	流式被缓冲。确认没有自建缓冲反代，或改用直连
`wire_api` 报错	把 `"responses"` 改成 `"chat"` 再试

5. 省钱提示

Codex 每次会重发大量上下文。保持同一个会话连续对话能显著提高上游缓存命中率，比每轮新开会话便宜得多。

更多问题见常见问题。