Codex 配置

前置条件

• 本机已经安装 Node.js 和 Codex CLI。Codex CLI 版本要求可能变化，请以官方安装说明为准。
• 注册并登录 PionicAI 控制台：https://api.pionicai.com/dashboard/overview。
• 在钱包中兑换或确认可用额度：https://api.pionicai.com/wallet。
• 在令牌页面创建一个专用于当前工具的 API Key：https://api.pionicai.com/keys。
• 确认目标模型在控制台可见，并了解模型价格、倍率和渠道状态：https://api.pionicai.com/models。
• 第一次配置只跑一句简单测试，确认认证、模型、余额和日志都正常。
• 建议给 Codex 单独创建一个 Key，并设置合理额度，方便控制成本。

配置文件位置

Codex CLI 通常读取用户目录下的 .codex 文件夹。没有这个目录就手动创建。

在该目录下创建两个文件：auth.json 和 config.toml。

auth.json：保存 PionicAI Key

把你在 PionicAI 控制台创建的 API Key 填入 OPENAI_API_KEY。不要填登录密码，也不要填上游官方 Key。

{"OPENAI_API_KEY":"sk-your-pionicai-key"}

config.toml：声明 PionicAI 网关

model_provider 的值必须和 [model_providers.pionicai] 的段名一致。base_url 必须带 /v1。

model_provider = "pionicai"
preferred_auth_method = "apikey"

[model_providers.pionicai]
name = "PionicAI"
base_url = "https://api.pionicai.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

验证方法

1. 保存两个文件。
2. 关闭并重新打开终端，让 Codex 重新读取配置。
3. 进入一个小项目目录运行 codex。
4. 先发一句简单任务，例如“解释当前目录结构，不要修改文件”。
5. 到调用日志检查是否出现请求记录：https://api.pionicai.com/usage-logs。

常见问题

• 401 / invalid token：API Key 没复制完整，或 auth.json 不是合法 JSON。
• 找不到 provider：model_provider 和 [model_providers.xxx] 段名不一致。
• 404 / 模型不存在：模型名不在当前 Key 分组里，去控制台检查模型列表。
• 消耗过高：Codex 会读取文件和多轮规划，建议单独限额并先小任务测试。