· CLAUDE-CODE-FEATURE-RADAR · 2026.05.13 · 16 MIN ·

IDE 集成:VSCode + JetBrains 扩展

VSCode 扩展 GA、JetBrains 插件 Beta,跟 CLI 共享 ~/.claude/settings.json —— Claude Code 给非 terminal 用户的入口。 · by 思扬

AI · HERO seed:4220260513 VSCode 扩展 GA、JetBrains 插件 Beta,跟 CLI 共享 ~/.claude/settings.json —— Claude Code 给非 terminal 用户的入口。

FIG.00 — cover · ai-generated · placeholder

VSCode 原文:https://code.claude.com/docs/en/vs-code JetBrains 原文:https://code.claude.com/docs/en/jetbrains 覆盖 IDE:VSCode、Cursor、Windsurf、Kiro 等 VSCode forks · IntelliJ、PyCharm、Android Studio、WebStorm、PhpStorm、GoLand 官方定位:Native graphical interface for Claude Code, integrated directly into your IDE.

🔥 影响力卡片

维度	数据
VSCode 扩展要求	VS Code 1.98.0+
JetBrains plugin 状态	Beta(`plugins.jetbrains.com/plugin/27310-claude-code-beta-`)
VSCode 扩展 ID	`anthropic.claude-code`
安装入口	`vscode:extension/anthropic.claude-code` 直链 + JetBrains marketplace + Open VSX(给 fork 用)
跟 CLI 的关系	VSCode 扩展自带 CLI binary — `claude` 命令在 VSCode 内置 terminal 可用
共享配置	`~/.claude/settings.json` 在 CLI + VSCode + JetBrains 共用
URI scheme(VSCode)	`vscode://anthropic.claude-code/open?prompt=...&session=...`(可从 shell alias / bookmarklet 唤起)

🎯 为什么必读

1. 这是 Claude Code 给非 terminal 用户的入口。

很多人开发主战场是 VSCode / IntelliJ。Claude Code 的 CLI 再强,如果不能在 IDE 里 native 用,体验会被切碎。两个扩展都解决了这个。

2. VSCode 扩展是 Anthropic 着重投入的(JetBrains 还是 Beta)

差异极明显:

	VSCode 扩展	JetBrains plugin
状态	GA	Beta
图形面板	完整 GUI(diff / panel / plan review)	通过 terminal,不像 VSCode 那样独立 panel
多 session 标签	✅ Tabs + Windows	走 terminal,不强
Checkpoints(rewind)	✅	❌(需要 CLI)
Plugin 管理 GUI	✅ `/plugins` 图形界面	❌
Browser automation `@browser`	✅	❌
内置 MCP server(IDE bridge)	✅(`mcp__ide__getDiagnostics` 等)	部分

3. 对你的判断(memory 显示你重度用 terminal):

你最常用 Claude 的方式是 terminal。两个 IDE 扩展可能跟你关系不大 — 除非:

写前端时 VSCode 集成 + @browser(Chrome 扩展配合)
写 Kotlin / Java 时 IntelliJ 集成

否则 stay terminal 是高效选择。

一句话总结

VSCode 扩展 = 完整 Claude Code 体验 + diff GUI + checkpoints + 多 session;JetBrains plugin = 把 CLI 通过 terminal 桥接,加上 diff/selection/diagnostics 三个集成。两个都跟 claude CLI 共享 ~/.claude/settings.json,所以无缝切换。

💎 金句墙

★ “The extension includes the CLI (command-line interface), which you can access from VS Code’s integrated terminal.” “扩展包含 CLI — 在 VSCode 内置 terminal 可直接用。” —— 🟢 装 VSCode 扩展 = 也装 CLI。不需要分开 npm install

★ “Plugins and marketplaces you configure in the extension are also available in the CLI, and vice versa.” “你在扩展里装的 plugin / marketplace,CLI 也能用,反之亦然。” —— 🟢 单点配置 = 多 surface 共享。这就是 Claude Code 双 surface 的关键设计

★ “The extension also installs in other VS Code forks like Windsurf or Kiro.” “扩展也能装到 VS Code fork 比如 Windsurf 或 Kiro。” —— 🟢 Anthropic 不锁 fork — 跟 OpenVSX 兼容,等于跟 Cursor / Windsurf / Kiro 兼容

★ “Code changes can be displayed directly in the IDE diff viewer instead of the terminal.” (JetBrains) “代码变更可以直接在 IDE 的 diff viewer 显示,而不是 terminal。” —— 🟢 JetBrains plugin 最强卖点 — 用 IntelliJ 的 diff viewer,比 terminal diff 强得多

📋 核心精读

1. VSCode 扩展 — 4 个开 panel 的方式

