HRouter

Codex JetBrains 配置教程

这篇教程适用于 IntelliJ IDEA、PyCharm、GoLand、WebStorm 等 JetBrains IDE。最稳妥的做法是先在命令行里配好 Codex，再直接在 IDE 自带的终端里运行 codex，这样直接复用 ~/.codex/config.toml 和 ~/.codex/auth.json，不依赖环境变量。

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

方式一：在 IDE 终端里直接使用（推荐）

  1. 打开 JetBrains IDE 和目标项目。
  2. 打开底部的 Terminal 面板。
  3. 运行：
codex

方式二：使用 JetBrains 里的 Codex 集成

如果你装了 Codex 相关插件或 AI 面板集成，先确认它是否复用了本机 Codex 配置。关键点只有四项：

  1. base_url = "https://hrouter.net/v1"
  2. wire_api = "responses"
  3. ~/.codex/auth.json 中已写入 OPENAI_API_KEY
  4. provider 的 name = "OpenAI"（精确大小写，开启远程压缩，详见 Codex 安装与配置）

推荐测试步骤

  1. 先在系统终端运行一次 codex。
  2. 再在 JetBrains 内置终端运行一次 codex。
  3. 最后再测试插件或面板集成。

最小测试内容：

请只回复：HRouter Codex 已连接

常见问题

系统终端正常，IDE 终端不正常？ 通常是 JetBrains 没读取到 ~/.codex/auth.json，确认路径和 JSON 格式无误。

插件里报找不到模型？ 先退回 CLI 检查 config.toml，并核对 model_not_found。

只有聊天能用，代理任务不能用？ 优先检查是否真的走了 Responses API，即 wire_api = "responses"。

请求失败？ 确认当前 Key 有 OpenAI 模型权限，见 API 403 报错。更多问题见 Codex 常见问题。