JetBrains IDE 集成

在 IntelliJ IDEA、WebStorm、PyCharm、GoLand 等 JetBrains IDE 中通过 QCode 使用 Claude Code

需要 API Key？ 前往注册 →·端点与 Base URL →

最后核实：2026-09-18 · 📄 依据官方文档（Claude Code JetBrains 插件 0.1.14-beta（Marketplace，要求 IDE ≥2024.2））

接入速览¶

Claude Code 提供官方 JetBrains 插件。官方文档点名的是 6 款（含 Android Studio，且要求 Ladybug 2024.2.1 或更新；JetBrains MPS 另要求 2024.3+），Marketplace 的兼容列表还列着 RubyMine、CLion、Rider、DataGrip 等其它 IntelliJ 系 IDE——所以「凡是 IntelliJ 平台的 IDE 都行」这句我们不做保证，装之前在你那个 IDE 的 Marketplace 页面里确认一次。本文介绍如何安装插件，并将其指向 QCode 网关，从而以更低成本调用 Claude Opus 5、Sonnet 5 等旗舰模型。

插件与命令行版本共享同一套配置：只要你的 claude CLI 能连上 QCode，IDE 插件也就能用。

前提条件¶

1. Claude Code CLI 已安装并可正常使用（用 claude --version 确认，不要对照文档里过期的数字）

2. 参考 安装教程 完成安装

3. 参考 环境变量配置 完成 QCode API 配置

4. 在终端运行 claude --version 确认可用

5. JetBrains IDE 2024.2 或更高版本（Marketplace 上该插件的兼容下限是 build 242.0，也就是 2024.2；2024.1 会直接显示不兼容）

6. 一个 QCode API Key（以 cr_ 开头），同一个 Key 适用于全部接入点

安装步骤¶

步骤 1：安装 Claude Code 插件¶

1. 打开 JetBrains IDE

2. 进入 Settings / Preferences → Plugins → Marketplace

3. 搜索 Claude Code [Beta]——这是它在 Marketplace 上的正式名称（发布者 Anthropic PBC，xmlId com.anthropic.code.plugin）。⚠️ 只搜 "Claude Code" 会先冒出一批第三方同名插件，认准发布者再点安装

4. 点击 Install

5. 重启 IDE

提示：若你的网络无法直接访问 JetBrains Marketplace，可以从插件主页下载 .zip 包，再通过 Plugins → 齿轮图标 → Install Plugin from Disk... 离线安装。具体以 JetBrains 官方文档为准。

步骤 2：配置 QCode 接入¶

插件复用 Claude Code CLI 的配置，核心是两个环境变量：

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_api_key"

中国大陆用户：把 api.qcode.cc 换成 asia.qcode.cc 通常是更合适的选择：

bash export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"

三个域名 api / asia / us 共用同一个 API Key，可按所在地区择优选择。BASE_URL 结尾不要带斜杠。

提示：JetBrains IDE 会继承系统环境变量。如果你已在 ~/.zshrc 或 ~/.bashrc 中配置过，IDE 启动后会自动读取——前提是 IDE 是从已加载该配置的环境中启动的（见下方常见问题）。

如果你不想依赖全局环境变量，也可以只为单个项目设置（见 常见问题）。

步骤 3：验证¶

1. 在 IDE 中按 Cmd+Esc（macOS）或 Ctrl+Esc（Windows/Linux）打开 Claude Code 面板

2. 输入一条简单消息（例如「你好」）测试连接

3. 若返回正常回复，说明插件已成功通过 QCode 连接

你也可以直接用 curl 验证网关本身可达（返回 401 表示路径正确、只是缺少鉴权，属于预期）：

curl -i https://api.qcode.cc/api/v1/messages
# HTTP/2 401  ← 路径正确，符合预期

使用方法¶

快捷键¶

实际快捷键以插件版本与你的 Keymap 为准，可在 Settings → Keymap 中搜索 "Claude" 自定义。

核心能力¶

