Claude Code 能够与任何带有终端的集成开发环境 (IDE) 协同工作。你只需在终端中运行 claude 命令即可开始使用。

此外，为了提供更深度集成的体验，例如交互式差异视图、上下文选择共享等高级功能，Claude Code 为主流 IDE 提供了专门的扩展插件。

目前支持的 IDE 包括：

  • Visual Studio Code (及其分支，如 Cursor、Windsurf 和 VSCodium)
  • JetBrains IDEs (如 IntelliJ, PyCharm, Android Studio, WebStorm, PhpStorm, GoLand 等)

核心功能

通过 IDE 扩展，你可以获得以下增强功能：

  • 快速启动：在编辑器中，使用快捷键 Cmd+Esc (macOS) 或 Ctrl+Esc (Windows/Linux) 直接唤起 Claude Code。
  • 差异视图：代码变更可以直接在 IDE 内置的差异比较器中展示，而非终端。你可以在 /config 中进行配置。
  • 上下文感知：IDE 中当前选中的代码或打开的标签页会自动作为上下文与 Claude Code 共享。
  • 文件引用：使用快捷键 Cmd+Option+K (macOS) 或 Alt+Ctrl+K (Windows/Linux) 快速插入文件引用，例如 @File#L1-99。
  • 诊断信息共享：IDE 中的代码诊断错误（如 Lint 错误、语法错误等）会自动与 Claude 共享。

安装指南

Visual Studio Code

在 VS Code 及其分支版本中安装 Claude Code 扩展非常简单：

  1. 打开 VS Code。
  2. 打开集成终端 (Integrated Terminal)。
  3. 运行 claude 命令，扩展程序将会被自动安装。

JetBrains IDE

对于 JetBrains 系列 IDE，你有两种安装方式：

  • 插件市场安装：

    1. 前往 JetBrains Marketplace。
    2. 搜索并安装 “Claude Code” 插件。
    3. 完全重启你的 IDE。

  • 自动安装： 在 JetBrains IDE 的集成终端中运行 claude 命令，插件也可能会被提示自动安装。安装后必须完全重启 IDE 才能生效。

远程开发限制: 如果你使用 JetBrains 远程开发功能，必须在远程主机上安装插件，路径为 设置 > 插件 (主机)。

WSL 用户注意: 在 WSL 环境下配合 JetBrains IDE 使用时，可能需要额外配置才能让 IDE 正确检测到。请参考官方的 WSL 故障排查指南获取详细设置说明，包括终端配置、网络模式和防火墙规则。

使用方法

从 IDE 内部启动

在你的 IDE 集成终端中直接运行 claude 命令，所有增强功能都将被自动激活。

从外部终端连接

如果你在外部终端中使用 Claude Code，可以通过 /ide 命令将其连接到你正在运行的 IDE，并激活所有集成功能。

为了确保 Claude Code 能够访问与 IDE 相同的文件，请在项目的根目录下启动它。

配置选项

通用配置

你可以通过 Claude Code 内置的配置系统来调整 IDE 集成选项：

  1. 在终端运行 claude。
  2. 输入 /config 命令。
  3. 根据提示调整你的偏好设置。例如，将差异工具 (diff tool) 设置为 auto 可以启用 IDE 自动检测。

JetBrains 插件专属设置

你可以通过 设置 → 工具 → Claude Code [Beta] 路径来配置 JetBrains 插件的特定行为。

常规设置

  • Claude 命令: 指定启动 Claude 的自定义命令，例如 /usr/local/bin/claude 或 npx @anthropic/claude。
    • 对于 WSL 用户，可以设置为 wsl -d Ubuntu -- bash -lic "claude" (请将 Ubuntu 替换为你的 WSL 发行版名称)。
  • 禁用 Claude 命令未找到的通知: 勾选后，如果找不到 claude 命令，将不再弹出通知。
  • 启用 Option+Enter 进行多行提示 (仅限 macOS): 启用后，Option+Enter 快捷键用于在提示框中换行。如果遇到 Option 键被意外捕获的问题，请禁用此项（需要重启终端）。
  • 启用自动更新: 自动检查并安装插件更新（重启 IDE 时生效）。

ESC 键配置

如果在 JetBrains 终端中 ESC 键无法中断 Claude Code 的操作，请按以下步骤调整：

  1. 前往 设置 → 工具 → 终端。
  2. 执行以下任一操作：
    • 取消勾选 “使用 Escape 将焦点移动到编辑器”。
    • 点击 “配置终端键绑定”，并移除 “切换焦点到编辑器” 的快捷键。
  3. 应用更改。

故障排查

VS Code 扩展未安装

  1. 确认运行环境：确保你是在 VS Code 的集成终端内运行 claude 命令。
  2. 检查 Shell 命令：确保你的 IDE 对应的 CLI 工具已安装并存在于系统 PATH 中。
    • VS Code: code
    • Cursor: cursor
    • Windsurf: windsurf
    • VSCodium: codium
    • 如果未安装，使用 Cmd+Shift+P (macOS) 或 Ctrl+Shift+P (Windows/Linux) 打开命令面板，搜索并执行 “Shell 命令：在 PATH 中安装 ‘code’ 命令” (或对应 IDE 的类似命令)。
  3. 检查权限：确认 VS Code 有权限安装扩展。

JetBrains 插件不工作

  1. 确认运行目录：确保你是在项目的根目录下运行 claude 命令。
  2. 检查插件状态：在 IDE 设置中检查 Claude Code 插件是否已启用。
  3. 完全重启 IDE：有时需要多次重启才能使插件正常工作。
  4. 远程开发：确认插件已安装在远程主机上，而非本地客户端。
  5. WSL/WSL2 问题：如果 IDE 无法被检测到，请参考官方的 WSL2 故障排查指南，检查网络配置和防火墙设置。

👉 如果你需要 ChatGPT 代充 / Claude / Claude Code / 镜像 / 中转 API：