25. IDE 集成

本节目标：搞清楚 Claude Code 怎么塞进 VS Code、Cursor 和 JetBrains IDE，学会装扩展、用面板、看内联 diff（Inline Diff）、切权限模式。学完你能在编辑器里直接用 Claude Code，不用切窗口。

为什么要集成到 IDE

前面那么多章你都在终端里用 claude，跑得好好的。那你可能想：为什么还要往 IDE 里塞？

打个比方：终端里的 Claude Code 像你叫了个外卖小哥—你得切到门口去取。IDE 集成像外卖小哥直接送进你工位—你看代码、改代码、看 diff，全程不挪窝。

具体好处有这么几个：

diff 直接在编辑器的差异查看器里看，不用盯着终端的纯文本对比
选中的代码自动当上下文，你高亮哪几行，Claude 就看哪几行
IDE 的诊断信息（报错、警告）自动共享给 Claude，不用复制粘贴报错
文件引用用 @-提及，输 @ 加文件名就行，支持模糊匹配

VS Code 扩展

VS Code 扩展是官方推荐的在 VS Code 里用 Claude Code 的方式。它提供了原生图形界面，直接集成进你的编辑器。

装扩展之前

确保你有：

VS Code 1.98.0 或更高版本
Anthropic 账户：任何付费 Claude 订阅（Pro/Max/Team/Enterprise）或 Claude Console 账户都行，不需要 API 密钥

Note

扩展自带一份 CLI 副本用于聊天面板。但要在 VS Code 的集成终端里直接敲 claude，你还得单独装 CLI（npm install -g @anthropic-ai/claude-code）。扩展不会把 claude 加到你的 PATH 里。

安装扩展

两种方式：

在 VS Code 里按 Cmd+Shift+X（Mac）或 Ctrl+Shift+X（Windows/Linux）打开扩展视图，搜「Claude Code」，点安装
直接到 VS Code Marketplace 装

Cursor 用户也一样：在 Cursor 的扩展视图里搜「Claude Code」装，或者从 Cursor 扩展市场装。

Tip

装完如果扩展没出现，重启 VS Code，或从命令面板（Cmd+Shift+P/Ctrl+Shift+P）跑「Developer: Reload Window」。

打开 Claude Code 面板

扩展装好后，VS Code 里会出现一个 Spark（火花）图标，代表 Claude Code。打开方式有四种：

编辑器工具栏：打开任意文件后，编辑器右上角会出现 Spark 图标，点它最快
活动栏：左侧边栏的 Spark 图标，点开是会话列表，能开始新会话或恢复旧的
命令面板：Cmd+Shift+P/Ctrl+Shift+P，输「Claude Code」，选「在新选项卡中打开」
状态栏：右下角的「✱ Claude Code」，没打开文件也能用

你可以拖动 Claude 面板重新定位—拖到次级边栏（右侧）、主边栏（左侧）或编辑器区域（当选项卡）。Claude 会记住你上次放的位置。

登录和发第一条消息

首次打开面板会出现登录界面，点登录，在浏览器里完成授权。

登录后会出现一个「学习 Claude Code」检查清单，跟着过一遍或关掉都行。

发消息就这么简单：

> 解释一下这个文件里的认证逻辑
> 帮我修一下这个报错

Tip

你在编辑器里选中的文本，Claude 能自动看到。提示框底部会显示选了多少行。按 Option+K（Mac）/ Alt+K（Windows/Linux）能插入带文件路径和行号的 @-提及引用，比如 @app.ts#5-10。

内联 diff 和权限模式

Claude 想改文件时，VS Code 扩展会显示原始内容和建议改动的并排对比，然后问你行不行。你能接受、拒绝，或者让它换一种改法。

如果你在点接受之前直接在 diff 视图里改了建议的内容，Claude 会收到通知—你改了它的提案，它不会假设文件跟它原来提的一样。这个细节很重要，避免它「自作主张」。

提示框底部有个权限模式指示器，点它能切换模式：

模式	行为
Manual（手动）	Claude 在文件编辑和大多数 shell 命令前问你
Plan（计划）	Claude 先描述要干什么，等你批准再动手。VS Code 会把计划当 Markdown 文档打开，你能加内联注释给反馈
Edit automatically（自动编辑）	Claude 直接改，不问

Warning

自动编辑模式下，Claude 能改 VS Code 的配置文件（如 settings.json 或 tasks.json），而 VS Code 可能会自动执行这些配置。处理不受信任的代码时，建议用手动模式，并开启 VS Code 的受限模式。

