Codex | xAPI Documentation

Codex 是 OpenAI 官方的命令行 coding agent, 基于 OpenAI Chat Completions 协议。xAPI 接受 Authorization: Bearer 鉴权头, 与 Codex 默认行为完全兼容,接入仅需两个环境变量。

$ npm install -g @openai/codex

进入 xapi.to 控制台 → API Keys → 新建。

写入 ~/.zshrc 或 ~/.bashrc:

$ export OPENAI_BASE_URL="https://ai.xapi.to/v1"
$ export OPENAI_API_KEY="sk-xapi-..."
$ export OPENAI_DEFAULT_MODEL="gpt-5.5"

加载新环境:

$ source ~/.zshrc

Base URL 必须以 /v1 结尾,Codex 强制要求。 Codex 内部使用 Authorization: Bearer ${OPENAI_API_KEY} 鉴权 —— xAPI 直接接受这种格式。

$ codex "用 Python 实现 Fibonacci 函数"

确认收到流式输出后,可在 xapi.to 控制台 → Usage Records 查看调用记录。

锁定到特定上游(可选)

修改 OPENAI_BASE_URL:

上游	base URL
SkyAPI(模型最全)	`https://skyapi.p.xapi.to/v1`
SuperToken Max(官方源)	`https://supertoken-max.p.xapi.to/v1`
SuperToken 逆向(成本最低)	`https://supertoken.p.xapi.to/v1`

修改 OPENAI_DEFAULT_MODEL。SkyAPI 在 OpenAI 协议层对 Anthropic Messages 做了适配, 以下模型均可在 Chat Completions 接口下调用:

完整清单参见模型与价格。

如需仅在特定项目中使用 xAPI,可配合 direnv, 在项目根目录创建 .envrc:

$ export OPENAI_BASE_URL="https://ai.xapi.to/v1"
$ export OPENAI_API_KEY="sk-xapi-..."
$ export OPENAI_DEFAULT_MODEL="gpt-5.5"

执行 direnv allow 后,该目录下的 codex 命令将使用 xAPI, 其他位置仍走原配置。

OPENAI_BASE_URL 缺少 /v1 后缀。完整格式:https://ai.xapi.to/v1。

默认模型不在所选上游的支持列表中。改为模型清单中实际存在的名称。