HRouter

Codex VSCode 插件配置教程

这篇教程说明如何在 VSCode 里使用 Codex 扩展并接到 HRouter。扩展通常会复用本机的 ~/.codex/config.toml 和 auth.json，所以要先在命令行里配好。

前提：已经按 Codex 安装与配置 完成命令行配置，并确认在终端里直接运行 codex 没有问题。也可以先用 HRouter Desktop 一键写入配置。

第 1 步：安装 VSCode

打开 https://code.visualstudio.com/，安装 VSCode 1.75.2 或更新版本。

第 2 步：安装 Codex 扩展

打开 VSCode 扩展市场，搜索 Codex，安装后重启 VSCode。

第 3 步：确认本地配置

确认 ~/.codex/config.toml（Windows 是 C:\Users\你的用户名\.codex\config.toml）至少包含：

model_provider = "hrouter"
model = "gpt-5.6-sol"
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.hrouter]
name = "OpenAI"
base_url = "https://hrouter.net/v1"
requires_openai_auth = true
wire_api = "responses"

name = "OpenAI" 必须一字不差（大写 O、大写 A），这是开启远程压缩（长对话自动压缩上下文）的开关。详见 Codex 安装与配置。

然后确认 ~/.codex/auth.json 中已写入 Key：

{
  "OPENAI_API_KEY": "sk-xxxxx"
}

第 4 步：开始使用

  1. 打开项目目录。
  2. 启动 Codex 扩展。
  3. 发送一个最短测试任务：
请只回复：HRouter Codex 已连接

收到回复，并且在 使用记录 里能看到请求，就接好了。

常见问题

扩展里打不开会话？ 先确认终端里的 codex 是否正常，见 Codex 常见问题。

模型找不到？ 回头检查 config.toml 中的模型名，并确认它在当前 Key 的模型列表里，见 model_not_found。

请求走错接口？ 确认 wire_api = "responses" 没有被改掉，base_url 是 https://hrouter.net/v1。

请求失败？ 确认当前 Key 有 OpenAI 模型权限，见 API 403 报错。

配置似乎被忽略？ 见 配置不生效怎么排查。