Codex

OpenAI Codex CLI 通过 Responses API 连接 TokenFlux。调用费用从 TokenFlux 余额扣除。

本指南使用 Codex CLI 0.163.0 和 gpt-6-luna 验证了流式回复。

开始前复制标题链接

1. 准备已安装的 Codex。配置详情请参阅官方Codex 配置参考。
2. 在网页版的 API 密钥 页面创建并复制密钥。完整密钥只显示一次。
3. 在 账单 页面确认余额充足。
4. 在 模型与价格 页面复制模型 ID，并检查模型支持的协议。

添加 Responses API 提供商复制标题链接

在 Bash 或 Zsh 中设置密钥：

export TOKENFLUX_API_KEY="YOUR_TOKENFLUX_KEY"

将以下设置合并到 ~/.codex/config.toml。请将 YOUR_MODEL_ID 替换为模型 ID：

model = "YOUR_MODEL_ID"
model_provider = "tokenflux"

[model_providers.tokenflux]
name = "TokenFlux"
base_url = "https://tokenflux.ai/v1"
env_key = "TOKENFLUX_API_KEY"
wire_api = "responses"
supports_websockets = false

将 YOUR_TOKENFLUX_KEY 替换为刚复制的密钥。请勿将密钥提交到 Git。

Codex 向 /v1/responses 发送 HTTP 流式请求。自定义提供商从 TOKENFLUX_API_KEY 读取密钥，无需登录 ChatGPT。修改文件时保留已有的其他设置。

选择模型复制标题链接

将 model 设为支持 Responses 和工具调用的完整 TokenFlux 模型 ID。单次运行可使用 codex exec --model YOUR_MODEL_ID "Hello" 覆盖模型。

验证连接复制标题链接

在临时目录中运行以下命令。如果客户端要求确认文件访问，请核对路径后批准。

printf 'TOKENFLUX_GUIDE_OK\n' > marker.txt
codex exec --skip-git-repo-check \
  "Read marker.txt with a shell tool and return its contents"

回复应包含 TOKENFLUX_GUIDE_OK。在 使用记录 页面确认模型和密钥，并查看 token 数量与费用。测试完成后删除 marker.txt。

故障排查复制标题链接

Codex 要求登录 OpenAI。 确认 model_provider = "tokenflux" 位于顶层，且 env_key 对应已设置的环境变量。ChatGPT 订阅不支付 TokenFlux 调用费用。

返回 404 或协议错误。 使用 wire_api = "responses"，并将地址设为以 /v1 结尾。Codex 需要 Responses 协议。

使用了其他提供商。 检查当前配置档和项目设置是否覆盖了 model_provider 或 model。

返回 401、429 或模型错误。 检查密钥是否启用、模型 ID 是否完整，以及余额和限流状态。请勿自动改用其他模型。

API 参考复制标题链接

请参阅 Responses、模型列表 和 API 概览。