Codex

Codex CLI 是 OpenAI 官方的终端编程代理。TokenByte 的 OpenAI 兼容端点可直接替代官方地址，推荐通过 ~/.codex/config.toml + 环境变量的方式持久化配置。

前置条件

Node.js 20 及以上（下载）
Windows 建议同时安装 Git；macOS / Linux 可免装
已在 TokenByte 控制台创建 API Key

配置

安装 Codex CLI

sudo npm install -g @openai/codex

在 CMD 或 PowerShell 中运行：

npm install -g @openai/codex

验证安装

codex --version

输出形如 codex-cli 0.41.0 即安装成功。

配置 TokenByte 接入

在用户主目录下的 .codex 文件夹中创建 config.toml：

model_provider = "tokenbyte"
model = "gpt-5-codex"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.tokenbyte]
name = "tokenbyte"
base_url = "https://api.tokenbyte.ai/v1"
wire_api = "responses"
env_key = "TOKENBYTE_API_KEY"

然后将 API Key 写入系统环境变量 TOKENBYTE_API_KEY：

echo 'export TOKENBYTE_API_KEY="sk-tb-xxxxxxxxxxxxxxxx"' >> ~/.zshrc
source ~/.zshrc

setx TOKENBYTE_API_KEY "sk-tb-xxxxxxxxxxxxxxxx"

修改后需重启终端才会生效。

Windows 用户目录下若无 .codex 文件夹，需手动创建。资源管理器默认隐藏以 . 开头的目录，可在 查看 → 显示 → 隐藏的项目 中打开显示，或直接用 mkdir 新建。

启动并测试

在任意项目目录下运行：

codex

出现欢迎界面后，输入一句话即可验证：

你好，帮我看看这段代码

若能返回模型回复，说明已接入 TokenByte。

VS Code 插件（可选）

终端侧验证无误后，再连接 VS Code 插件，可减少排错范围。

在扩展市场搜索 Codex，只安装带有 OpenAI 官方认证标识的那一款，避免同名第三方扩展。
插件会自动读取 ~/.codex/config.toml 与环境变量，无需在 VS Code 中重复填写。

如果终端里 codex 还没跑通，直接装插件通常会因为环境变量或配置路径问题报错，优先回到终端定位。

遇到问题？参考常见问题。