JetBrains 集成

JetBrains Integration

Claude Code 提供了 JetBrains 插件（Beta），支持在 IntelliJ IDEA、WebStorm、PyCharm 等主流 JetBrains IDE 中使用 Claude Code 的核心功能。本指南将介绍如何安装、配置和使用该插件。

Beta 插件安装

Beta Plugin Installation

JetBrains 插件目前处于 Beta 阶段，功能仍在快速迭代中。

前置条件

条件	要求
JetBrains IDE 版本	2024.1 或更高
Node.js	18.0 或更高
Claude Code CLI	已安装并完成认证
操作系统	macOS、Linux 或 Windows（WSL）

安装步骤

方法一：从 CLI 安装（推荐）

bash

# 自动检测已安装的 JetBrains IDE 并安装插件
claude install-jetbrains-extension

该命令会自动扫描系统中已安装的 JetBrains 产品，并为每个产品安装插件。

方法二：手动安装

打开 JetBrains IDE
进入 Settings → Plugins → Marketplace
搜索 "Claude Code"
点击 Install
重启 IDE

方法三：从磁盘安装

如果你处于离线环境或网络受限，可以手动下载 .zip 插件包：

bash

# 下载插件包
curl -O https://plugins.jetbrains.com/plugin/download?pluginId=claude-code

# 在 IDE 中：Settings → Plugins → ⚙️ → Install Plugin from Disk

验证安装

安装成功后，你会在 IDE 底部工具窗口中看到 Claude Code 标签页。点击后即可打开终端交互面板。

终端集成方式

Terminal Integration

与 VS Code 扩展不同，JetBrains 插件主要通过嵌入式终端的方式与 Claude Code 集成。

工作原理

JetBrains 插件在 IDE 内部嵌入了一个增强的终端环境，直接运行 Claude Code CLI。这意味着：

你使用的是完整的 CLI 功能
所有 CLI 命令和斜杠命令都可用
自动继承项目目录作为工作目录

打开 Claude Code 面板

操作	方式
工具窗口	点击底部 Claude Code 标签
快捷键	`Alt+C`（默认）
菜单	View → Tool Windows → Claude Code
命令搜索	`Ctrl+Shift+A` 搜索 "Claude Code"

终端交互

在 Claude Code 面板中，你可以像在普通终端中一样使用所有 CLI 功能：

bash

# 开始新对话
请解释这个项目的整体架构

# 使用斜杠命令
/init        # 初始化 CLAUDE.md
/model       # 切换模型
/compact     # 压缩对话历史
/clear       # 清除会话

与 IDE 终端的区别

特性	Claude Code 面板	普通终端
自动连接 Claude	是	需手动运行 `claude`
IDE 上下文感知	是	否
Diff 集成	是	否
文件导航联动	是	否

IDE Diff 查看器

IDE Diff Viewer

当 Claude 修改文件时，JetBrains 插件会利用 IDE 原生的 diff 查看器展示变更。

Diff 触发方式

Claude 执行文件编辑后，变更会自动出现在以下位置：

编辑器标签：修改的文件标签会显示蓝色标记
Version Control 面板：所有变更汇总在 Local Changes 中
Diff 弹窗：点击变更文件可查看详细 diff

查看 Diff

# Claude 修改文件后的操作流程

1. 在 Claude Code 面板中看到文件修改提示
2. 点击文件名 → 跳转到 IDE diff 查看器
3. 左侧显示修改前，右侧显示修改后
4. 使用 IDE 的 diff 导航快捷键浏览变更

Diff 导航快捷键

快捷键	功能
`F7`	跳转到下一个差异
`Shift+F7`	跳转到上一个差异
`Ctrl+Z`	撤销变更
`Ctrl+Shift+Z`	重做变更

与 Git 集成

所有 Claude 的修改都会被 IDE 的 Git 集成跟踪。你可以：

在 Git → Local Changes 中查看所有修改
选择性地将 Claude 的修改加入暂存区
使用 IDE 的 commit 面板提交

bash

# 在 Claude Code 面板中也可以直接操作 Git
请将刚才的所有修改提交，commit message 为 "feat: add user validation"