@-提及引用文件

@-提及是 IDE 集成里最好用的功能之一。输 @ 加文件或文件夹名，Claude 就会读取那个内容。它支持模糊匹配：

> 解释一下 @auth 里的逻辑
> @src/components/ 里有哪些组件？

文件夹要在后面加斜杠（@src/components/）。

几个进阶用法：

大 PDF：能让 Claude 只读特定页，比如「读 @report.pdf 第 1-10 页」
选中代码：你在编辑器里选文本，Claude 自动看到。提示框底部显示选了多少行，眼睛斜线图标表示选择对 Claude 隐藏
拖拽附件：按住 Shift 把文件拖到提示框，能加为附件
终端输出：用 @terminal:name 引用终端输出，name 是终端标题

会话历史和多会话

点面板顶部的会话历史按钮，能看到所有对话历史。能按关键字搜，也能按时间浏览（今天、昨天、过去 7 天）。新会话会根据你的第一条消息自动起标题。

如果你想同时开多个会话并行干活，从命令面板用「在新选项卡中打开」或「在新窗口中打开」。每个会话有自己的历史和上下文。

选项卡上的小彩色点表示状态：蓝色表示有权限请求等你处理，橙色表示 Claude 在选项卡隐藏时干完了活。

从 Claude.ai 恢复远程会话

如果你用过 Web 版（claude.ai/code），能直接在 VS Code 里恢复那些远程会话。需要用 Claude.ai 订阅登录（不是 Console）。会话历史对话框里有「本地」和「远程」两个选项卡，点远程就能看到 claude.ai 上的会话。

Note

只有用 GitHub 仓库启动的 Web 会话才会出现在远程选项卡。恢复后改动不会同步回 claude.ai。

常用快捷键

命令	快捷键	说明
切换焦点	`Cmd+Esc`/`Ctrl+Esc`	在编辑器和 Claude 之间切换焦点
新选项卡打开	`Cmd+Shift+Esc`/`Ctrl+Shift+Esc`	把新对话当编辑器选项卡打开
新对话	`Cmd+N`/`Ctrl+N`	需 Claude 获得焦点且开启对应设置
插入 @-提及	`Option+K`/`Alt+K`	插入当前文件和选择的引用（需编辑器获焦点）
重新打开已关闭会话	`Cmd+Shift+T`/`Ctrl+Shift+T`	重新打开最近关闭的 Claude 会话选项卡
多行输入	`Shift+Enter`	输入框里换行不发送

Tip

macOS Tahoe 及以上版本，Cmd+Esc 可能被系统的游戏覆盖快捷键拦截。去系统设置 → 键盘 → 键盘快捷键 → 游戏控制器，清掉那个复选框。或者在 VS Code 键盘快捷键编辑器里给「Claude Code: Focus input」换个键。

CLI 和扩展的区别

这俩共享对话历史，但功能范围不一样。简单说：

功能	CLI	VS Code 扩展
命令和技能（Skill）	全部	子集（输 `/` 看可用的）
MCP 服务器配置	是	部分（用 CLI 加服务器，面板里 `/mcp` 管理）
检查点（Checkpoint）	是	是
`!` bash 快捷键	是	否
Tab 补全	是	否

在 VS Code 里想用 CLI 的功能？开集成终端（Ctrl+` 或 Cmd+`），直接敲 claude。CLI 会自动跟 IDE 集成，获得 diff 查看和诊断共享等功能。

如果你在外部终端用 CLI，跑 /ide 命令能把它连到 VS Code：

claude

/ide

扩展和 CLI 共享对话历史。在 CLI 里继续扩展的对话，跑 claude --resume，会弹出交互式选择器让你挑。

JetBrains IDE 集成

Claude Code 也能集成进 JetBrains 家的 IDE，支持 IntelliJ IDEA、PyCharm、Android Studio、WebStorm、PhpStorm、GoLand 等。

安装

跟 VS Code 扩展不一样，JetBrains 插件不自带 CLI 副本，你得先装 CLI：

装 Claude Code CLI（npm install -g @anthropic-ai/claude-code），确保 claude 在 PATH 里
从 JetBrains Marketplace 装 Claude Code 插件
重启 IDE

Warning

插件装完可能需要完全重启 IDE 才生效。如果 claude 装在 IDE 找不到的地方，去 Settings → Tools → Claude Code [Beta] → Claude 命令里设完整路径。

使用方式

