Codex 配置教程

先确认 CLI 的原生 Responses 配置

进入 apizt 控制台 → API 令牌 → 新建，选择支持目标模型及协议的分组，设置额度后复制令牌。已有令牌可继续使用；模型目录和权限不是同一回事。查看创建分组令牌的图文步骤。

合并到用户级 ~/.codex/config.toml；provider 键放在项目级配置会被忽略。env_key 是变量名，不能直接写令牌。

model_provider = "apizt"
model = "gpt-6-sol"

[model_providers.apizt]
name = "apizt"
base_url = "https://api.apizt.com/v1"
wire_api = "responses"
env_key = "tokenba_API_KEY"

export tokenba_API_KEY="YOUR_tokenba_API_KEY"
codex --version
codex exec --skip-git-repo-check --sandbox read-only "Reply exactly tokenba_OK. Do not use tools."

PowerShell 用 $env:tokenba_API_KEY = "YOUR_tokenba_API_KEY"。在同一终端启动；Dock 启动的桌面程序不一定继承这个变量。原生协议目标是 /v1/responses；只支持 Chat 的上游需另按 CC Switch 协议路由配置。

Codex 是 OpenAI 推出的 AI 编程助手。通过 apizt API 接入，国内开发者可以快速使用 Codex 进行 AI 辅助编程。

node --version
npm --version

npm install -g @openai/codex

model_provider = "apizt"
model = "gpt-6-sol"

[model_providers.apizt]
name = "apizt"
base_url = "https://api.apizt.com/v1"
wire_api = "responses"
env_key = "tokenba_API_KEY"

$env:tokenba_API_KEY = "你的 apizt API Key"

mkdir my-codex-project
cd my-codex-project

codex

brew install node

npm install -g @openai/codex

model_provider = "apizt"
model = "gpt-6-sol"

[model_providers.apizt]
name = "apizt"
base_url = "https://api.apizt.com/v1"
wire_api = "responses"
env_key = "tokenba_API_KEY"

export tokenba_API_KEY="你的 apizt API Key"

mkdir my-codex-project
cd my-codex-project

codex

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

npm install -g @openai/codex

model_provider = "apizt"
model = "gpt-6-sol"

[model_providers.apizt]
name = "apizt"
base_url = "https://api.apizt.com/v1"
wire_api = "responses"
env_key = "tokenba_API_KEY"

export tokenba_API_KEY="你的 apizt API Key"

mkdir my-codex-project
cd my-codex-project

codex

VSCode 插件

在 VSCode 扩展商店中搜索并安装 Codex 即可使用。

常见问题

API Key 配置确认

• 按预算设置令牌额度上限
• 仅放行准备使用的模型
• 选择当前控制台中支持 Responses 与目标模型的分组；分组名称以实际页面为准。

合并配置时注意

将 gpt-6-sol 替换为实际可用模型。不要把 API Key 写入 env_key，也不要把配置示例覆盖到已有整份文件；保留原有项目、MCP 和权限设置。环境变量应在启动 Codex 的同一终端中设置，仅影响该终端及其子进程。

真实调用记录与验证范围

测试日期：2026-09-28（Asia/Shanghai）；macOS 26.3。查看脱敏记录、软件版本和真实生成图片。一次文本成功仅证明本次请求，不代表其他模型、工具执行、多轮上下文或桌面版均已通过。

Codex CLI 0.158.0-alpha.2.1
provider: apizt
model: gpt-6-sol
{"type":"item.completed","item":{"type":"agent_message","text":"tokenba_OK"}}
{"type":"turn.completed","usage":{"input_tokens":20673,"cached_input_tokens":3840,"output_tokens":10}}

本次通过命令行覆盖同名配置，使用 --ignore-user-config --ephemeral，保留用户原配置；日常使用按上方用户配置即可。

解析报错、provider 未找到、环境变量未生效：Codex 配置错误定位与复验。