支持的 JetBrains 产品

Supported JetBrains Products

Claude Code 插件支持基于 IntelliJ 平台构建的所有主流 JetBrains IDE。

产品	版本要求	支持状态
IntelliJ IDEA（Community & Ultimate）	2024.1+	完全支持
WebStorm	2024.1+	完全支持
PyCharm（Community & Professional）	2024.1+	完全支持
GoLand	2024.1+	完全支持
PhpStorm	2024.1+	完全支持
RubyMine	2024.1+	完全支持
CLion	2024.1+	完全支持
Rider	2024.1+	完全支持
DataGrip	2024.1+	部分支持
Android Studio	Hedgehog+	实验性支持

语言无关

插件本身不依赖于特定编程语言，因此在任何 JetBrains IDE 中都可以使用 Claude 的全部代码能力。Claude 支持的语言特性取决于模型本身，而非 IDE 插件。

多项目工作区

bash

# JetBrains 支持多模块项目
# Claude 会自动识别当前项目的根目录
# 如果有多个模块，可以手动指定
/init  # 在项目根目录初始化

# 在各模块目录下也可以创建局部 CLAUDE.md

配置方法

Configuration

JetBrains 插件的配置分为插件级配置和项目级配置。

插件设置

进入 Settings → Tools → Claude Code：

设置项	默认值	说明
Panel Position	Bottom	面板位置（Bottom/Right/Left）
Auto Start	false	是否随 IDE 启动自动打开
Font Size	13	终端字体大小
Theme	Auto	主题跟随 IDE 或自定义
Shell Path	系统默认	自定义 Shell 路径

环境变量配置

bash

# 方法一：在系统环境变量中设置
export ANTHROPIC_API_KEY="sk-ant-..."

# 方法二：在 IDE 配置中设置
# Settings → Tools → Claude Code → Environment Variables
# 添加 ANTHROPIC_API_KEY=sk-ant-...

# 方法三：在项目 .env 文件中设置（需要 .env 插件支持）

项目级配置

项目级配置通过 .claude/settings.json 和 CLAUDE.md 文件管理，这些文件与 CLI 共享：

json

// .claude/settings.json
{
  "permissions": {
    "allow": [
      "Read(**)",
      "Edit(**)",
      "Bash(npm run *)"
    ],
    "deny": [
      "Bash(rm -rf *)"
    ]
  }
}

代理配置

如果你在公司网络环境中，可能需要配置代理：

bash

# 在环境变量中设置 HTTP 代理
export HTTP_PROXY="http://proxy.company.com:8080"
export HTTPS_PROXY="http://proxy.company.com:8080"

已知限制

Known Limitations

作为 Beta 版本，JetBrains 插件存在一些已知限制。

当前限制

限制	说明	预计修复
无 @-mention	不支持 VS Code 风格的文件引用	计划中
无内联 Diff	Diff 通过 IDE 原生工具展示	评估中
无多标签会话	每次只能运行一个会话	计划中
无自动接受	所有修改需手动确认	计划中
图片预览	部分图片格式预览受限	评估中

性能注意事项

bash

# 大型项目中可能遇到性能问题
# 建议在 CLAUDE.md 中指定关注的目录范围

# CLAUDE.md 示例
# 本项目关注 src/ 和 tests/ 目录
# 忽略 build/、node_modules/、.gradle/ 等生成目录

已知 Bug

在某些情况下，IDE 重启后面板可能不会自动恢复
高 DPI 显示器上终端字体可能显示异常
Windows 原生环境（非 WSL）支持有限

反馈渠道

遇到问题时，可以通过以下方式反馈：

bash

# 使用 CLI 提交反馈
claude feedback

# 或在 GitHub Issues 中报告
# https://github.com/anthropics/claude-code/issues

与 VS Code 扩展对比

Comparison with VS Code Extension

两个平台的扩展在设计理念上有所不同，选择取决于你的开发习惯和需求。

功能对比

