异步视界博客
iaieye.com

最近更新

    ↑↓ 选择↵ 打开esc 关闭

    IDE 集成:VSCode + JetBrains 扩展

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

    • Claude Code 功… · 13/16
    • 精读
    • 2026.05.13
    • 16 分钟
    • 7,955 字

    思思扬撰写 · AI 协作整理

    类型
    精读
    系列
    Claude Code 功能 + 集成生态调研(2026-05)
    位置
    第 13 篇 / 共 16 篇
    发布
    2026.05.13
    篇幅
    7,955 字 · 16 分钟
    章节
    8 节
    标签
    • claude-code
    • ai
    • vscode
    • jetbrains
    • ide

    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 扩展 IDanthropic.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
    状态GABeta
    图形面板完整 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 的功能对比

    功能CLIVSCode 扩展
    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 sharingIDE 的 lint / 语法错误自动传给 Claude
    File referenceCmd+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 自动执行 → 安全风险

    🔗 延伸阅读

    2 条
    • 同系列: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 两条方案
    系列全部 16 篇
    1. 01Agent View:一个窗口管所有 Claude Code sessions13 分钟
    2. 02Remote Control:用浏览器和手机驱动本机的 Claude Code16 分钟
    3. 03Claude in Chrome:让 Claude Code 直接驾驶你的浏览器14 分钟
    4. 04Plugins + Marketplace:Claude Code 一切扩展的载体20 分钟
    5. 05Skills 系统:把再次输入的指令变成可加载的能力19 分钟
    6. 06Hooks:在 Claude Code 生命周期上挂触发器18 分钟
    7. 07MCP 客户端 + 第三方服务器生态18 分钟
    8. 08Subagents:Agent tool 调度专家小队20 分钟
    9. 09Routines / Scheduled Tasks / /loop:三层调度栈16 分钟
    10. 10GitHub Actions 集成:让 Claude 在 CI 里跑17 分钟
    11. 11Memory 系统:CLAUDE.md + auto memory19 分钟
    12. 12Channels:把外部事件推进活跃 session15 分钟
    13. 13IDE 集成:VSCode + JetBrains 扩展16 分钟
    14. 14Computer Use:让 Claude 真的操作你的电脑18 分钟
    15. 15Claude Code 概念全集 / 关键词速查表36 分钟
    16. 99附录:Claude 全产品矩阵中 Claude Code 的位置12 分钟