将 Claude Code 添加到您的 IDE

Claude Code 与流行的集成开发环境 (IDE) 无缝集成，以增强您的编码工作流程

这种集成允许您直接在您首选的开发环境中利用 Claude 的功能

支持的 IDE

Visual Studio Code

包括 Cursor 和 Windsurf 等流行分支

  • 自动插件安装
  • 快速启动集成
  • 差异查看支持
  • 选择上下文共享
查看VS Code集成
JetBrains

JetBrains IDEs

包括 PyCharm、WebStorm、IntelliJ 和 GoLand

  • 插件市场安装
  • 完整重启要求
  • 远程开发支持
  • 诊断错误共享
查看JetBrains集成

功能特性

⚡

快速启动

使用 Cmd+Esc（Mac）或 Ctrl+Esc（Windows/Linux）直接从编辑器打开 Claude Code，或点击 UI 中的 Claude Code 按钮

🔍

差异查看

代码更改可以直接在 IDE 差异查看器中显示，而不是在终端中。您可以在 /config 中配置此功能

📁

选择上下文

IDE 中的当前选择/标签页会自动与 Claude Code 共享

⌨️

文件引用快捷键

使用 Cmd+Option+K（Mac）或 Alt+Ctrl+K（Linux/Windows）插入文件引用（例如，@File#L1-99）

🐛

诊断共享

IDE 中的诊断错误（lint、语法等）会在您工作时自动与 Claude 共享

VS Code 集成

1

打开 VSCode

启动您的 Visual Studio Code 编辑器

2

打开集成终端

使用快捷键 Ctrl+` 或通过菜单打开终端

3

运行 Claude Code

claude

扩展将自动安装

VS Code 集成效果

以下是 Claude Code 在 VS Code 中的集成效果展示：

VS Code Claude Code 集成效果
🔍 点击查看大图
💡

VS Code 分支支持

这些安装说明也适用于 VS Code 分支，如 Cursor 和 Windsurf。

使用外部终端

今后您也可以在任何外部终端中使用 /ide 命令连接到 IDE。

/ide  # 连接到当前打开的IDE

JB
JetBrains IDEs 集成

1

从市场安装插件

访问 Claude Code 插件 并安装到您的 IDE 中

2

重启 IDE

完全重启 IDE 才能使插件生效

3

验证安装

在 IDE 的集成终端中运行 claude 命令进行验证

JetBrains 集成效果

以下是 Claude Code 在 JetBrains IDEs 中的集成效果展示：

JetBrains Claude Code 集成效果
🔍 点击查看大图
ℹ️

自动安装选项

当您在集成终端中运行 claude 时，插件也可能会自动安装。必须完全重启 IDE 才能生效。

⚠️

远程开发限制

远程开发限制：使用 JetBrains 远程开发时，您必须通过 Settings > Plugin (Host) 在远程主机中安装插件。

支持的 JetBrains IDEs

PyCharm Python 开发
WebStorm Web 开发
IntelliJ IDEA Java 开发
GoLand Go 开发

配置说明

启用 IDE 特定功能

  1. 通过在内置终端中运行 claude 将 Claude Code 连接到您的 IDE
  2. 运行 /config 命令
  3. 将差异工具设置为 auto 以进行自动 IDE 检测
  4. Claude Code 将根据您的 IDE 自动使用适当的查看器

配置差异查看器

# 在 Claude Code 中运行
/config

# 找到差异工具设置并设置为：
diff_tool: auto

外部终端连接

如果您使用外部终端（而不是 IDE 的内置终端），您仍然可以在启动 Claude Code 后使用 /ide 命令连接到您的 IDE。

外部终端的优势：

  • 即使从单独的终端应用程序运行 Claude 时也能受益于 IDE 集成功能
  • 适用于 VS Code 和 JetBrains IDEs
  • 保持终端和 IDE 的独立性
💡

目录同步建议

使用外部终端时，为确保 Claude 默认访问与您的 IDE 相同的文件，请从与您的 IDE 项目根目录相同的目录启动 Claude。

故障排除

🔧 VS Code 扩展未安装

解决方案：

  • 确保您从 VS Code 的集成终端运行 Claude Code
  • 确保安装了与您的 IDE 对应的 CLI：
    • 对于 VS Code：code 命令应该可用
    • 对于 Cursor：cursor 命令应该可用
    • 对于 Windsurf：windsurf 命令应该可用
  • 如果未安装，使用 Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Windows/Linux）并搜索"Shell Command: Install 'code' command in PATH"
  • 检查 VS Code 是否有安装扩展的权限

🔧 JetBrains 插件不工作

解决方案：

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

🔧 常见问题

IDE 检测问题：

  • 确保 IDE 正在运行且项目已打开
  • 尝试重启 Claude Code 会话
  • 检查防火墙和安全软件设置

快捷键不工作：

  • 确认 IDE 插件已正确安装并启用
  • 检查是否与其他快捷键冲突
  • 尝试在 IDE 设置中重新配置快捷键

需要更多帮助？

如果以上解决方案都无法解决您的问题，请参考以下资源：

📖 完整故障排除指南 ❓ 常见问题FAQ 💬 联系技术支持

准备在 IDE 中使用 Claude Code？

立即集成到您喜爱的开发环境，开始更高效的编程之旅

立即开始使用 查看完整指南
×