方式 1: Spark 图标(Editor Toolbar)— 文件打开时右上角
方式 2: Activity Bar 左侧 Spark — sessions 列表(无文件也能开)
方式 3: Command Palette → "Claude Code: Open in New Tab"
方式 4: Status Bar 右下角 "✱ Claude Code"

panel 可以拖到任意位置:secondary sidebar(右)/ primary sidebar(左)/ editor area(标签页)。

2. VSCode 扩展独家特性(CLI 没有 / 难有)

a. Diff view + 在 diff 里直接编辑

Claude 想改文件 → side-by-side diff 弹出 → 你能在 diff view 里直接编辑 proposed change → 接受

Claude 会被告知你改过了,不会假设文件还是 original

b. Checkpoints — rewind

Hover 任何 message → “Rewind code to here” → 撤回到那一刻的文件状态(对话保留)

3 个选项:

Fork conversation from here(对话分叉,代码不变)
Rewind code to here(代码回滚,对话不变)
Fork conversation and rewind code(都回滚)

c. Plan mode 整页 markdown 文档化

/plan mode 时,plan 自动打开成 markdown 文档,你能加内联评论(像 PR review 一样)再让 Claude 继续。

d. Session 标签 + 多窗口

Cmd+Shift+Esc → Open in New Tab(新会话作为编辑器标签)
Command Palette → Open in New Window(新会话独立窗口)

每个 conversation 维护独立 context。

e. Resume remote sessions from Claude.ai

Session history → Remote tab → 看 claude.ai 上跑的 Claude Code on the Web sessions → 点一个 → 下载到本地继续。只有 GitHub repo 起的 web session 才会出现。

f. @browser 配合 Chrome 扩展

@browser go to localhost:3000 and check console for errors

跟 Chrome 扩展直接联动(本系列 03-chrome-extension.md)。

3. VSCode `@`-mention 用法

@auth                    # fuzzy match: auth.js, AuthService.ts, etc.
@src/components/         # 加 / 表示文件夹
@app.ts#5-10             # 行范围

快捷键 Option+K(Mac)/ Alt+K(Win/Linux):当前选中自动变成 @file.ts#5-10 形式插入。

4. VSCode 扩展跟 CLI 的功能对比

功能	CLI	VSCode 扩展
Commands / skills	全部	子集(`/` 看)
MCP server 配置	完整	通过 CLI 装,在 panel 里 `/mcp` 管理
Checkpoints	✅	✅
`!` Bash 快捷输入	✅	❌
Tab 补全	✅	❌

意味着:CLI 永远是 full power。VSCode 扩展是 90% + 图形化好处。

5. `vscode://anthropic.claude-code/open` URI handler(高级)

# 从 shell 唤起 VSCode 新开 Claude tab + 预填 prompt
open "vscode://anthropic.claude-code/open?prompt=review%20my%20changes"

# Linux:
xdg-open "vscode://..."

# Windows PowerShell:
Start-Process "vscode://..."

参数:

prompt — 预填 prompt(URL-encoded),不自动 submit
session — 指定 session ID 恢复

实用场景:写 git hook 在 commit 后自动开 VSCode + Claude 检查,或浏览器 bookmarklet 一键问 Claude 当前页面。

6. JetBrains plugin — 4 个核心特性

特性	说明
快捷启动	`Cmd+Esc` / `Ctrl+Esc` 从 editor 打开 Claude Code
Diff viewing	改动在 IntelliJ 的 diff viewer 显示(比 terminal 强)
Selection context	当前选中 / 当前 tab 自动共享给 Claude
Diagnostics sharing	IDE 的 lint / 语法错误自动传给 Claude
File reference	`Cmd+Option+K` / `Alt+Ctrl+K` 插入 `@src/auth.ts#L1-99`

跟 VSCode 扩展比少了:GUI panel、checkpoints UI、plugin 管理 GUI、@browser。

7. JetBrains 用法 — 跟 CLI 强耦合

方式 1: 在 IDE 内置 terminal 跑 `claude` → 集成自动激活
方式 2: 外部 terminal 跑 `claude` → `/ide` 命令连接当前 IDE

不像 VSCode — 没独立 panel,实际就是”装 plugin 之后,你 terminal 里的 claude 多 4 个集成特性”。

8. JetBrains plugin 设置

Settings → Tools → Claude Code [Beta]:

Claude command:自定义命令(默认 claude,WSL 用户改 wsl -d Ubuntu -- bash -lic "claude")
Auto updates:自动更新 plugin
ESC 键配置:防止 ESC 被 IDE 的 “Move focus to editor” 抢走 — Settings → Tools → Terminal → 取消 “Move focus to the editor with Escape”

9. Remote Development 注意

JetBrains Remote Development(SSH 远程开发):

⚠️ 必须装在 remote host,不是本地客户端。Settings → Plugin (Host)。

10. WSL 用户的 JetBrains 配置(常见坑)