从 IDE 的集成终端跑 claude，所有集成功能就激活了。如果从外部终端用，跑 /ide 命令连接到 JetBrains IDE。

JetBrains 集成提供这些功能：

快速启动：Cmd+Esc（Mac）或 Ctrl+Esc（Windows/Linux）直接从编辑器打开 Claude Code
diff 查看：代码改动直接在 IDE 的 diff 查看器里显示
选择上下文：当前选择或标签页自动共享给 Claude
文件引用：Cmd+Option+K（Mac）或 Alt+Ctrl+K（Linux/Windows）插入文件引用
诊断共享：IDE 里的 lint 和语法错误自动共享给 Claude

配置 diff 显示位置

在 Claude Code 里跑 /config，把差异工具设为 auto（在 IDE 里显示）或 terminal（在终端里显示）。

ESC 键的问题

JetBrains 终端里 ESC 键可能无法中断 Claude Code 操作。修复方法：

Settings → Tools → Terminal
取消勾选「使用 Escape 将焦点移动到编辑器」，或点「配置终端快捷键」删掉「切换焦点到编辑器」快捷方式

内置 IDE MCP 服务器

不管你用 VS Code 还是 JetBrains，扩展激活时都会跑一个本地的 MCP 服务器，名叫 ide。CLI 会自动连上它。

这就是 CLI 怎么在 IDE 的原生 diff 查看器里打开 diff、读取你当前的 @-提及选择、拉取诊断信息的方式。

Note

这个 ide 服务器在 /mcp 里是隐藏的，因为没什么要配置的。但如果你的组织用 PreToolUse 钩子（Hook）做 MCP 工具白名单，得知道它存在。

它对模型暴露的工具只有一两个：

工具名	作用	只读
`mcp__ide__getDiagnostics`	返回语言服务器诊断（错误和警告）	是
`mcp__ide__executeCode`（仅 VS Code）	在活动 Jupyter notebook 内核里跑 Python	否

VS Code 的 Jupyter 执行工具每次都会先问你「执行」还是「取消」—不会静默跑任何东西。

安全细节：服务器绑定在 127.0.0.1 的随机端口上，传输是未加密的 ws://。但因为只限本地回环，能截流量的进程也能从锁文件里读令牌，所以 TLS 不会增加保护。每次激活生成新的随机令牌，写在 ~/.claude/ide/<port>.lock 里。

第三方提供商

如果你的组织用 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 来访问 Claude，配置方式跟默认不一样：

在 VS Code 设置里勾选「禁用登录提示」（disableLoginPrompt）
按对应提供商的指南在 ~/.claude/settings.json 里配置

这些设置在扩展和 CLI 之间共享。

Note

企业部署（Bedrock/Vertex/Foundry）属于进阶可选内容，本教程点到为止，不展开。

常见问题排查

Spark 图标看不到：图标只在打开文件时出现在编辑器工具栏。检查 VS Code 版本（需 1.98.0+），重启窗口，临时禁用其他 AI 扩展（Cline、Continue 等），检查工作区信任。

扩展装不上：确保 VS Code 版本够新，检查权限，试试从 Marketplace 直接装。

Claude Code 从不响应：检查网络连接，开新对话试试，从终端跑 claude 看有没有更详细的错误。

JetBrains「未检测到可用的 IDE」：验证插件装了且启用，完全重启 IDE，确认从集成终端跑 Claude Code。WSL2 用户可能是网络问题—WSL2 的 NAT 网络或 Windows 防火墙挡了 WSL2 和 Windows 主机上 IDE 的连接。

Tip

WSL2 用户的推荐修复：给 Windows 防火墙加条规则放行 WSL2 子网流量，或者把 WSL2 切到镜像网络模式（需 Windows 11 22H2+，在 .wslconfig 里设 networkingMode=mirrored）。

小结

VS Code 扩展自带 CLI 副本，图形面板开箱即用；JetBrains 插件需先装 CLI
内联 diff在编辑器的差异查看器里显示，你能在接受前直接改建议内容
@-提及引用文件和文件夹，支持模糊匹配；选中代码自动当上下文
权限模式：手动/计划/自动编辑，在提示框底部切换
CLI 和扩展共享历史，但 CLI 功能更全；在 VS Code 集成终端跑 claude 两边都能用
内置 ide MCP 服务器：让 CLI 能用 IDE 的 diff 查看器和诊断信息

下一章讲桌面应用和 Web 版—不碰终端、不开 IDE 也能用 Claude Code 的两种方式。