在 Codex CLI 中使用 1024X

OpenAI 官方的 Codex CLI 完全兼容 Responses API。把它的 base URL 切到 1024X, 所有请求就会用你 1024X 账户的 API Key 计费。

1. 创建 1024X API Key

登录后进入 /user/keys 点击 Create key 复制下来, key 以 nub_ 开头, 只显示一次。

2. 配置 ~/.codex/config.toml

声明一个命名 provider, base URL 指向 1024X 即可。API Key 由下一步的 ~/.codex/auth.json 提供, 这里不用写 env_key。

toml

# ~/.codex/config.toml
# 默认走 1024X 网关, 模型可以按需改成目录里支持 Responses API 的任意一款。
model_provider = "x1024"
model = "gpt-5-codex"

[model_providers.x1024]
name = "1024X"
base_url = "https://api.1024x.ai/v1"
wire_api = "responses"

3. 在 ~/.codex/auth.json 写入 API Key

Codex 启动时会读 ~/.codex/auth.json, 用其中的 OPENAI_API_KEY 字段做认证。把上一步的 nub_ key 粘进来即可:

json

// ~/.codex/auth.json
// 把 1024X 控制台生成的 key 填到这里, Codex 启动时会自动读取
{
  "OPENAI_API_KEY": "nub_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

建议: chmod 600 ~/.codex/auth.json, 把读权限收回到当前用户, 避免 key 被其他账号读到。

4. 启动 Codex

bash

codex                       # 读 config.toml 的默认 profile
codex --profile x1024       # 显式指定 profile

模型选择

只要是模型目录中支持 Responses API 的模型都能用。在 config.toml 的 `model` 字段里写一个, 或者命令行用 `-m` 临时切。

常见问题

401: 在 /user/keys 确认 key 还有效, 并且 ~/.codex/auth.json 是合法 JSON, 字段名为 OPENAI_API_KEY。
wire 模式: 保持 wire_api = "responses"; chat/completions 也通, 但 responses 通道的 token 计费最精准。
额度耗尽? 看 dashboard 上的当期用量和套餐限制。