Claude Code 怎么和 JetBrains 集成？最新插件安装教程

对于长期使用 JetBrains 系列 IDE 的开发者来说，切换到 VS Code 用 Cursor 或者跑到终端里用 Claude Code，都意味着放弃已经深度定制的开发环境——快捷键习惯、插件配置、项目设置，这些积累不是说放就放的。

好消息是，你不需要为了用 Claude Code 而放弃 JetBrains。Claude Code 的 JetBrains 插件让你能在 IntelliJ IDEA、PyCharm、WebStorm、GoLand 等 IDE 里直接调用 Claude 的 AI 编程能力，不需要离开你熟悉的环境。

本文由 Claude Ai中文官网 整理，从环境准备到安装配置，再到核心功能使用，提供完整的 JetBrains 集成教程。

Claude Code JetBrains 插件随版本持续迭代，具体界面和功能以你安装时的版本为准。安装前建议访问 Claude Ai中文官网 或 Anthropic 官方文档确认最新版本要求。

一、安装前的环境准备

在安装插件之前，先确认以下环境要求都已满足，避免安装完成后才发现兼容性问题。

JetBrains IDE 版本要求

Claude Code 插件支持所有主流的 JetBrains IDE，但有最低版本限制。打开你的 IDE，在菜单栏选择 Help → About（Windows/Linux）或 [IDE 名称] → About（macOS），确认版本号满足要求：

• IntelliJ IDEA：2023.1 及以上（Ultimate 和 Community 版本均支持）
• PyCharm：2023.1 及以上
• WebStorm：2023.1 及以上
• GoLand：2023.1 及以上
• Rider、CLion、DataGrip 等：同样支持，版本要求参照 JetBrains Marketplace 的插件页面说明

如果你的 IDE 版本较旧，建议先通过 Help → Check for Updates 更新到最新版本，新版本除了支持插件还会有性能和功能改善。

Node.js 环境要求

Claude Code 的底层依赖 Node.js 运行环境。在终端中验证是否已安装：

node --version

确认输出的版本号为 18.0.0 及以上。如果未安装或版本过低，前往 nodejs.org 下载 LTS 版本安装。

Claude 账号和授权

使用 JetBrains 插件需要有效的 Claude 账号，以及对应的访问权限：

• Claude Pro 订阅账号（通过 claude.ai 订阅），或
• 有效的 Anthropic API Key（通过 console.anthropic.com 创建）

两种授权方式均支持，具体选哪种取决于你的使用习惯，下文会分别说明配置方法。

二、安装 Claude Code JetBrains 插件

插件的安装有两种路径，通过 IDE 内的插件市场是最简便的方式。

方式 1：通过 IDE 插件市场安装（推荐）

1. 打开 JetBrains IDE，进入 Settings / Preferences（快捷键：Ctrl+Alt+S Windows/Linux，Cmd+, macOS）。
2. 在左侧导航中选择 Plugins，点击顶部的 Marketplace 标签页。
3. 在搜索框中输入 “Claude Code” 或 “Anthropic”，找到由 Anthropic 官方发布的插件。
4. 点击插件旁边的 Install 按钮，等待下载和安装完成。
5. 安装完成后，IDE 会提示重启以激活插件，点击 Restart IDE 完成安装。

方式 2：从 JetBrains Marketplace 网站下载安装

如果 IDE 内的网络连接不稳定，可以从 JetBrains Marketplace 官网（plugins.jetbrains.com）手动下载插件文件：

1. 访问 plugins.jetbrains.com，搜索”Claude Code”。
2. 找到官方插件页面，选择与你 IDE 版本兼容的插件版本，下载 .zip 格式的插件包。
3. 在 IDE 中进入 Settings → Plugins，点击右上角的齿轮图标，选择 Install Plugin from Disk。
4. 选择下载的 .zip 文件，点击确认安装，重启 IDE。

方式 3：通过 npm 安装 Claude Code 后与 IDE 集成

如果你已经在终端中安装了 Claude Code CLI 工具，JetBrains 插件可以直接连接到这个已有的安装：

# 如果尚未安装 Claude Code CLI
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

安装 CLI 后，在 IDE 中安装插件，插件会自动检测系统中已安装的 Claude Code CLI 并建立连接。

三、初始配置：连接 Claude 账号

插件安装完成并重启 IDE 后，需要完成账号授权配置才能开始使用。

配置入口

重启后，IDE 界面通常会出现以下其中一种提示：

