Codex JetBrains

Codex JetBrains 使用教程。

当前建议分组：AppCodex 当前建议模型：gpt-5.5

在阅读本页之前，请先完成你所在系统的 Codex CLI 配置，并确认在终端里直接运行 codex 没有问题。

(一) 安装 JetBrains IDE

适用于 IntelliJ IDEA、PyCharm、GoLand、WebStorm 等 JetBrains IDE。

(二) 最稳妥的使用方式

Codex 在 JetBrains 里最稳妥的使用方式，是直接打开 IDE 自带终端并运行：

1codex

这样可以直接复用你已经配置好的：

  • ~/.codex/config.toml
  • ~/.codex/auth.json（Key 存放在这里，不依赖环境变量）

(三) 如果你使用 JetBrains 里的 Codex 相关集成

如果你装了 Codex 相关插件或 AI 面板集成，优先确认它是否复用了本机 Codex 配置。

关键点仍然只有三项：

  1. base_url = "https://4router.net/v1"
  2. wire_api = "responses"
  3. ~/.codex/auth.json 中已写入 OPENAI_API_KEY

(四) 推荐测试步骤

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

最小测试内容：

1Print a short hello from the AppCodex group on 4Router.

(五) 常见问题

  • 系统终端正常，IDE 终端不正常：通常是 JetBrains 没读取到 ~/.codex/auth.json，确认路径和 JSON 格式无误。
  • 插件里报找不到模型：先退回 CLI 检查 config.toml。
  • 只有聊天能用，代理任务不能用：优先检查是否真的走了 Responses API。
  • 请求失败：先去控制台确认当前令牌能否使用 AppCodex 分组。