返回首页

Codex CLI

Codex CLI 是 OpenAI 的官方终端编程助手。通过修改两个配置文件，就能让它走 Picklyone 网关，调用 GPT-5 / GPT-4o / o1 等所有 OpenAI 模型。

💡 一键配置：到 API 密钥 页创建 Key 后，在 Key 右侧下拉里点 配置指南 → Codex CLI，可直接复制已填入真实 Key 的 config.toml 和 auth.json 内容。

安装

npm install -g @openai/codex

配置（macOS / Linux）

编辑 ~/.codex/config.toml：

model_provider = "OpenAI"
model = "gpt-5.4-mini"

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

编辑 ~/.codex/auth.json：

{
  "OPENAI_API_KEY": "pk_live_xxxxxxxxxxxxxxxx"
}

配置（Windows）

文件路径换成：

  • %USERPROFILE%\.codex\config.toml
  • %USERPROFILE%\.codex\auth.json

内容同上。如果目录不存在，手动新建 .codex 文件夹。

验证

codex "list files in this folder"

切换模型

把 config.toml 里的 model = "gpt-5.4-mini" 改成任意 OpenAI 模型（例如 gpt-4o、o1、o3-mini）即可。

Picklyone 使用建议

  • 责任分离：一个 Key 只给 Codex：把 OpenAI CLI 系列和其它项目的 Key 分开，万一 auth.json 被同步到公开 repo，撤销影响面最小。
  • 关掉 reasoning 模型的跑飞风险：o1 / o3 推理 token 单价很贵，建议在 Key 的 允许模型 里只勾 gpt-5.4 / gpt-4o，或给日限额设一个上限（比如 $10/天）。
  • 自动故障切换：Picklyone 内置多通道冗余，单条拥塞时自动切换备用通道，Codex 侧无感。
  • 透明定价：GPT 系列在 Picklyone 是 2.4 折（官方价的 24%），详见 定价。

常见问题

  • Unauthorized：auth.json 里 Key 字段名必须是 OPENAI_API_KEY，不是 api_key
  • wire_api 错误：必须是 responses，这是 Codex CLI 用的协议
  • 权限不足：Windows 上如果写入失败，确认 .codex 目录不是只读