Claude Code IDE 集成实战：VS Code 与 JetBrains 怎么选、怎么配

来源：Claude Code Docs: VS Code · Claude Code Docs: JetBrains IDEs · Visual Studio Marketplace: Claude Code · Claude Code Docs: Quickstart | 整理时间：2026-04-29

为什么要在 IDE 里用 Claude Code？

很多人第一次接触 Claude Code，是从终端里的 claude 开始的。但到 2026 年，VS Code 和 JetBrains 插件已经足够成熟，Claude Code 不再只是“命令行助手”，而是可以直接嵌进日常编辑器工作流。

对多数开发者来说，IDE 集成的价值不在于替代 CLI，而是把下面几件事变得更顺手：

• 直接在编辑器里发起会话，不用频繁切回终端
• 用 IDE 原生 diff 视图审查修改
• 自动把当前选中代码、诊断信息和文件路径带给 Claude
• 让 Claude 和你现有的编码、调试、审查流程合并在一起

如果你已经会用 CLI，那么 IDE 集成更像是“更顺手的前端”。

VS Code 和 JetBrains 的定位差异

简单判断：

• 如果你本来就在用 VS Code，直接用官方扩展即可。
• 如果你主力是 IntelliJ、PyCharm、WebStorm，JetBrains 插件更自然。
• 如果你经常做复杂自动化、MCP 配置、并行 worktree，CLI 仍然要保留。

前置条件

VS Code

• VS Code 1.98.0 或更高版本
• Claude 账号，或 Bedrock / Vertex AI / Microsoft Foundry 等第三方提供商配置
• 能正常联网并完成登录

JetBrains

• 已安装受支持的 JetBrains IDE，例如 IntelliJ IDEA、PyCharm、WebStorm、GoLand、PhpStorm
• 本地可执行 claude 命令
• 项目最好从 IDE 的项目根目录启动

通用建议

先确认 CLI 是通的，再接 IDE。最小检查顺序：

claude --version
cd /path/to/project
claude

如果 CLI 本身都没有装好，IDE 里的问题通常只是表象。

在 VS Code 中使用 Claude Code

安装

1. 打开扩展市场，搜索 Claude Code
2. 安装官方扩展 anthropic.claude-code
3. 如果安装后面板没出现，执行 Developer: Reload Window

也可以直接从 Marketplace 安装：

anthropic.claude-code

进入方式

VS Code 里常见的三个入口：

• 编辑器右上角的 Spark 图标
• Activity Bar 左侧会话入口
• Command Palette 中的 Claude Code 命令

第一次打开时需要登录。完成后，你会看到图形面板，而不是纯终端界面。

VS Code 体验的关键点

常用操作示例

@src/auth/ explain this login flow
review my current changes
create a plan to refactor the billing module
@terminal:npm test explain why these tests failed

VS Code 特别适合什么？

• 看计划和 diff
• 快速解释某段代码
• 基于当前选择生成修改
• 边写边开多个会话做并行探索

如果你是习惯侧边栏 + 编辑器标签页的开发者，这个体验会比纯终端友好得多。

在 JetBrains 中使用 Claude Code

JetBrains 的集成思路和 VS Code 不完全一样。它更像是：保留 JetBrains 作为主工作台，让 Claude Code 通过插件和 CLI 接入这个工作台。

安装

1. 打开 Settings -> Plugins -> Marketplace
2. 搜索 Claude Code [Beta]
3. 安装并重启 IDE

使用方式

最稳的方式是在 IDE 自带终端里运行：

claude

如果你是在外部终端运行 Claude，可以在会话里执行：

/ide

这样 Claude 会连接到当前 JetBrains IDE，启用 diff、选区上下文和诊断共享等能力。

JetBrains 集成的优势

JetBrains 的典型问题

• 插件装了，但 claude 没有在 IDE 内启动
• 从非项目根目录运行，导致上下文不完整
• 远程开发时插件装在本地而不是远端 host
• WSL / 防火墙导致 IDE 发现失败

