装好插件，找到按钮，点一下，第一印象通常是这样的：这是一种不用切换到单独的终端窗口就能启动 claude 的方式。方便当然是方便。可要是只为了一个按钮就专门装个插件，那就有点奇怪了。
这个印象其实并不准确。IDE 里的终端早在插件出现之前就有了，您完全可以自己在里面输入 claude。插件做的是另一件事：它把智能体和编辑器连起来，让双方能看到彼此。您打开了什么、选中了什么，linter 在报什么错，建议的修改逐行看是什么样子，这些都不再需要您自己去转述。一键启动反倒是整套功能里最无聊的那一项。
Claude Code 本身是个终端工具，没有 IDE 也照样好用：打开终端，输入 claude，接下来用平常说话的方式写就行。
区别不在于智能体能不能启动，而在于您拿什么来检查它的工作。它是实打实地在修改磁盘上的文件。编辑器关着的时候，您手里只有一份报告："给三个方法加上了错误处理"。听起来挺像回事，可没有东西能拿来对照。
插件补上的正是这个缺口。下面来看看它能带来什么，以及大家最常在哪里栽跟头。
1. 与编辑器联动能带来什么
官方插件能做五件事。按顺序说，先从最初催生这个插件的那一项讲起。
- IDE 窗口中的 diff。diff 就是一份改动清单：删掉了哪些行，加了哪些行，旧版本和新版本之间有什么变化。智能体的修改会在您熟悉的编辑器 diff 查看器里打开，而不是以文本形式出现在终端里。左边是改之前，右边是改之后。
- 选区上下文。当前打开的标签页和选中的代码片段会自动发给智能体。不用把代码复制到对话里，再用文字解释您说的是哪一段。
- 把代码发给智能体。选中一段代码，按下快捷键，提示词里就会出现一个正好指向这几行的引用，形如
@src/auth.ts#L1-99。 - 来自 IDE 的诊断信息。编辑器用红线标出的 linter 错误和语法错误，Claude 可以自己向 IDE 获取，不需要您再转述一遍。这项功能通常是大家最后才发现的，但它恰恰是最有用的功能之一。不过它不会在每次修改后自动检查这些错误，所以需要的话，直接让它看一下文件里的错误就行。
- 快速启动。点一下 IDE 面板上的 Claude 图标或者按快捷键，不用离开编辑器就能打开智能体。
2. 安装：是两部分，不是一部分
大家最常在这里栽跟头。插件里并没有自带 Claude Code。它是在 IDE 的集成终端里运行 claude 命令，再与它建立连接。所以两部分都要装：
- Claude Code 本身，如果没装，插件会直接告诉您
Cannot launch Claude Code； - Anthropic PBC 出品的 Claude Code [Beta] 插件，从
Marketplace安装，装好之后最好把 IDE 完全重启一次，有时一次还不够。
如果 claude 已经装好，但不在 IDE 查找的位置，就在 Settings → Tools → Claude Code [Beta] → Claude command 里填上完整路径。
3. 一上手就要用到的快捷键
| 操作 | Windows / Linux | macOS |
|---|---|---|
| 打开 Claude Code | Ctrl+Esc | Cmd+Esc |
| 把选中的代码发给智能体 | Ctrl+Alt+K | Cmd+Option+K |
| 快捷键没反应时打开 Claude Code | 点击 IDE 面板上的 Claude 图标 | |
表格最后一行可不是摆设。快捷键并不总能生效：组合键有时被系统截走，有时被别的插件截走。这不是故障，也用不着去修 IDE，直接用鼠标点开就行。这个办法慢一点，但在哪儿都管用。
不用找太久：插件的图标就是 Claude 的标志，和界面里其他地方的一模一样，不会认错。
Send to Claude Code
第二个快捷键用得最多。选中一段代码，按 Ctrl+Alt+K，智能体的提示词里就会跳出一个正好指向这几行的引用。选区的操作菜单里也有同样的功能，就是 Send to Claude Code 这一项。
提示词里会出现这样一行，也就是文件路径加上行号范围：
@presentations/assets/slides.css#L29-30接着在后面用平常的话把任务写上：
@presentations/assets/slides.css#L29-30 去掉 margin-left，窄屏上布局就是因为它才错位的双方都省事：智能体不用多走几步去找文件，您也不用为这番查找消耗上下文。
如果没有装插件
用 IDE 自带的功能也能拿到指向某一行的引用：在这一行上右键，选 Copy / Paste Special，再选 Copy Reference。剪贴板里就会是 src/utils/slides.js:16。
格式不一样：没有 @，用的是冒号。这就不再是自动把文件放进上下文了，只是请求里的一段文字。不过当作"看这里"的提示还是管用的：智能体会读到路径，自己打开对应的位置。
4. 两种启动方式和 /ide 命令
从 IDE 内置终端启动 claude，所有功能都会自动开启，什么都不用做。
要是从外部终端启动（单独的窗口、Windows Terminal、iTerm），在您输入下面这条命令之前，它和编辑器之间是没有连接的：
# 把 Claude Code 连接到已打开的 IDE
/ide我的建议是干脆养成习惯，一律从 IDE 的终端启动智能体。这样就完全不用惦记 /ide 了：只有一种情况需要它，就是用外部终端的时候。
还要注意从哪个文件夹启动。智能体看的是它启动位置下的文件，如果从旁边的文件夹启动，它处理的就不是您要的那些文件。在自己的项目里，请从项目根目录启动，也就是 IDE 里打开的那个目录。
做课程任务时情况不同：请从任务文件夹启动智能体，而不是从 codegym-project 的根目录启动。那里的每个任务都是一个单独的文件夹，有自己的文件和给智能体的规则；如果从项目根目录启动，整个课程会一下子全部进入智能体的视野。
5. diff 显示在哪里
改动具体显示在哪里，是一项设置，而不是固定不变的：
# 打开 Claude Code 设置
/config里面有一个 diff tool 选项：值为 auto 时在 IDE 里显示修改，值为 terminal 时留在终端里显示。这个选项只有在智能体连接到 IDE 时才会出现，所以如果您是从外部终端启动的，请先执行 /ide。如果 diff 怎么都只在终端里显示，就该来这里看看，而不是去插件里找故障。
在终端里，diff 是以文本形式出现的，大致是这样：
diff --git a/src/main/java/RefundQueue.java b/src/main/java/RefundQueue.java
index 3a7f2bc..9d41a80 100644
--- a/src/main/java/RefundQueue.java
+++ b/src/main/java/RefundQueue.java
@@ -42,7 +42,7 @@ void prioritize(RefundRequest refundRequest) {
- if (refundRequest.isUrgent()) {
+ if (refundRequest.isUrgent() || refundRequest.amount() > 100) {
moveToTop(refundRequest);
}
}这样读：带减号的行是原来的，带加号的行是改后的。其余都是辅助性的头信息：显示的是哪个文件，片段从第几行开始。
下面才是值得打开 IDE 显示的真正原因。在 Claude 每次修改前都要征求许可的模式下，询问不只是以文本形式出现在终端里：IDEA 会在内置的 diff 窗口里打开这处改动，并提供 Reject 和 Apply 两个按钮。您可以结合整个文件看这些高亮的行，然后当场做决定。
跟控制台里的文本 diff 相比，这根本不是一个档次：有语法高亮，有上下文代码行，还有熟悉的导航方式。"接受还是不接受"是看着代码决定的，而不是看着对代码的描述。
6. 三个常见的坑
Esc 打断不了智能体
在 JetBrains 的终端里，Esc 键默认会把焦点切回编辑器，所以根本到不了 Claude Code。这种情况很让人头疼：智能体在做不该做的事，您按下 Esc，却什么也没发生。
设置一次就能解决：打开 Settings → Tools → Terminal，取消勾选 Move focus to the editor with Escape。我的建议是装完插件马上就改，别等第一次碰上再说。
"No available IDEs detected"
智能体看不到编辑器。请按顺序检查：插件已安装并启用；IDE 已经完全重启；claude 是从内置终端启动的，而不是从外部窗口。
WSL：智能体在 Linux 里，IDE 在 Windows 里
这是同一个错误的特殊情况。如果 Claude Code 运行在 WSL2 里，而 IDE 在 Windows 里，挡住连接的通常是 WSL2 的网络隔离或者防火墙。解决办法是加一条防火墙规则，或者把 WSL2 切换到 mirrored networking 模式，这两种方法插件文档里都有详细说明。mirrored networking 只在 Windows 11 22H2 及更高版本中可用，在 Windows 10 上只能使用防火墙规则。
7. 这一切是为了什么
与 IDE 联动带来的最重要的一点是：智能体在做什么，您能在它做的同时看到。接下来的流程是这样的：
- Claude 提出一处修改；
- 您查看 diff，决定接受还是不接受；
- Git 记录下您接受的内容。
第三步在这里只是点到为止。Git 的工作流程、提交和回滚是一个单独的大话题，课程后面还会讲到。眼下只要记住一点：保存点出现在您检查之后，而不是之前。
这个循环只有在示意图上才这么整齐。实际干活时，一半的修改您看都不看就会接受，因为那不过是给变量改个名；而在另一处修改上您可能会卡上十分钟，最后让它重做。这很正常。重点不是逐行细读，而是在某处修改看起来不对劲的时候，您有办法去细看。
没有编辑器，就根本没有这个办法：只能对照描述来核实，而不是对照代码。
在 IDEA 里打开任意一个项目，点击面板上的 Claude 图标。快捷键 Ctrl+Esc（macOS 上是 Cmd+Esc）作用相同，但不一定每次都生效，这种情况确实会有，那就直接用鼠标。
接着在文件里选中几行，按下 Ctrl+Alt+K，指向这几行的引用会自动跳进提示词。让它做点小事，比如"给这个方法加个注释"。看看这处修改是怎样在 diff 窗口里打开的，然后点 Reject。会拒绝，也是一项本事。
GO TO FULL VERSION