跳到主要内容

JetBrains 外接配置

适用于在 JetBrains 系列 IDE 中外接 Claude / Codex 的场景。推荐先完成CC Switch 统一配置，再在 IDE 侧接入。

适用场景​

  • 想在 JetBrains 中直接调用 Claude 或 Codex
  • 本机已经配置过 Claude Code / Codex CLI，希望 IDE 直接复用
  • 使用支持读取本机环境或 CC Switch 配置的桥接工具

推荐接入思路​

JetBrains 外接优先遵循这条路径：

  1. 先在本机用 CC Switch 配好 Claude Code 或 Codex
  2. 在 JetBrains 中安装对应的官方插件或兼容桥接工具
  3. 如果工具支持自动读取本机已有环境，优先使用自动识别
  4. 如果工具要求手动填写，再补 Base URL、Key、模型等字段

这样做的好处是：

  • 不用在 IDE 里重复维护多套 Key
  • 切换渠道时仍以 CC Switch 为主
  • Claude / Codex 的本地配置与 IDE 配置更容易保持一致

配置步骤​

第一步：先确认本机环境可用​

至少先保证以下其中一种已经可正常运行：

claude --version
codex --version

如果本机还没配好，先看：

第二步：安装 IDE 侧插件或桥接工具​

常见做法有两类：

  • 直接安装官方 Claude / Codex 插件
  • 安装支持读取本机 Claude / Codex 环境的桥接工具

部分 JetBrains 方案还需要额外安装 Codex SDK 或启用对应授权项，才能在 IDE 中正常调用 Codex。

第三步：优先复用已有配置​

如果当前方案支持读取：

  • ~/.claude/
  • ~/.claude.json
  • ~/.codex/config.toml
  • ~/.codex/auth.json

那么优先走自动识别，不建议手工再抄一套配置。

第四步：手动填写时只补关键字段​

如果 IDE 侧必须手填，按目标模型类型选择：

模型类型Base URL模型填写建议
Claudehttps://duoapi.zeabur.app按插件要求留空或填 Claude 模型名
Codexhttps://duoapi.zeabur.app/v1推荐gpt-5.4

如果插件支持自定义 Header，再参考外接调用 User-Agent 说明补齐对应User-Agent。

常见问题​

IDE 里能看到插件，但调用报 401​

优先检查：

  1. IDE 是否读取到了旧的本地认证状态
  2. 你的 Key 是否已切到正确分组
  3. 插件是否覆盖了本机配置

相关页面：

Codex 在 IDE 里不可用​

优先检查：

  1. 是否安装了对应 Codex 组件或 SDK
  2. Base URL 是否带了/v1
  3. model是否填写为可用 GPT / Codex 模型

本机 CLI 可用，但 IDE 不可用​

这通常说明问题不在 Key，而在 IDE 侧配置本身。 优先排查 IDE 是否：

  • 读取了错误配置文件
  • 没有带出请求头
  • 对本地代理或证书有额外限制

相关页面​

页面用途
外接兼容与接入说明统一规则总览
外接调用 User-Agent 说明Header 示例
Claude Code 配置参考Claude 侧配置与排障
Codex CLI 配置参考Codex 侧配置与排障