• 右下角的状态栏出现 Claude 图标，点击后引导配置
• 在 Settings → Tools → Claude Code 中找到配置页面
• 侧边栏出现 Claude 面板，点击后引导登录

方式 A：使用 Claude Pro 账号授权（推荐个人用户）

1. 在配置页面或首次启动引导中，选择 “Sign in with Claude.ai”。
2. 点击后会在浏览器中打开 claude.ai 的授权页面，使用你的账号登录。
3. 在授权页面确认允许 Claude Code 插件访问你的账号。
4. 授权完成后，浏览器会显示成功提示，IDE 中的插件状态也会更新为已连接。

方式 B：使用 Anthropic API Key 授权（推荐开发者和团队）

1. 前往 console.anthropic.com，登录 Anthropic 账号。
2. 在控制台中创建新的 API Key，复制完整的 Key 值（sk-ant-api03-...）。
3. 在 IDE 的插件配置页面，选择 “API Key” 授权方式。
4. 将 API Key 粘贴到对应输入框，点击 Verify 验证是否有效。
5. 验证通过后点击保存，插件状态变为已连接。

设置环境变量（推荐）

# macOS / Linux：在 ~/.zshrc 或 ~/.bashrc 中添加
export ANTHROPIC_API_KEY="sk-ant-api03-你的Key"

# 保存后执行使变量生效
source ~/.zshrc

# Windows：在系统环境变量中添加，或在 PowerShell 中执行
$env:ANTHROPIC_API_KEY = "sk-ant-api03-你的Key"

四、插件界面认识：在哪里找到 Claude 功能

完成配置后，Claude 的功能会以以下几种方式出现在 IDE 中：

Claude 侧边栏面板

在 IDE 右侧（或底部，取决于你的布局设置）会出现 Claude 的专属面板。你可以在这里与 Claude 进行对话，描述任务，查看生成的代码和分析结果。如果面板没有出现，通过 View → Tool Windows → Claude Code 手动打开。

编辑器内的行内操作

在代码编辑器中，你可以：

• 选中一段代码后，右键菜单中出现 Claude 相关操作选项
• 在某行代码旁边出现 Claude 图标，点击触发快速操作
• 通过键盘快捷键唤起针对当前光标位置或选中代码的 Claude 操作

快捷键配置

通过 Settings → Keymap 搜索”Claude”，可以查看和修改所有 Claude 相关操作的快捷键。建议根据你的使用习惯配置最常用操作的快捷键，避免和已有快捷键冲突：

• 唤起 Claude 对话面板
• 对选中代码触发解释
• 对选中代码触发重构建议
• 生成当前函数的测试

五、核心功能使用指南

功能 1：在 IDE 内与 Claude 对话

Claude 侧边栏面板支持完整的多轮对话，可以在 IDE 内直接进行编程相关的讨论，不需要切换到浏览器：

# 在侧边栏输入框中可以使用的提问类型：

"请解释当前打开文件中的 authenticate() 函数的工作原理"

"我想在这个项目里实现一个带有 JWT 过期刷新机制的认证系统，
你建议怎么设计？"

"这段代码的时间复杂度是多少？有没有优化空间？"

在对话中提到当前文件或选中内容时，Claude 能够感知到你的 IDE 上下文，给出更针对性的回答。

功能 2：解释和分析代码

选中需要理解的代码段，通过右键菜单或快捷键触发 Claude 解释：

• 右键 → Claude Code → Explain Code：解释选中代码的功能和逻辑
• 右键 → Claude Code → Find Issues：分析选中代码的潜在问题
• 右键 → Claude Code → Suggest Refactoring：给出重构建议

对于复杂的代码段，可以在对话面板中追问细节，Claude 会保持对刚才分析代码的记忆：

# 解释完一段代码后，在面板中继续追问：
"你说这里用了观察者模式，能解释一下为什么选择这个模式而不是回调函数？"

"这段代码在并发场景下安全吗？"

"如果要给这个函数增加缓存支持，你建议怎么改？"

功能 3：生成代码

在编辑器中，将光标放在目标位置（函数体内、类中等），通过对话面板描述需要生成的代码：

"在当前光标位置，生成一个 Python 函数，
功能是读取 CSV 文件并返回按指定列名分组的字典，
需要处理文件不存在和编码错误的异常，添加类型注解。"

Claude 生成代码后，通常会提供一个”插入代码”的操作按钮，点击后代码直接插入到你指定的位置，不需要手动复制粘贴。

