JetBrains IDE

在 IntelliJ IDEA、WebStorm、PyCharm 等 JetBrains IDE 中使用 Claude Code

JetBrains IDE 集成 ¶

Claude Code 提供了官方 JetBrains 插件，支持 IntelliJ IDEA、WebStorm、PyCharm、GoLand 等所有 JetBrains IDE。

前提条件 ¶

Claude Code CLI 已安装并可正常使用
参考安装教程完成安装
参考环境变量配置完成 QCode.cc API 配置
JetBrains IDE 2024.1 或更高版本

安装步骤 ¶

步骤 1：安装 Claude Code 插件 ¶

打开 JetBrains IDE
进入 Settings → Plugins → Marketplace
搜索 "Claude Code"（发布者: Anthropic）
点击 Install
重启 IDE

步骤 2：环境变量配置 ¶

确保以下环境变量已设置（与 CLI 相同）：

# 国内用户推荐深圳直连（最低延迟）
export ANTHROPIC_BASE_URL="http://103.236.53.153/api"
# 海外用户使用国际入口
# export ANTHROPIC_BASE_URL="https://api.qcode.cc/"
export ANTHROPIC_AUTH_TOKEN="cr_your_api_key"

提示：JetBrains IDE 会继承系统环境变量。如果你已在 ~/.zshrc 或 ~/.bashrc 中配置过，IDE 启动后会自动读取。

步骤 3：验证 ¶

在 IDE 中按 Cmd+Esc（macOS）或 Ctrl+Esc（Windows/Linux）打开 Claude Code 面板
输入一条简单消息测试连接

使用方法 ¶

快捷键 ¶

快捷键	功能
`Cmd+Esc` / `Ctrl+Esc`	打开/关闭 Claude Code 面板

主要功能 ¶

代码解释：选中代码 → 右键 → Ask Claude
代码生成：在 Claude 面板中描述需求
错误修复：将错误信息发给 Claude 分析
代码重构：选中代码让 Claude 帮助优化

与终端 CLI 配合 ¶

JetBrains IDE 内置的 Terminal 也可以直接运行 claude 命令，与 CLI 功能完全一致。

常见问题 ¶

插件不显示 Claude Code 面板？¶

确认插件已安装并启用
确认 Claude Code CLI 已全局安装（claude --version）
重启 IDE

环境变量未生效？¶

JetBrains IDE 可能未读取到 shell 配置文件中的环境变量。解决方法：

macOS：从终端启动 IDE（open -a "IntelliJ IDEA"），而非从 Dock 点击
所有平台：在 IDE 的 Run/Debug Configurations → Environment variables 中手动添加

下一步 ¶

查看 VS Code 集成了解 VS Code 扩展
查看 Cline 集成了解另一个 VS Code AI 扩展
查看 CLI 技巧了解终端使用技巧

实际使用场景 ¶

场景 1：理解陌生代码库 ¶

打开一个不熟悉的项目，选中关键代码片段：

右键 → Ask Claude → "解释这段代码的作用和设计思路"
Claude 会结合项目上下文给出解释
追问 "这个模块和哪些文件有依赖关系？"

场景 2：写单元测试 ¶

选中一个方法/函数
在 Claude 面板输入："为这个方法编写 JUnit/pytest 单元测试，覆盖边界情况"
Claude 会生成测试代码，可直接粘贴到测试文件

场景 3：重构与优化 ¶

选中需要优化的代码块
输入："重构这段代码，提取公共方法，改善可读性"
对比 Claude 建议的代码，选择性采纳

场景 4：调试辅助 ¶

复制错误堆栈信息
发送给 Claude："分析这个异常的根因，给出修复建议"

高级配置 ¶

自定义环境变量（IDE 级别）¶

如果系统级环境变量无法被 IDE 读取，可以在 IDE 内部配置：

方法 1：IDE 启动参数

编辑 IDE 的 idea.vmoptions（或对应 IDE 的配置文件）：

# Help → Edit Custom VM Options
-DANTHROPIC_BASE_URL=https://asia.qcode.cc/api
-DANTHROPIC_AUTH_TOKEN=cr_你的密钥

方法 2：运行配置中添加

对于需要在 Run/Debug 中使用 Claude Code 的场景： Run → Edit Configurations → Environment variables

代理设置 ¶

如果公司网络需要代理，在 IDE 设置中配置： Settings → Appearance & Behavior → System Settings → HTTP Proxy

确保代理能访问 asia.qcode.cc。

支持的 JetBrains IDE ¶

IDE	版本要求	适用语言
IntelliJ IDEA	2024.1+	Java, Kotlin, Scala
WebStorm	2024.1+	JavaScript, TypeScript
PyCharm	2024.1+	Python
GoLand	2024.1+	Go
PhpStorm	2024.1+	PHP
Rider	2024.1+	C#, .NET
CLion	2024.1+	C, C++
DataGrip	2024.1+	SQL, 数据库
RubyMine	2024.1+	Ruby

所有 IDE 使用同一个 Claude Code 插件，功能完全一致。