{/* TRANSLATED — 已翻译为中文 */}

> ## 文档索引
> 获取完整文档索引：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` 拒绝规则](/en/permissions#read-and-edit)会阻止匹配文件的共享
* **文件引用快捷键**：使用 `Cmd+Option+K`（Mac）或 `Alt+Ctrl+K`（Linux/Windows）插入文件引用，如 `@src/auth.ts#L1-99`
* **诊断共享**：IDE 中的诊断错误（如 lint 和语法错误）会在您工作时自动与 Claude 共享

## 安装

### 应用市场安装

从 JetBrains 应用市场查找并安装 [Claude Code 插件](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-)，然后重启 IDE。

如果您尚未安装 Claude Code，请参阅[快速入门指南](/en/quickstart)了解安装说明。

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

## 使用方法

### 从 IDE 中使用

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

### 从外部终端使用

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

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

```text theme={null}
/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 发行版名称）
</Tip>

#### ESC 键配置

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

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

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

## 特殊配置

### 远程开发

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

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

### WSL 配置

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

#### 允许 WSL2 流量通过 Windows 防火墙

这是推荐的修复方法，因为它保留您现有的 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>

#### 将 WSL2 切换为镜像网络

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

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

```ini theme={null}
[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 配置](#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 安装或登录问题，请参阅[排查安装和登录问题](/en/troubleshoot-install)。