功能 4：生成测试用例

选中一个函数或类，触发测试生成：

• 右键 → Claude Code → Generate Tests：自动分析函数逻辑并生成对应的测试用例

Claude 会根据你的项目中已有的测试框架（JUnit、pytest、Jest 等）生成风格一致的测试代码：

# 生成测试时，可以在面板中补充要求：
"为刚才那个函数生成测试，特别需要覆盖以下边界情况：
- 输入为空列表
- 列表中有 None 值
- 数值超过 int 最大值的情况"

功能 5：代码审查和安全检查

在提交代码之前，让 Claude 做一次快速审查：

# 在面板中输入：
"请对当前打开的 auth_service.py 文件做安全审查，
重点检查：SQL 注入风险、敏感数据处理、输入验证，
对每个问题说明风险等级和修复建议。"

功能 6：理解整个项目结构

当你接手一个新项目时，让 Claude 帮你快速建立全局认知：

"请分析这个项目的整体架构，告诉我：
1. 主要的模块和它们的职责
2. 数据流向：数据如何在不同层之间传递
3. 最关键的几个类或函数
4. 你认为有哪些地方的代码质量需要关注"

六、与 Claude Code CLI 的配合使用

JetBrains 插件和 Claude Code CLI（命令行工具）不是非此即彼的选择，两者在同一项目中可以配合使用。

什么时候用插件，什么时候用 CLI

• 插件更适合：在编写代码的过程中即时获取建议、解释代码片段、生成单个函数或类的代码、快速问答
• CLI 更适合：跨多文件的重构任务、需要 Claude 自主执行多步骤操作（读文件、运行命令、修改并验证）、大规模的代码库分析

在 JetBrains 内置终端中使用 Claude Code CLI

JetBrains IDE 内置了终端（View → Tool Windows → Terminal），你可以不离开 IDE 直接使用 Claude Code CLI：

# 在 IDE 内置终端中启动 Claude Code
cd /path/to/your/project
claude

# 向 Claude Code 描述复杂任务
> 请重构 src/services/ 目录下所有的 service 类，
  把硬编码的配置提取到环境变量，
  并更新所有引用这些配置的地方。
  完成后运行测试确认没有引入 bug。

在内置终端里运行 Claude Code，同时在编辑器里查看文件变化，是一个高效的工作流——Claude Code 在终端里执行操作，你在编辑器里实时观察它做了什么。

检查点和 Git 配合

不管是用插件还是 CLI，在执行有较大影响范围的操作前，先在终端里做一个 Git commit：

# 在 IDE 内置终端
git add .
git commit -m "WIP: 重构前的状态 - Claude Code 即将执行重构"

# 然后在同一终端里启动 Claude Code 执行重构
claude

有了 Git 提交作为安全点，Claude Code 执行的任何操作都可以通过 git reset 完整回滚，比只依赖 Claude Code 的检查点功能更可靠。

七、常见安装问题与解决方法

问题 1：插件安装后在 Plugins 列表中显示但不工作

可能原因：Node.js 未安装或版本不满足要求，插件找不到运行时环境。

解决步骤：

1. 在终端确认 node --version 输出的版本不低于 18
2. 在 Settings → Tools → Claude Code 中检查是否有 Node.js 路径配置项，手动指定 Node.js 的可执行文件路径
3. 如果使用 nvm 管理 Node.js 版本，确认 IDE 启动时能读取到正确的 Node 版本（IDE 可能使用与终端不同的环境变量）

# 查找 Node.js 的完整路径（macOS/Linux）
which node
# 输出类似：/usr/local/bin/node 或 /Users/username/.nvm/versions/node/v20.0.0/bin/node

# 在 IDE 配置中使用完整路径

问题 2：账号授权完成但状态显示未连接

可能原因：网络问题、Cookie 未正确传递、或需要重启 IDE 使授权生效。

解决步骤：

1. 完全退出 IDE（不只是关闭项目窗口），重新启动
2. 在 Settings → Tools → Claude Code 中点击 Logout，然后重新执行授权流程
3. 如果使用 API Key 授权，检查 Key 是否已过期或被撤销（在 console.anthropic.com 验证）
4. 尝试改用环境变量方式提供 API Key，绕过 IDE 的凭证存储

问题 3：插件响应很慢或经常超时

可能原因：网络延迟、请求内容过多、或 Anthropic 服务端负载。

解决步骤：

