Codex CLI 自定义 API 设置

Codex 可以通过 TokenHub 的 OpenAI Responses 兼容接口接入。常用 Base URL 是 https://us-api.tokenhub.com/v1，Codex 会通过 provider 配置访问 https://us-api.tokenhub.com/v1/responses，API Key 使用 TokenHub 工作台创建的密钥。

适合场景

Codex 适合在终端里完成仓库阅读、代码修改、命令执行、测试修复和小型开发任务。建议先在 Git 工作区中使用，这样每次改动都能通过 diff 审阅。

安装 Codex

先参考 OpenAI Codex CLI 官方文档 或 openai/codex 仓库。常见安装方式如下：

# npm
npm install -g @openai/codex

# Homebrew
brew install codex

安装后确认命令可用：

codex --version

如果你在公司网络或 CI 环境中安装，优先使用官方文档中提供的包管理器或二进制安装方式。

准备 TokenHub 凭证

export TOKENHUB_API_KEY="sk-..."

选择模型时，使用 TokenHub 模型列表里的 Model ID，例如 gpt-4.1、gpt-4o 或你的工作区可用模型。

推荐方式：配置 TokenHub Provider

如果你的 Codex 版本支持 provider 配置，可以在 ~/.codex/config.toml 中加入 TokenHub：

model = "gpt-4.1"
model_provider = "tokenhub"

[model_providers.tokenhub]
name = "TokenHub"
base_url = "__API_BASE_URL__/v1"
env_key = "TOKENHUB_API_KEY"
wire_api = "responses"

Codex 官方配置参考中该 provider 使用 wire_api = "responses"。因此这里不要把它改成其它未确认的 wire API；如果请求失败，应在 TokenHub 中选择支持 https://us-api.tokenhub.com/v1/responses 的模型，或升级到支持 provider 配置的 Codex 版本。

这样做的好处是 Codex 每次启动都会读取同一个 provider，不依赖某个终端窗口里临时 export 的变量。env_key = "TOKENHUB_API_KEY" 表示密钥仍从本机环境或密钥管理工具读取，不把明文 Key 写进 config.toml。

环境变量验证

如果只是排查 Key 是否能被 Codex 读取，可以在当前终端临时设置 TOKENHUB_API_KEY，Base URL 和 wire API 仍以 ~/.codex/config.toml 为准：

export TOKENHUB_API_KEY="sk-..."
codex --model gpt-4.1

验证通过后，建议保留 provider 配置，并把密钥交给本机环境变量、密码管理器或团队密钥管理方案提供。

启动和常用命令

在项目目录中运行：

cd /path/to/your/repo
codex --model gpt-4.1

也可以直接给一次性任务：

codex --model gpt-4.1 "用一句话说明这个仓库的主要技术栈，不要修改文件"

验证

1. 先问只读问题，确认 Codex 能读项目并返回。
2. 在 TokenHub 请求日志中确认模型和接口路径。
3. 再让 Codex 修改一个低风险文件，例如 README 或测试。
4. 用 git diff 审阅改动，再决定是否继续授权更复杂任务。

故障排查