~/.codex/config.toml。如果你需要保留官方登录、插件或 Remote Control，请使用本页配置。
重点信息
准备工作
- 安装最新版 Codex VS Code Extension
- 先在 Extension 或 Codex App 中完成官方登录
- 创建 BetterToken API Key
- 从模型广场或 Key 的 Setup 弹窗复制 Model ID
安装
从 VS Code Marketplace 安装扩展，然后重启 VS Code。手动配置
配置 Extension
编辑~/.codex/config.toml：
requires_openai_auth = true 保留官方登录态；experimental_bearer_token 用于 BetterToken 模型请求。不要把 BetterToken API Key 写入 auth.json。CLI/App 与 Extension 配置不能混用
两种方案都使用
[model_providers.custom]。同一个 TOML 文件中只能保留其中一套，不要重复声明同名 table。
验证连接
在 Extension 中新建会话并发送一条短任务。能够调用YOUR_MODEL_ID 返回内容，同时插件和 Remote Control 仍可使用，即表示配置成功。
切换模型
修改model 和可选的 review_model，保存后执行 Developer: Reload Window。Model ID 必须来自 Setup 弹窗或模型广场。
常见错误
进阶配置
支持的提供商
状态仅针对本页介绍的 BetterToken 接入方式。
配置方式说明
配置方式说明
- 手动配置：填写 API Key、Base URL 和 Model。
- 不支持：当前没有经过验证的直接配置方式。
相关指南
- Codex CLI/App 自定义 provider
- 使用第三方 API 时保留 Codex 官方登录
- Codex config.toml 配置指南
- model_provider、base_url 和 wire_api 是什么？
官方参考
技术说明
为什么 Extension 的鉴权与 CLI/App 不同
为什么 Extension 的鉴权与 CLI/App 不同
Extension 需要官方登录来启用部分 Codex 产品能力，所以本场景保留
requires_openai_auth = true。纯 CLI/App 自定义 provider 不需要官方登录，使用环境变量和 requires_openai_auth = false。两种配置都通过 OpenAI Responses 请求 https://bettertoken.ai/v1。