1. 代码解释：选中代码 → 右键 → Ask Claude，让它解释这段逻辑

2. 代码生成：在 Claude 面板中用自然语言描述需求，让它生成或修改代码

3. 错误修复：把异常堆栈或报错信息发给 Claude 分析并给出修复

4. 代码重构：选中目标代码，请求 Claude 优化结构、提取函数或补充测试

原生 Diff 视图¶

插件与 JetBrains 深度集成：当 Claude 提议修改文件时，会以 IDE 原生的并排 Diff 视图展示改动，你可以逐处审阅、接受或拒绝，再写入磁盘。这比纯终端的 diff 更直观，也更安全。

与内置终端配合¶

JetBrains IDE 内置的 Terminal 也可以直接运行 claude 命令，与 CLI 功能完全一致。插件会自动把 IDE 当前打开的文件、选区作为上下文传给 CLI，二者协同使用体验最佳。

图像输入（视觉能力）¶

支持视觉的模型（Claude Opus 5 / Sonnet 5 以及 GPT-5.x 系列）可以读取图片作为输入：

• 把截图直接粘贴（Ctrl+V）到 Claude 面板
• 拖拽图片文件到对话框
• 在提示中引用图片文件路径

典型用途：根据设计稿/截图还原界面、根据报错截图排障、解读架构图与图表。

这是图像输入，不是图像生成。若要让模型生成图片，请使用 gpt-image-2 模型，详见 gpt-image-2 图像生成。

模型选择¶

在 Claude 面板中可通过 /model 命令切换模型；不同模型经由 QCode 同一个 Key 调用。常用选择：

单价不在本页复制——以 qcode.cc/models 实时显示为准（管理员可调费率）。

QCode 也支持 GPT 系模型（如 gpt-6-sol、gpt-5.6-terra；QCode 暂不提供 Gemini），但 JetBrains 的 Claude Code 插件主要面向 Anthropic 协议；GPT 更适合在 Codex 等对应工具中使用。单价以 qcode.cc/models 为准。claude-sonnet-4-6 / claude-opus-4-8 等 4.x 仍在售。

高级用法¶

• 动态工作流（Dynamic Workflows）：在提示中包含关键字 ultracode 或直接说「运行一个 workflow」，即可编排数十到数百个后台子代理并行处理大型任务（全仓代码审查、批量迁移、跨文件调研等）。子代理在后台运行，你可继续工作，用 /workflows 命令查看进度。它运行在 Claude Code 当前配置的模型上——指向 QCode 时同样生效。参见 子代理。

• 无头 / 自动化：在 IDE 终端里同样可以用 claude -p "<提示>" 配合 --output-format json|text|stream-json 做脚本化调用，json 返回包含 result、total_cost_usd、usage、session_id 的结构化对象，便于 jq 解析。详见 自动化与 CI/CD。

插件自己的设置页¶

插件有独立的设置页：Settings → Tools → Claude Code [Beta]。官方列出的项包括：

• Claude command：指定插件用哪个命令启动 Claude Code，例如 claude、/usr/local/bin/claude、npx @anthropic-ai/claude-code。IDE 找不到 claude 时，官方给的正规兜底就是在这里填绝对路径，不必再去改 shell 启动方式
• Suppress notification for when Claude Command is not found：关掉「找不到 claude 命令」的提示
• Enable using Option+Enter for multi-line prompts：仅 macOS，多行输入的换行键
• Enable automatic updates：自动检查并安装插件更新（重启后生效）

从外部终端接进 IDE：/ide¶

官方文档写明：在任意外部终端里运行 Claude Code 后用 /ide 命令，即可把它接到正在运行的 JetBrains IDE 并启用全部功能。连接成功时 Claude Code 会回一句类似 Connected to IntelliJ IDEA. 的确认；如果它检测到 IDE 里没装插件，/ide 会代你安装并要求重启 IDE。

用 QCode 时这条路径同样成立——外部终端里的 claude 用的就是你配好的 ANTHROPIC_BASE_URL。

