▪ codex cli
接入 Codex CLI
Codex CLI 通过 model_provider 指向 11book,模型与使用习惯保持不变;全程只需一次配置。
前置条件
- 已安装 OpenAI Codex CLI 并可正常运行。
- 已在 控制台创建 API Key,且账户余额充足。
第 1 步 · 设置 API Key 环境变量
Codex 通过 env_key 声明的环境变量读取密钥,把它写入你的 shell 配置(如 ~/.zshrc):
~/.zshrc
export BOOK_API_KEY="sk-xxxx" # create one in the console第 2 步 · 修改 config.toml
编辑 ~/.codex/config.toml,新增 11book provider 并设为默认:
~/.codex/config.toml
model_provider = "11book"
model = "YOUR_MODEL_ID"
[model_providers.11book]
name = "11book"
base_url = "https://api.11book.ai/v1"
env_key = "BOOK_API_KEY"
wire_api = "responses"wire_api = "responses" 表示走 Responses 协议;如需切换其他模型,只改顶部的 model 字段即可。第 3 步 · 验证
重新打开终端(让环境变量生效),运行一句最简单的指令:
终端
codex "Introduce yourself in one sentence"正常返回即接入完成;用量与消费可在控制台「使用记录」查看。
模型选择建议
在模型与价格中选择可用的 GPT / Codex 系列模型,将示例中的 YOUR_MODEL_ID 替换为完整模型 ID;调用前确认端点支持和使用限制。
常见问题
提示 401 / 无效密钥?
检查 BOOK_API_KEY 是否已导出(test -n "$BOOK_API_KEY"),以及 Key 是否在控制台被停用或删除;改完环境变量需重开终端。
提示余额不足?
Key 与账户余额共用,到余额充值页充值或兑换后自动恢复。
429 / 限流?
短时间请求过于频繁会被限流保护,稍后自动恢复;生产环境建议做好退避重试。
修改配置后不生效?
Codex CLI 启动时读取配置,修改 config.toml 后需退出并重新启动会话。