VS Code 中的 Codex 插件本身不需要单独填写一套 Base URL 和 API Key。它会读取本机 Codex 配置,因此你需要在 Codex 的 config.toml 中配置 LLMEasy provider。
如果你在 VS Code 设置里没有看到 Base URL 或 API Key 输入框,这是正常的。VS Code Codex 插件的模型请求配置应通过 Codex 本地配置完成。
前置条件
- 已安装 VS Code
- 已安装 Codex - OpenAI’s coding agent 插件
- 已获取 LLMEasy API Key(注册并获取)
- 已从模型广场复制 GPT 分组下可用的模型 ID
不要把 API Key 写进项目文件、AGENTS.md、.env 示例文件或公开仓库。下面的配置只应保存在你本机的 Codex 配置目录中。
配置方式
创建 API Key 后,控制台会弹出 Setup 弹窗。你可以在弹窗中复制 API Key 和 Base URL,并选择 Codex 相关配置方式。选择 Codex
在 Available tools 中选择 Codex。
选择配置方式
你可以选择:
- One-click Bash Configuration:复制命令到本机终端执行,适合快速配置。
- CC Switch Integration:导入到 CC Switch,适合统一管理多个工具。
- Manual Configuration:复制 API Key 和 Base URL,手动写入
config.toml。
重启 VS Code
配置写入后,重启 VS Code,或执行 Developer: Reload Window,让 Codex 插件重新读取本机配置。
找到 config.toml
Codex 的配置文件通常位于:| 系统 | 配置文件 |
|---|
| macOS / Linux | ~/.codex/config.toml |
| Windows | C:\Users\YOUR_USER\.codex\config.toml |
| Windows + WSL | WSL 内的 ~/.codex/config.toml |
如果文件不存在,可以手动新建。 写入 LLMEasy provider
将下面配置添加到 config.toml。如果文件中已经有同名字段,请合并配置,不要重复写多个 model_provider。model_provider = "custom"
model = "gpt-5.5"
review_model = "gpt-5.4"
model_reasoning_effort = "high"
model_context_window = 1000000
model_auto_compact_token_limit = 900000
windows_wsl_setup_acknowledged = true
[model_providers]
[model_providers.custom]
name = "LLM Easy"
base_url = "https://www.llmeasy.ru/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "YOUR_API_KEY"
request_max_retries = 4
stream_max_retries = 8
stream_idle_timeout_ms = 300000
supports_websockets = false
将 YOUR_API_KEY 替换为你的 LLMEasy API Key。 确认关键字段
重点检查这几项:| 字段 | 应填写 |
|---|
base_url | https://www.llmeasy.ru/v1 |
wire_api | responses |
model | 从 GPT 分组复制的模型 ID |
experimental_bearer_token | 你的 LLMEasy API Key |
VS Code Codex 插件场景下,不建议把 auth.json 改成 API Key 结构。auth.json 用于保留 Codex 官方登录态;第三方 API Key 应放在 experimental_bearer_token 中。
重启 VS Code
修改完成后,关闭当前 Codex 会话,并重启 VS Code。也可以在命令面板执行:
为什么这里要保留官方登录态?
VS Code Codex 插件依赖 Codex 的应用侧能力,例如插件界面、会话管理和 VS Code 集成。因此推荐保留官方登录态,同时让模型请求走 LLMEasy。
这组配置中:
| 配置 | 作用 |
|---|
requires_openai_auth = true | 保留 Codex 官方登录态 |
experimental_bearer_token = "YOUR_API_KEY" | 使用 LLMEasy API Key 发起模型请求 |
base_url = "https://www.llmeasy.ru/v1" | 将模型请求发送到 LLMEasy 的 OpenAI-compatible / Responses API 入口 |
验证配置
完成配置后,在 VS Code 中打开 Codex 插件,发送一条简单测试消息。
如果能正常回复,说明配置已生效。
如果请求失败,按顺序检查:
base_url 是否为 https://www.llmeasy.ru/v1
wire_api 是否为 responses
experimental_bearer_token 是否已替换为你的真实 API Key
model 是否来自模型广场的 GPT 分组
- 是否存在旧的
OPENAI_API_KEY 或 OPENAI_BASE_URL 环境变量覆盖了配置
- VS Code 是否已重启或 Reload Window
相关文档