JetBrains plugin 在 WSL2 看不到 IDE,因为 WSL2 NAT 网络。

解 1:Windows 防火墙加规则(推荐)

# 在 PowerShell admin 跑(IP 范围调成你的 WSL2 subnet):
New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" \
  -Direction Inbound -Protocol TCP -Action Allow \
  -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16

解 2:换 WSL2 镜像网络模式(需要 Win 11 22H2+)

# %USERPROFILE%\.wslconfig
[wsl2]
networkingMode=mirrored

然后 wsl --shutdown。

11. VSCode 扩展的安全模型(必懂)

启用 auto-edit 后,Claude 可以改 VSCode 配置文件(settings.json、tasks.json)— VSCode 会自动执行这些文件里某些内容。

结论:不要在不可信代码上用 auto-edit。建议:

✅ 不可信代码用 Restricted Mode
✅ Auto-edit 关掉,用手动 approval
✅ 仔细 review 每个 edit

12. VSCode 扩展隐藏的”IDE MCP server”

扩展激活时,本地起了一个 MCP server,CLI 自动连上。这是 CLI 能用 VSCode native diff viewer / 读 selection / 执行 notebook 的原理。

名字:ide(在 /mcp 看不到,因为没东西配)
绑定 127.0.0.1 随机端口
随机 token 写到 ~/.claude/ide/ 文件(0600 权限)
工具:
- mcp__ide__getDiagnostics — 读 VSCode 的 Problems panel
- mcp__ide__executeCode — Jupyter notebook 执行 cell(总弹 Quick Pick 确认,绝不静默)
- 还有 10+ 内部 RPC 工具(不暴露给 Claude)

实务:如果你写 PreToolUse hook 限制 MCP 工具白名单,要把 mcp__ide__* 加进去。

🟢 译者总评

1. VSCode 扩展是”Cursor / Windsurf 用户的迁徙桥”

很多人原来用 Cursor / Windsurf,想试 Claude Code 但又不想脱离 IDE 体验。Claude Code VSCode 扩展把这条路打开:装到 Cursor 也行(因为 Cursor 是 VSCode fork)。

很多 Cursor 用户实际是 Cursor + Claude Code 扩展共存 — Cursor 做基础 AI 补全,Claude Code 做复杂任务。

2. JetBrains plugin 还在 Beta — 别太指望

Anthropic 显然把投入压在 VSCode。JetBrains plugin 功能少很多。如果你重度 IntelliJ,目前的最佳实践是:

装 JetBrains plugin 拿基础集成(diff view / selection)
主要在 IntelliJ 内置 terminal 跑 claude CLI
等 JetBrains plugin GA

3. URI handler 是被低估的能力

vscode://anthropic.claude-code/open?prompt=... 允许任何东西一键唤起 Claude session。可以:

在浏览器 bookmark bar 放 “Ask Claude about this URL” 按钮
在 git pre-push hook 自动开 Claude 检查
跟 macOS Shortcuts / Alfred / Raycast 集成

4. 给你的具体建议(独立开发者)

你的情况	建议
主要在 terminal 写代码	不装(已经在 CLI 用了,够)
偶尔 VSCode 做前端 / 看 PR	装 VSCode 扩展(轻量)
IntelliJ 写 Kotlin / Android	装 JetBrains plugin + 主要在 terminal 用
团队混合 IDE,有人 VSCode 有人 IntelliJ	写 CLAUDE.md 时假设 CLI 是主入口(IDE 扩展是锦上添花)

5. 警惕的反模式

❌ VSCode 扩展 + JetBrains plugin 都装 + 还有 CLI → 配置 drift 风险(实际不会,因为共享 settings.json,但心智上要清楚)
❌ 在 VSCode 里期望所有 CLI 命令都有 → 文档明确说 “subset”
❌ auto-edit + 改 VSCode tasks.json → 可能被 VSCode 自动执行 → 安全风险

🔗 延伸阅读

同系列:02-remote-control.md(VSCode 扩展也支持 RC,用 /remote-control)、03-chrome-extension.md(VSCode 里 @browser 自动用 Chrome 扩展)
官方:/en/checkpointing — VSCode 的 rewind 详细机制
官方:/en/deep-links — claude-cli:// 唤起 terminal session(VSCode URI 的兄弟)
官方:/en/sessions — session 管理

🔗 调研来源(可校验)

主原文 1:https://code.claude.com/docs/en/vs-code
主原文 2:https://code.claude.com/docs/en/jetbrains
内置 IDE MCP server 的工具名:mcp__ide__getDiagnostics、mcp__ide__executeCode(本机如果装了扩展,/mcp 里能看到 ide server)
VSCode 扩展 ID:anthropic.claude-code(JetBrains plugin ID 27310)
WSL2 配置:文档明确给出 PowerShell 防火墙规则 + .wslconfig 两条方案