对于 JetBrains 用户，最常见的误区是把它当成“纯插件产品”。实际上它仍然高度依赖 Claude CLI。

IDE 集成和 CLI 到底是什么关系？

这是最容易混淆的一点。

结论先说

• CLI 是核心运行时
• IDE 是图形化入口和上下文桥接层

Claude 在 IDE 里能看见你的选择、显示 diff、接收诊断、打开多标签，并不是因为 IDE 自己实现了一套全新 Claude，而是因为 IDE 插件和 CLI 在协作。

什么时候优先用 IDE？

• 你想看计划再决定
• 你要细看每个 diff
• 你正在围绕当前文件或当前错误快速迭代
• 你更依赖图形界面而不是命令行

什么时候还是回 CLI？

• 你要配 MCP 服务器
• 你要跑更完整的命令链
• 你需要 worktree 并行任务
• 你依赖终端输出、shell 行为和脚本自动化
• 你要用扩展里没有暴露出来的 CLI-only 能力

一个比较稳妥的组合是：

1. 用 IDE 发起分析和审查
2. 用 IDE 看计划和 diff
3. 遇到进阶配置时切回 CLI

推荐工作流

工作流 1：解释和改小块代码

1. 在 IDE 里选中一段代码
2. 直接发问，让 Claude 解释逻辑
3. 再追加“按这个方向修改”
4. 在 diff 视图里确认修改

适合：局部重构、修一个明显问题、生成测试。

工作流 2：先规划再动手

1. 用 Plan mode 让 Claude 先写计划
2. 在 IDE 里逐条评论计划
3. 确认后再执行

适合：中型功能、结构性调整、影响多个文件的改动。

工作流 3：IDE 做前台，CLI 做后台

1. 在 IDE 中开始会话
2. 需要进阶命令时切到集成终端运行 claude
3. 用同一会话历史继续推进

这比纯切换工具顺手，因为官方文档里也明确说明了扩展和 CLI 会共享历史。

常见问题

1. VS Code 里看不到 Spark 图标

先检查：

• 是否打开了具体文件，而不只是文件夹
• VS Code 是否达到最低版本
• 是否在 Restricted Mode
• 是否被其他 AI 扩展冲突影响

2. 一直提示登录

如果你已经设置了 ANTHROPIC_API_KEY 却还是提示登录，通常是 IDE 没继承你的 shell 环境。官方建议之一是从终端里用 code . 启动 VS Code，或者直接完成账号登录。

3. JetBrains 里提示找不到 IDE

优先检查：

• 插件是否真的启用
• 是否在 IDE 内置终端运行 claude
• 是否从项目根目录启动
• Remote Development 场景下插件是否装在 remote host

4. 长任务在 IDE 里看不清状态

VS Code 文档明确提到，后台长命令的可见性通常不如 CLI。遇到这类任务，最好让 Claude 把命令打印出来，再放到集成终端里跑。

安全和权限建议

IDE 集成很方便，但也意味着 Claude 更贴近你的真实开发环境。

建议：

1. 对陌生项目默认用手动确认模式
2. 不要在不可信工作区开启自动接受修改
3. 认真审查配置文件类改动，尤其是 settings.json、任务脚本、构建脚本
4. 真正要高权限自动化时，优先在隔离环境里执行

这类建议在 VS Code 和 JetBrains 官方文档里都反复出现，原因很简单：IDE 配置文件本身也可能触发后续执行行为。

怎么选？

最终结论其实不复杂：不要把 IDE 集成理解为 Claude Code 的替代品，而要把它理解成 Claude Code 更适合日常开发的一层界面。

相关链接

• Claude Code 概述
• Claude Code 快速入门
• 最佳实践
• 常见工作流
• MCP 集成
• VS Code 文档：https://code.claude.com/docs/en/vs-code
• JetBrains 文档：https://code.claude.com/docs/en/jetbrains
• VS Code 插件市场：https://marketplace.visualstudio.com/items?itemName=anthropic.claude-code