VS Code 中使用 Codex 插件

更新于 2026-09-27

适用范围：Codex IDE 扩展共享 ~/.codex/config.toml，并使用自定义 provider 的 env_key 凭据。

版本与验证：2026-09-28 核对本文配置项、步骤和资料入口，补齐验证与排错说明。未在真实账号中验证付费模型调用。

配置速查

配置项	填写内容	注意事项
model_provider	`apizt`	指向下面定义的 provider。
base_url	`https://api.apizt.com/v1`	Responses 基础地址。
wire_api	`responses`	当前 Codex provider 协议。
env_key	`tokenba_API_KEY`	值为环境变量名称，不是密钥正文。
model	`gpt-6-sol`	须支持 Responses 与目标任务。

还没有 API Key？注册获取免费体验额度 · 已注册：进入控制台创建 API Key

为此工具单独创建令牌，并设置合理额度和模型权限。截图中的模型仅作示例，以账号当前可用模型为准；不要公开密钥或上传含密钥的配置文件。

第 1 步：安装官方扩展

在 VS Code 扩展市场按官方页面找到 Codex 并安装。打开本地项目；第三方 provider 是否可用还取决于所选模型的 Responses 与工具支持，不能把网关全部模型都视为 Codex 可用模型。

第 2 步：合并 provider 配置

编辑当前用户的 ~/.codex/config.toml。顶层的 model_provider、model 放在任何表声明之前；已有同名字段或表应修改原项，避免重复定义。项目级配置也可能覆盖用户配置。

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"

第 3 步：让扩展进程读取凭据

env_key 的值是环境变量名称，不是密钥正文。先完全退出现有 VS Code，再从设置了变量的终端启动项目，确保新进程继承变量。macOS/Linux：

export tokenba_API_KEY="YOUR_tokenba_API_KEY"
code .

Windows PowerShell：

$env:tokenba_API_KEY = "YOUR_tokenba_API_KEY"
code .

仅在已经打开的集成终端设置变量，不能保证父级扩展进程读到。若 code 命令尚未安装，先按 VS Code 的平台安装说明配置命令行入口。

第 4 步：区分自定义凭据与登录入口

此 provider 通过 tokenba_API_KEY 读取凭据。扩展界面的 ChatGPT 登录或默认 API Key 输入框，不能据此保证会写入自定义 env_key。以当前官方扩展支持的 provider 设置与进程环境为准。

第 5 步：重开会话并验证

打开 Codex 新会话，确认目标模型是 gpt-6-sol。先问短问题，再让它读取 README。核对网关收到 Responses 请求；只支持 Chat Completions 的模型不能直接用于此配置。

在 VS Code 扩展市场安装 Codex — 历史版本界面参考；配置值与步骤以本文文字和所装版本为准。点击图片可页内放大。

编辑 Codex 设置 — 历史版本界面参考；配置值与步骤以本文文字和所装版本为准。点击图片可页内放大。

在 config.toml 顶部添加 apizt 配置 — 历史版本界面参考；配置值与步骤以本文文字和所装版本为准。点击图片可页内放大。

选择使用 API 密钥登录 — 历史版本界面参考；配置值与步骤以本文文字和所装版本为准。点击图片可页内放大。

填入 apizt API Key — 历史版本界面参考；配置值与步骤以本文文字和所装版本为准。点击图片可页内放大。

连接失败时按这几步排查

VS Code 本身没有统一的模型 Base URL。Claude Code 扩展使用 Anthropic Messages；Codex 使用 Responses；Continue、Kilo Code 按各自 provider 协议配置。

先在扩展列表确认名称、发布者与版本，明确是 Claude Code、Codex、Continue 还是 Kilo Code；不要将四者的设置互相粘贴。
检查扩展运行在本机、WSL、SSH 还是 Dev Container。在实际扩展宿主环境配置凭据和地址。
从正确环境启动新 VS Code 进程，或按扩展说明重载；仅在集成终端设置变量，不保证父级扩展宿主继承。

容易混淆的情况

Claude Code 和 Codex 的订阅登录、默认 Key 登录与自定义网关配置是不同入口，需核对实际 provider。
同一项目在本机可用而 SSH 窗口失败时，先查远程网络、远程配置和进程环境。

怎样确认修复成功

在目标窗口打开扩展的新会话，记录扩展名称、版本、运行位置和实际回答；需要读文件时单独验证工作区权限。

记录所装客户端版本、模型 ID、请求时间、最终路径与脱敏状态。本节为配置核对指南，未新增客户端付费调用实测；保留原文已有验证记录的适用范围。

打开 VS Code 交互排错并下载检查记录 · 官方配置参考

怎样确认配置已生效

IDE 扩展读取自定义提供商和目标模型。
扩展进程能读取所指定的环境变量。
短消息正常回复，再验证文件读取。

接入失败时逐项检查

现象	检查与处理
Missing environment variable	从已设置变量的终端启动 VS Code，完全关闭旧进程后重新启动。
仍请求默认提供商	检查用户级与项目级配置覆盖，核对 model_provider。
协议错误	需要 Responses 接口；不能只把 Chat Completions 模型 ID 填入后保证可用。

资料与下一步

遇到问题时保留软件版本、请求时间、模型 ID、错误码和请求 ID，联系支持时先隐藏 API Key。