在 Coding Agent 接入

Codex VS Code 扩展：API 配置与官方登录

配置 Codex VS Code Extension 共享的 config.toml，使用 BetterToken Responses API，同时保留官方登录、插件和 Remote Control。

Codex VS Code Extension 与 Codex CLI/App 共用 ~/.codex/config.toml。如果你需要保留官方登录、插件或 Remote Control，请使用本页配置。

重点信息

字段	填写内容
API Key	`experimental_bearer_token = "YOUR_API_KEY"`
Base URL	`https://bettertoken.ai/v1`
Model	`gpt-6-astra`

准备工作

安装最新版 Codex VS Code Extension
先在 Extension 或 Codex App 中完成官方登录
创建 BetterToken API Key
从模型广场或 Key 的 Setup 弹窗复制 Model ID

安装

从 VS Code Marketplace 安装扩展，然后重启 VS Code。

手动配置

如果设置了自定义 CODEX_HOME，请编辑该目录中的 config.toml。否则，macOS / Linux 使用 ~/.codex/config.toml，Windows 使用 %USERPROFILE%\.codex\config.toml。

完全退出 Codex，然后备份现有的 config.toml 和 auth.json。更新已有的 provider 设置，不要重复添加同名 provider table。

配置 Extension

编辑 ~/.codex/config.toml：

model_provider = "bettertoken"
model = "gpt-6-astra"

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "YOUR_API_KEY"
supports_websockets = false

配置参数

参数	作用与位置	默认行为与示例
`model_provider`	用户配置顶层；选择下方定义的配置 ID。	默认 `openai`；本页使用 `bettertoken`。
`model`	顶层；模型广场中的完整 Model ID。	示例 `gpt-6-astra`，按需要替换。
`name`	provider 表内；仅用于显示的名称。	`BetterToken` 不是模型 ID。
`base_url`	provider 表内；模型 API 的 Base URL。	使用 `https://bettertoken.ai/v1`；Codex 自行添加 `/responses`。
`wire_api`	provider 表内；请求协议。	当前仅支持 `responses`，省略时也是该值。
`requires_openai_auth`	provider 表内；使用 OpenAI 认证流程及凭据存储。	默认 `false`；本页使用 `true`。它不是保留登录文件的开关。
`experimental_bearer_token`	provider 表内；第三方请求的 Bearer Key。	填 BetterToken API Key；它不改写官方登录缓存。以明文保存；OpenAI 不建议使用此字段。
`supports_websockets`	provider 表内；Responses WebSocket 支持。	默认 `false`；本页保持 HTTP/SSE 传输。

保留官方登录生成的凭据，不要改成 API Key JSON。requires_openai_auth = true 使用官方认证流程；模型请求由当前 provider 的 experimental_bearer_token 提供第三方 Key。启用前者时 env_key 会被忽略，因此不要直接用它替换 Bearer Key。不要分享包含 Key 的配置文件。

其他凭据配置方式见 OpenAI 的环境变量与命令认证说明。这些属于独立认证模式：不要在 provider 中将 auth 表与 env_key、experimental_bearer_token 或 requires_openai_auth 并用，也不要在本例保留官方登录的配置中改用 env_key。

配置层级与旧参数

模型和推理设置不要写入 [projects."<path>"]。项目专属模型可以放在受信任项目的 .codex/config.toml 顶层，但 provider 与认证配置仍放在用户配置。新版命名 profile 使用 CODEX_HOME 下的 NAME.config.toml，通过 codex --profile NAME 选择，不使用旧的 [profiles.NAME] 或顶层 profile 选择器。

保存后在 VS Code 中执行 Developer: Reload Window，然后重新打开 Codex 面板。

验证连接

在 Extension 中新建会话并发送一条短任务。能够调用 gpt-6-astra 返回内容，同时插件和 Remote Control 仍可使用，即表示配置成功。

切换模型

修改 model 和可选的 review_model，保存后执行 Developer: Reload Window。Model ID 必须来自 Setup 弹窗或模型广场。

常见错误

错误	处理方式
Extension 要求重新登录	先恢复官方登录，再确认 `requires_openai_auth = true`。
`401` 或 `403`	重新复制 `experimental_bearer_token`，不要改写 `auth.json`。
Duplicate table	删除另一套 `[model_providers.bettertoken]`，只保留当前场景的配置。
模型不存在	用当前完整 Model ID 替换 `gpt-6-astra`。
配置未生效	保存文件并执行 Developer: Reload Window。

进阶配置

官方参考

技术说明

Responses 协议

Extension 通过 OpenAI Responses 向 https://bettertoken.ai/v1 发送模型请求。