• 检查你的网络环境是否能稳定访问 Anthropic 的 API 端点
• 减少单次请求的内容量，避免把整个大文件的内容全部发给 Claude
• 在 IDE 设置中检查是否有超时时间配置，适当调大超时值
• 确认 Claude 的服务状态（status.anthropic.com）是否有已知问题

问题 4：快捷键和 IDE 现有快捷键冲突

解决方法：在 Settings → Keymap 中搜索冲突的快捷键，修改 Claude 插件的快捷键为不冲突的组合。常见的安全组合包括：Ctrl+Alt+C（Windows）或 Cmd+Shift+C（macOS）开头的组合。

问题 5：在特定文件类型中 Claude 选项不出现

可能原因：插件对某些文件类型的右键菜单集成未启用，或 IDE 未识别该文件类型。

解决方法：在 Settings → Editor → File Types 确认目标文件类型已正确注册。对于罕见的文件类型，可以通过在对话面板中直接粘贴代码内容来绕过右键菜单的限制。

八、团队使用的统一配置建议

如果你的团队都在用 JetBrains IDE，统一的 Claude 插件配置能减少每个人的上手时间。

使用 IDE 设置同步

JetBrains 提供内置的设置同步功能（File → Manage IDE Settings → Sync Settings to JetBrains Account），可以把插件列表和基本配置同步到团队成员的 IDE，确保大家安装了相同版本的插件。

团队共享的提示词模板

在项目根目录创建一个 .claude/ 文件夹，放入团队共享的提示词模板和 Claude 配置文件，通过 Git 分发给团队成员：

.claude/
├── CLAUDE.md          # 项目背景说明，Claude 会自动读取
├── prompts/
│   ├── code-review.md    # 代码审查提示词模板
│   ├── test-gen.md       # 测试生成提示词模板
│   └── refactor.md       # 重构任务提示词模板
└── settings.json      # 团队统一的 Claude 配置

CLAUDE.md 文件是最重要的——Claude Code 在启动时会自动读取这个文件，建立对项目的基本认知：

# CLAUDE.md 示例内容

## 项目概述
这是一个基于 Spring Boot 的 B2B 电商平台后端服务。

## 技术栈
- Java 21 + Spring Boot 3.2
- PostgreSQL + Redis
- Gradle 构建

## 代码规范
- 所有公共方法必须有 Javadoc
- Service 层必须有对应的单元测试
- 不允许直接在 Controller 层处理业务逻辑

## 架构约定
- Repository 层只做数据访问，不包含业务逻辑
- 所有异常通过 GlobalExceptionHandler 统一处理
- 配置项通过 application.properties 管理，不硬编码

## 安全要求
- 所有用户输入必须经过验证
- 数据库查询必须使用参数化查询，禁止字符串拼接

有了这个文件，团队中任何人在项目目录里启动 Claude Code，它都能立即理解项目的上下文和规范，生成的代码更符合团队约定。

九、更新和维护

保持插件最新版本

JetBrains 会在新版本发布时通过 IDE 通知提示更新。也可以主动检查：Settings → Plugins，在 Installed 标签页中找到 Claude Code 插件，查看是否有可用更新。

建议保持插件处于最新版本，Anthropic 会持续改善功能和修复已知问题。

反馈问题

遇到插件 Bug 或功能建议，通过以下渠道反馈：

• 在 JetBrains Marketplace 的插件页面提交评论和问题报告
• 通过 Anthropic 官方支持渠道提交
• 在 Claude Ai中文官网 查阅已知问题和解决方案

总结

Claude Code JetBrains 插件让你不需要离开熟悉的开发环境就能使用 Claude 的 AI 编程能力。安装过程的关键步骤是：确认 IDE 和 Node.js 版本满足要求，通过插件市场安装官方插件，选择合适的账号授权方式完成配置，然后通过 CLAUDE.md 文件帮助 Claude 快速理解你的项目。

在日常使用中，插件更适合即时的代码解释、生成和审查任务；对于跨多文件的复杂任务，配合 IDE 内置终端使用 Claude Code CLI 是更强大的选择。两者结合，能在不改变你的 JetBrains 使用习惯的前提下，把 AI 编程能力完整融入开发工作流。

更多关于 Claude Code 功能说明、最新版本更新和开发者文档，欢迎访问 Claude Ai中文官网 查阅持续更新的中文文档。

最好的 AI 编程工具，是那个能融入你已有工作方式的工具，而不是要求你为它改变一切的工具。Claude Code 的 JetBrains 集成，正是这个思路的体现。