JetBrains IDEs 中使用 Claude Code

简介

Claude Code 提供官方插件，支持全套 JetBrains IDE：IntelliJ IDEA、PyCharm、WebStorm、PhpStorm、GoLand、Android Studio。

核心特点：代码选中上下文自动传递、IDE原生Diff面板预览修改、全局快捷键唤起、终端CLI和IDE插件联动。 ⚠️ 重要：JetBrains插件依赖 Claude Code CLI，必须先安装CLI，再装IDE插件。

前置条件

Node.js 环境（v18+）
安装 Claude Code CLI
JetBrains IDE（2024.1+推荐）
Anthropic账号 / API Key（支持DeepSeek等第三方模型，参考《Claude Code DeepSeek 配置》）

步骤1：安装 Claude Code CLI

Mac / Linux / WSL

curl -fsSL https://claude.ai/install.sh | bash

Mac Homebrew方式

brew install claude-code

Windows PowerShell（管理员）

irm https://claude.ai/install.ps1 | iex

验证CLI安装成功

claude --version

输出版本号即安装完成。

步骤2：JetBrains IDE 安装插件

打开IDE，File → Settings → Plugins（Mac：IntelliJ IDEA → Settings → Plugins）
切换到 Marketplace，搜索 Claude Code（官方插件）
点击Install，重启IDE（必须完全重启，插件才生效）

离线安装：下载插件zip包，Plugins → Install Plugin from Disk，选择压缩包安装。

步骤3：认证与API配置（二选一）

方式A：账号登录

在IDE内置终端，进入项目根目录
执行命令

claude

按提示打开浏览器完成Anthropic账号授权，授权完成自动绑定IDE。

方式B：API Key配置（API调用/DeepSeek）

配置环境变量：

# Anthropic原生
export ANTHROPIC_API_KEY="你的key"
# DeepSeek 中转
export ANTHROPIC_BASE_URL="https://api.deepseek.com"
export ANTHROPIC_API_KEY="DeepSeek密钥"

也可写入 ~/.claude/settings.json 持久保存。

步骤4：IDE 联动启用（关键）

claude

输入 /ide，自动连接当前JetBrains IDE。连接成功后，IDE会开启Diff预览，Claude修改代码直接在IDE内置对比面板展示。

常用快捷键

系统	快捷键	功能
Windows/Linux	`Ctrl + Esc`	唤起 Claude Code
Mac	`Cmd + Esc`	唤起 Claude Code
Windows/Linux	`Ctrl+Alt+K`	将选中代码发送给 Claude
Mac	`Cmd+Option+K`	将选中代码发送给 Claude

核心功能

选中代码上下文：编辑器选中代码，一键发给Claude，自动带上文件路径与行号
IDE原生Diff：Claude生成代码变更，直接用IDE自带diff查看，支持一键应用/拒绝修改
斜杠命令：在对话内输入 /config、/model、/plan、/clear，管理配置、切换模型、创建Coding Plan
项目感知：自动读取项目文件，识别.gitignore，不会读取密钥等敏感文件

验证使用

打开项目代码文件，选中一段代码，快捷键唤起Claude，输入指令：

重构这段代码，增加异常捕获

Claude完成修改后，IDE弹出Diff窗口，预览变更，确认后应用代码。

常见问题

插件已安装，但无法连接IDE
- 必须在项目根目录运行 claude，再执行 /ide
- 重启IDE；检查CLI版本是否最新，claude update 更新
Diff面板不弹出 在Claude对话输入 /config diffTool auto，使用IDE原生diff工具。
401鉴权失败 检查环境变量是否生效；重启IDE终端，确认密钥复制完整。
远程开发场景 远程服务器上安装CLI，插件安装在远程主机，本地IDE仅作为客户端。

安全提示

避免把包含数据库密码、私钥的文件交给Claude Code读取
对陌生项目，先限制文件读写范围，防止误操作删除代码

简介