JetBrains 远程开发：插件要装在远端¶

官方明确要求：使用 JetBrains Remote Development 时，插件必须装在远端主机上，走 Settings → Plugins → Plugin (Host)，装在本机客户端上无效。

JetBrains AI Assistant 与 Claude Code 插件是两回事¶

本页讲的是 Claude Code 插件（底层是你自己的 claude CLI，Anthropic 协议，Base URL 由环境变量决定）。JetBrains 的另一款产品 AI Assistant 也能挂第三方模型，但入口不同：设置路径是 Settings | Tools | AI Assistant | Providers & API keys，而且按官方文档，只有 "OpenAI-compatible" 这一类提供 URL 输入框，Anthropic 与 Gemini API key 那两类只有密钥栏。所以：

AI Assistant 里的 API Completion（行内补全 / next edit）同样只支持 "OpenAI Compatible" 端点，并且官方提醒：行内补全需要模型支持 Fill-in-the-Middle，通用对话模型通常不具备，因此不适合当补全模型用。

常见问题¶

插件不显示 Claude Code 面板？¶

1. 确认插件已安装并启用（Settings → Plugins → Installed）

2. 确认 Claude Code CLI 已全局安装：终端运行 claude --version，应打出版本号（以 官方 Releases 为准）

3. 确认 IDE 版本 ≥ 2024.2

4. 重启 IDE；必要时执行 File → Invalidate Caches / Restart

Esc 中断不了当前生成？¶

官方排障条目：JetBrains 的终端里 Esc 被 IDE 抢去做「切换焦点到编辑器」了。处理：Settings → Tools → Terminal，二选一——取消勾选 "Move focus to the editor with Escape"，或点 "Configure terminal keybindings" 删掉 "Switch focus to Editor" 这个快捷键。

环境变量未生效？¶

JetBrains IDE 可能未读取到 shell 配置文件中的环境变量（GUI 启动的进程往往不加载 ~/.zshrc）。解决方法：

• macOS：从终端启动 IDE（如 open -a "IntelliJ IDEA"），而非从 Dock 点击；或使用 Tools → Create Command-line Launcher 后从终端启动

• 所有平台：在 IDE 的 Run/Debug Configurations → Environment variables 中手动添加 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN

• 持久化：通过 JetBrains Toolbox 或 *.vmoptions / 系统级环境变量设置，确保每次启动都能读到

认证失败 / 401 / 403？¶

1. 检查 ANTHROPIC_AUTH_TOKEN 是否为有效的、以 cr_ 开头的 QCode Key，且没有多余空格或引号

2. 确认 ANTHROPIC_BASE_URL 结尾没有斜杠，且路径为 /api（Anthropic 协议）

3. 直接 curl -i https://api.qcode.cc/api/v1/messages：返回 401 表示网关可达（仅缺鉴权），返回连接错误则是网络/代理问题

连接超时 / 公司代理后无法访问？¶

• 大陆用户优先切换到 asia.qcode.cc

• 若处于企业代理后，确认 IDE 的 Settings → Appearance & Behavior → System Settings → HTTP Proxy 配置正确，或为终端设置 HTTPS_PROXY 环境变量

• 确认防火墙允许 IDE 进程出站访问 *.qcode.cc:443

改了环境变量但 IDE 不感知？¶

环境变量在进程启动时读取一次。修改 ~/.zshrc 或系统变量后，需完全退出并重启 IDE（而非仅重新打开窗口）才会生效。

下一步¶

• 查看 接入点与 API 格式 了解三个域名与各协议的 base URL

• 查看 VS Code 集成 了解 VS Code 扩展

• 查看 Cline 集成 了解另一个 VS Code AI 扩展

• 查看 CLI 技巧 了解终端使用技巧

想知道在 JetBrains 里跑哪款模型最划算？查看 QCode 价格页，按预算挑选 Opus / Sonnet / Haiku。

企业团队版 →