English ← MyDocs

文档索引

获取完整文档索引：https://code.claude.com/docs/llms.txt 使用此文件发现所有可用页面，然后再进一步探索。

JetBrains IDE

在 JetBrains IDE（包括 IntelliJ、PyCharm、WebStorm 等）中使用 Claude Code

Claude Code 通过专用插件与 JetBrains IDE 集成，提供交互式差异查看、选择上下文共享等功能。

支持的 IDE

Claude Code 插件适用于大多数 JetBrains IDE，包括：

  • IntelliJ IDEA
  • PyCharm
  • Android Studio
  • WebStorm
  • PhpStorm
  • GoLand

功能

  • 快速启动：使用 Cmd+Esc（Mac）或 Ctrl+Esc（Windows/Linux）直接从编辑器打开 Claude Code，或点击 UI 中的 Claude Code 按钮
  • 差异查看：代码更改可以直接在 IDE 差异查看器中显示，而不是在终端中
  • 选择上下文：IDE 中的当前选择或标签页会自动与 Claude Code 共享。Read 拒绝规则会阻止匹配文件的共享
  • 文件引用快捷键：使用 Cmd+Option+K（Mac）或 Alt+Ctrl+K（Linux/Windows）插入文件引用，如 @src/auth.ts#L1-99
  • 诊断共享：IDE 中的诊断错误（如 lint 和语法错误）会在您工作时自动与 Claude 共享

安装

应用市场安装

从 JetBrains 应用市场查找并安装 Claude Code 插件，然后重启 IDE。

如果您尚未安装 Claude Code，请参阅快速入门指南了解安装说明。

Note

安装插件后，您可能需要完全重启 IDE 才能使其生效。

使用方法

从 IDE 中使用

从 IDE 的集成终端运行 claude，所有集成功能将处于活动状态。

从外部终端使用

在任何外部终端中使用 /ide 命令将 Claude Code 连接到您的 JetBrains IDE 并激活所有功能：

claude

/ide

如果您希望 Claude 能够访问与 IDE 相同的文件，请从与 IDE 项目根目录相同的目录启动 Claude Code。

配置

Claude Code 设置

通过 Claude Code 的设置配置 IDE 集成：

  1. 运行 claude
  2. 输入 /config 命令
  3. 将差异工具设置为 auto 以在 IDE 中显示差异，或设置为 terminal 以保留在终端中

插件设置

通过 Settings → Tools → Claude Code [Beta] 配置 Claude Code 插件：

常规设置

  • Claude 命令：指定运行 Claude 的自定义命令，例如 claude、/usr/local/bin/claude 或 npx @anthropic-ai/claude-code
  • 抑制 Claude 命令未找到通知：跳过关于找不到 Claude 命令的通知
  • 启用使用 Option+Enter 输入多行提示：仅限 macOS。启用后，Option+Enter 在 Claude Code 提示中插入新行。如果 Option 键被意外捕获，请禁用此选项。需要重启终端。
  • 启用自动更新：自动检查并安装插件更新，重启后生效
Tip

对于 WSL 用户：将 wsl -d Ubuntu -- bash -lic "claude" 设置为您的 Claude 命令（将 Ubuntu 替换为您的 WSL 发行版名称）

ESC 键配置

如果 ESC 键无法在 JetBrains 终端中中断 Claude Code 操作：

  1. 前往 Settings → Tools → Terminal
  2. 执行以下操作之一：
    • 取消选中"使用 Escape 将焦点移至编辑器"，或
    • 点击"配置终端按键绑定"并删除"将焦点切换到编辑器"快捷键
  3. 应用更改

这将允许 ESC 键正确中断 Claude Code 操作。

特殊配置

远程开发

Warning

使用 JetBrains 远程开发时，您必须通过 Settings → Plugin (Host) 在远程主机上安装插件。

插件必须安装在远程主机上，而不是本地客户端机器上。

WSL 配置

如果您在 WSL2 上使用 JetBrains IDE 的 Claude Code 并看到"No available IDEs detected"，原因通常是 WSL2 的 NAT 网络或 Windows 防火墙阻止了 WSL2 与运行在 Windows 主机上的 IDE 之间的连接。WSL1 直接使用主机网络，不受影响。

允许 WSL2 流量通过 Windows 防火墙

这是推荐的修复方法，因为它保留您现有的 WSL2 网络模式。

  1. 查找您的 WSL2 IP 地址

    在 WSL shell 中运行：

    hostname -I

    注意子网，例如 172.21.123.45 属于 172.21.0.0/16。

  2. 创建防火墙规则

    以管理员身份打开 PowerShell 并运行以下命令，调整 IP 范围以匹配您的子网：

    New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16

  3. 重启 IDE 和 Claude Code

    关闭并重新打开两者以使新规则生效。

将 WSL2 切换为镜像网络

镜像网络需要 Windows 11 22H2 或更高版本。如果您使用 Windows 10，请改用上面的防火墙规则。

将以下内容添加到 Windows 用户目录中的 .wslconfig：

[wsl2]
networkingMode=mirrored

然后从 PowerShell 使用 wsl --shutdown 重启 WSL。

故障排除

插件不工作

如果插件已安装但 Claude Code 功能未出现在 IDE 中：

  • 确保您从项目根目录运行 Claude Code
  • 检查 JetBrains 插件是否在 IDE 设置中启用
  • 完全重启 IDE（您可能需要多次执行此操作）
  • 对于远程开发，确保插件安装在远程主机上

IDE 未检测到

如果运行 claude 显示"No available IDEs detected"：

  • 验证插件已安装并启用
  • 完全重启 IDE
  • 检查您是否从集成终端运行 Claude Code
  • 对于 WSL 用户，请参阅上面的 WSL 配置

命令未找到

如果点击 Claude 图标显示"command not found"：

  1. 通过在终端中运行 claude --version 验证 Claude Code 已安装
  2. 在插件设置中配置 Claude 命令路径
  3. 对于 WSL 用户，使用配置部分中提到的 WSL 命令格式

安全注意事项

当 Claude Code 在 JetBrains IDE 中以自动编辑权限运行时，它可能能够修改可被 IDE 自动执行的 IDE 配置文件。这可能会增加在自动编辑模式下运行 Claude Code 的风险，并允许绕过 Claude Code 的 bash 执行权限提示。

在 JetBrains IDE 中运行时，请考虑：

  • 使用手动审批模式进行编辑
  • 特别注意确保 Claude 仅与受信任的提示一起使用
  • 了解 Claude Code 有权修改哪些文件

有关 IDE 外部的 Claude Code 安装或登录问题，请参阅排查安装和登录问题。