功能	VS Code 扩展	JetBrains 插件
集成方式	原生 GUI	嵌入式终端
@-mention 文件引用	支持	不支持（使用路径）
多标签会话	支持	不支持
内联 Diff	支持	使用 IDE Diff 工具
自动接受编辑	支持	不支持
MCP 工具	支持	支持（通过 CLI）
斜杠命令	支持	完全支持
无头模式	不适用	不适用
设置同步	VS Code Sync	JetBrains Sync
成熟度	稳定版	Beta

交互体验对比

VS Code 扩展的优势：

- 更接近原生 AI 助手体验
- 文件引用更便捷（@-mention 自动补全）
- 内联 Diff 更直观
- 多会话支持灵活

JetBrains 插件的优势：

- 完整的 CLI 功能（所有命令和选项都可用）
- 与 JetBrains 强大的 IDE 功能无缝结合
- 代码分析和重构能力更强（依托 IDE）
- 适合已有 JetBrains 工作流的团队

选择建议

场景	推荐选择
Web/前端开发	VS Code 扩展
Java/Kotlin 开发	JetBrains 插件
Python 数据科学	两者皆可
全栈开发	根据主力 IDE 选择
团队统一工具	跟随团队标准
追求最新功能	VS Code 扩展

共享配置

两个平台的扩展共享以下配置文件，因此可以无缝切换：

bash

# 项目级配置（两平台共享）
CLAUDE.md                    # 项目上下文
.claude/settings.json        # 项目权限配置

# 用户级配置（两平台共享）
~/.claude/settings.json      # 全局设置
~/.claude/.credentials       # 认证信息

快速入门示例

Quick Start Example

以下是一个在 JetBrains IDE 中使用 Claude Code 的完整示例：

bash

# 1. 打开 Claude Code 面板（Alt+C）

# 2. 初始化项目
/init

# 3. 提出开发需求
请在 src/main/java/com/example/ 下创建一个 UserService 类，
包含 CRUD 操作，使用 Spring Boot 和 JPA

# 4. 查看 Claude 的修改
# → 在 IDE 的 Version Control 面板中查看所有变更

# 5. 运行测试
请为 UserService 编写单元测试并运行

# 6. 提交代码
请提交所有修改，commit message 为 "feat: add UserService with CRUD operations"

故障排查

Troubleshooting

常见问题

Q: 插件安装后面板为空白？

bash

# 检查 CLI 是否可用
which claude
claude --version

# 确保认证有效
claude auth status

Q: 面板中出现权限错误？

bash

# 检查项目目录权限
ls -la .claude/

# 重新初始化
claude init

Q: 如何更新到最新版本？

bash

# 更新 CLI
npm install -g @anthropic-ai/claude-code@latest

# 更新 IDE 插件
# Settings → Plugins → Updates → 更新 Claude Code

JetBrains 集成 ​

Beta 插件安装 ​

前置条件 ​

安装步骤 ​

验证安装 ​

终端集成方式 ​

工作原理 ​

打开 Claude Code 面板 ​

终端交互 ​

与 IDE 终端的区别 ​

IDE Diff 查看器 ​

Diff 触发方式 ​

查看 Diff ​

Diff 导航快捷键 ​

与 Git 集成 ​

支持的 JetBrains 产品 ​

语言无关 ​

多项目工作区 ​

配置方法 ​

插件设置 ​

环境变量配置 ​

项目级配置 ​

代理配置 ​

已知限制 ​

当前限制 ​

性能注意事项 ​

已知 Bug ​

反馈渠道 ​

与 VS Code 扩展对比 ​

功能对比 ​

交互体验对比 ​

选择建议 ​

共享配置 ​

快速入门示例 ​

故障排查 ​

常见问题 ​

JetBrains 集成

Beta 插件安装

前置条件

安装步骤

验证安装

终端集成方式

工作原理

打开 Claude Code 面板

终端交互

与 IDE 终端的区别

IDE Diff 查看器

Diff 触发方式

查看 Diff

Diff 导航快捷键

与 Git 集成

支持的 JetBrains 产品

语言无关

多项目工作区

配置方法

插件设置

环境变量配置

项目级配置

代理配置

已知限制

当前限制

性能注意事项

已知 Bug

反馈渠道

与 VS Code 扩展对比

功能对比

交互体验对比

选择建议

共享配置

快速入门示例

故障排查

常见问题