> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# JetBrains IDEs

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

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

<h2 id="supported-ides">
  支持的 IDE
</h2>

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

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

<h2 id="features">
  功能
</h2>

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

<h2 id="installation">
  安装
</h2>

该插件在您的 IDE 集成终端中运行 `claude` 命令并连接到它。它不包含自己的 CLI 副本，因此您需要安装两个部分：

<Steps>
  <Step title="安装 Claude Code CLI">
    如果您还没有安装 CLI，请按照[快速入门](/zh-CN/quickstart)进行安装。当 `claude` 不在您的 PATH 中时，插件会显示"无法启动 Claude Code"通知。
  </Step>

  <Step title="安装 JetBrains 插件">
    从 JetBrains Marketplace 安装 [Claude Code 插件](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-)，然后重启您的 IDE。
  </Step>
</Steps>

如果 `claude` 安装在您的 IDE 找不到的位置，请在插件的 [Claude 命令设置](#general-settings)中设置完整路径。

Claude Code 适用于任何付费 Claude 订阅（Pro、Max、Team 或 Enterprise）或 Claude Console 账户，无需 API 密钥。首次运行 `claude` 时，系统会提示您[登录](/zh-CN/authentication#log-in-to-claude-code)。

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

<h2 id="usage">
  使用
</h2>

<h3 id="from-your-ide">
  从您的 IDE
</h3>

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

<h3 id="from-external-terminals">
  从外部终端
</h3>

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

```bash theme={null}
claude
```

```text theme={null}
/ide
```

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

<h2 id="configuration">
  配置
</h2>

<h3 id="claude-code-settings">
  Claude Code 设置
</h3>

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

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

<h3 id="plugin-settings">
  插件设置
</h3>

通过转到 **Settings → Tools → Claude Code \[Beta]** 配置 Claude Code 插件：

<h4 id="general-settings">
  常规设置
</h4>

* **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 发行版名称）
</Tip>

<h4 id="esc-key-configuration">
  ESC 键配置
</h4>

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

1. 转到 **Settings → Tools → Terminal**
2. 执行以下任一操作：
   * 取消选中"使用 Escape 将焦点移动到编辑器"，或
   * 点击"配置终端快捷键"并删除"切换焦点到编辑器"快捷方式
3. 应用更改

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

<h2 id="special-configurations">
  特殊配置
</h2>

<h3 id="remote-development">
  远程开发
</h3>

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

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

<h3 id="wsl-configuration">
  WSL 配置
</h3>

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

<h4 id="allow-wsl2-traffic-through-windows-firewall">
  允许 WSL2 流量通过 Windows 防火墙
</h4>

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

<Steps>
  <Step title="查找您的 WSL2 IP 地址">
    从您的 WSL shell 内部运行：

    ```bash theme={null}
    hostname -I
    ```

    记下子网，例如 `172.21.123.45` 在 `172.21.0.0/16` 中。
  </Step>

  <Step title="创建防火墙规则">
    以管理员身份打开 PowerShell 并运行以下命令，调整 IP 范围以匹配您的子网：

    ```powershell theme={null}
    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
    ```
  </Step>

  <Step title="重启您的 IDE 和 Claude Code">
    关闭并重新打开两者，以使新规则生效。
  </Step>
</Steps>

<h4 id="switch-wsl2-to-mirrored-networking">
  将 WSL2 切换到镜像网络
</h4>

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

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

```ini theme={null}
[wsl2]
networkingMode=mirrored
```

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

<h2 id="troubleshooting">
  故障排除
</h2>

<h3 id="plugin-not-working">
  插件不工作
</h3>

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

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

<h3 id="ide-not-detected">
  IDE 未检测到
</h3>

如果运行 `claude` 显示"未检测到可用的 IDE"：

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

<h3 id="command-not-found">
  命令未找到
</h3>

如果点击 Claude 图标显示"命令未找到"：

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

<h2 id="security-considerations">
  安全考虑
</h2>

当 Claude Code 在启用 [`acceptEdits` 权限模式](/zh-CN/permission-modes#auto-approve-file-edits-with-acceptedits-mode)的 JetBrains IDE 中运行时，它可能能够修改可由您的 IDE 自动执行的 IDE 配置文件。这可能会增加在 `acceptEdits` 模式下运行 Claude Code 的风险，并允许绕过 Claude Code 对 bash 执行的权限提示。

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

* 对编辑使用手动批准模式
* 特别小心确保 Claude 仅与受信任的提示一起使用
* 了解 Claude Code 有权修改哪些文件

如需 IDE 外的 Claude Code 安装或登录问题，请参阅[故障排除安装和登录](/zh-CN/troubleshoot-install)。