/ide 深度核查 v2.1.179 · 已交叉核查 · Claude Code

本页目录10

Slash 命令看官方文档

管理IDE集成并显示集成状态

深度使用指南

最近核查 2026-06-14

· 来源 3 个

code.claude.comJetBrains IDEs — Claude Code Docs
code.claude.comUse Claude Code in VS Code — Claude Code Docs
code.claude.comCommands — Claude Code Docs

· 含官方文档· v2.1.179已交叉核查

它到底是什么

/ide 是 Claude Code 会话内的 slash 命令。它的作用是：将运行在外部终端中的 Claude Code CLI,连接到当前已打开的 IDE（VS Code 或 JetBrains 系列），从而激活 IDE 集成功能。

连接成功后，以下功能变为可用：

Diff 展示:代码变更在 IDE 原生 diff viewer 中展示,而非在终端里
选区上下文共享:IDE 中当前选中的代码片段自动传给 Claude
诊断信息共享:IDE lint 错误、语法报错自动传给 Claude
文件引用快捷键:可在提示里插入 @src/auth.ts#L1-99 格式的文件引用

注意:如果你是在 IDE 的内置终端里运行 claude,集成功能会自动激活,无需手动输入 /ide。/ide 仅在外部终端场景下才需要。

怎么触发 / 怎么使用

1. 连接到 JetBrains IDE

在外部终端启动 Claude Code 后,输入 /ide:

/ide

前提:JetBrains IDE 已安装 Claude Code 插件且 IDE 正在运行。

2. 连接到 VS Code

在外部终端启动 Claude Code 后,输入 /ide:

/ide

前提:VS Code 已安装 Claude Code 扩展(anthropic.claude-code)且扩展处于激活状态。

完整外部终端工作流

# 1. 在外部终端启动 Claude Code
claude

# 2. 进入会话后,连接 IDE
/ide

# 之后所有 diff 显示、诊断共享均通过 IDE 处理

运行约束 / 限制

约束	原因
IDE 插件/扩展必须已安装并启用	无插件则无监听端点。在 VS Code 扩展下,扩展激活后运行本地 MCP server 供 CLI 自动连接(官方原文 "it runs a local MCP server that the CLI connects to automatically");JetBrains 侧官方仅描述插件在 IDE 集成终端内运行 claude 并连接,未文档化外部终端 `/ide` 连接的底层机制
VS Code 需版本 ≥ 1.98.0	官方扩展的最低版本要求
建议 Claude Code 在 IDE 项目根目录启动	官方为可选建议（原文 "If you want Claude to have access to the same files as your IDE, start Claude Code from the same directory as your IDE project root"）;目录不一致时 Claude 访问的文件范围与 IDE 打开的项目不同
WSL2 + JetBrains 需额外网络配置	WSL2 的 NAT 网络或 Windows 防火墙可能阻断 WSL2 与 IDE 之间的连接

跟同类原语对比

启动方式	是否需要 `/ide`	说明
在 IDE 内置终端运行 `claude`	不需要	插件自动检测并建立连接
在外部终端运行 `claude`	需要 `/ide`	需手动触发连接 IDE
VS Code 扩展图形面板	不适用	扩展本身不走 CLI,无需此命令

VS Code 内置 IDE MCP server 的工作机制:扩展激活后在 127.0.0.1 随机高位端口启动本地 MCP server,生成随机 auth token 写入 ~/.claude/ide/(权限 0600,目录权限 0700)。CLI 连接时读取该 token 进行认证。

经典使用场景

喜欢在系统终端工作但又想利用 IDE diff viewer:用外部终端运行 claude,输入 /ide 激活 IDE 集成,此后代码变更弹出 IDE 原生比较窗口而非纯文本
JetBrains 远程开发(Remote Development):官方要求插件安装在远程 host(Settings → Plugin (Host)),而非本地客户端。由于 /ide 需 claude 与 IDE 在同一机器上互通,远程开发时应在远程 host 的终端(如 SSH 会话)中启动 claude 再 /ide 连接,而不是在本地客户端终端启动
WSL2 + Windows JetBrains:在 WSL2 shell 中运行 claude,配置好防火墙规则后用 /ide 桥接 WSL2 与 Windows 侧 IDE

常见坑

"No available IDEs detected"(JetBrains + WSL2):WSL2 的 NAT 网络导致 IDE 与 WSL2 实例无法通信。解决方式:在 Windows PowerShell(管理员)添加防火墙规则放行 WSL2 子网,或在 .wslconfig 中设置 networkingMode=mirrored(需 Windows 11 22H2+)。
JetBrains 插件安装后无反应:插件安装完成后可能需要完整重启 IDE(有时需重启多次)才能生效,不能仅 reload。
目录不匹配:在 /home/user/ 运行 claude 但 IDE 打开的是 /home/user/project/,/ide 能连通 IDE,但 Claude 访问的是不同的目录树。应从 IDE 项目根目录启动 claude。
VS Code 图形扩展面板无 /ide:该命令是 CLI 专属。在 VS Code 扩展的图形 chat 面板里输入 /ide 不会生效,命令菜单中也不会出现(官方文档明确：部分 CLI 命令在扩展中不可用)。

来源

全网调研整理

典型场景

在外部终端（非 VS Code 内置终端）运行 claude CLI 时，手动挂载到 VS Code 或 JetBrains 实例
快速查看当前 IDE 集成连接状态，确认是否正常接入
同时运行多个 IDE 实例时，交互式切换或重新选择要连接的具体实例
IDE 集成突然失效时，用于诊断连接状态，配合 /doctor 排查问题
在 monorepo、远程服务器或 CI 环境等无法使用 IDE 扩展的场景，通过纯 CLI 接入 IDE

实用技巧

VS Code 内置终端中运行 claude 会自动集成，无需手动执行 /ide；/ide 主要用于外部终端
通过 /config 开启「Auto-connect to IDE」，或启动时加 --ide flag，或设置环境变量 CLAUDE_CODE_AUTO_CONNECT_IDE=1，可免去每次手动连接
连接成功后，Claude 自动将当前编辑器光标选区和活跃文件作为上下文注入每条 prompt（transcript 显示 ⧉ Selected N lines from <file>）
IDE 连接后代码差异在 IDE 原生 diff viewer 中展示，同时共享 VS Code Problems 面板的 linter 诊断信息（mcp__ide__getDiagnostics）
若 PreToolUse Hook 有工具白名单，需将 mcp__ide__getDiagnostics 和 mcp__ide__executeCode 加入，否则 IDE MCP server 调用会被拦截

常见坑

使用 /add-dir 添加的目录不会自动触发 IDE 集成发现，需直接在已打开的工作区中配置
JetBrains 的 /ide open 只输出需要手动打开的路径，不像 VS Code 可通过 code CLI 直接唤起编辑器
如果 .env 等敏感文件正在 VS Code 中打开，连接 IDE 后其内容会自动作为上下文发送给 Claude，需在权限设置中为该文件添加 Read deny 规则

来源

最早记录ⓘ

≤v2.1.73

变化时间线(按版本倒序)

改进v2.1.162· 2026/06/04 · 2026/06/04

菜单中把 Windsurf 改名为 Devin Desktop

修复v2.1.73· 2026/03/12 · 2026/03/12

修复了onInstall is not defined的crash问题

本页目录10

Slash 命令看官方文档

管理IDE集成并显示集成状态

深度使用指南

最近核查 2026-06-14

· 来源 3 个

code.claude.comJetBrains IDEs — Claude Code Docs
code.claude.comUse Claude Code in VS Code — Claude Code Docs
code.claude.comCommands — Claude Code Docs

· 含官方文档· v2.1.179已交叉核查

它到底是什么

连接成功后，以下功能变为可用：

Diff 展示:代码变更在 IDE 原生 diff viewer 中展示,而非在终端里
选区上下文共享:IDE 中当前选中的代码片段自动传给 Claude
诊断信息共享:IDE lint 错误、语法报错自动传给 Claude
文件引用快捷键:可在提示里插入 @src/auth.ts#L1-99 格式的文件引用

注意:如果你是在 IDE 的内置终端里运行 claude,集成功能会自动激活,无需手动输入 /ide。/ide 仅在外部终端场景下才需要。

怎么触发 / 怎么使用

1. 连接到 JetBrains IDE

在外部终端启动 Claude Code 后,输入 /ide:

/ide

前提:JetBrains IDE 已安装 Claude Code 插件且 IDE 正在运行。

2. 连接到 VS Code

在外部终端启动 Claude Code 后,输入 /ide:

/ide

前提:VS Code 已安装 Claude Code 扩展(anthropic.claude-code)且扩展处于激活状态。

完整外部终端工作流

# 1. 在外部终端启动 Claude Code
claude

# 2. 进入会话后,连接 IDE
/ide

# 之后所有 diff 显示、诊断共享均通过 IDE 处理

运行约束 / 限制

约束	原因
IDE 插件/扩展必须已安装并启用	无插件则无监听端点。在 VS Code 扩展下,扩展激活后运行本地 MCP server 供 CLI 自动连接(官方原文 "it runs a local MCP server that the CLI connects to automatically");JetBrains 侧官方仅描述插件在 IDE 集成终端内运行 claude 并连接,未文档化外部终端 `/ide` 连接的底层机制
VS Code 需版本 ≥ 1.98.0	官方扩展的最低版本要求
建议 Claude Code 在 IDE 项目根目录启动	官方为可选建议（原文 "If you want Claude to have access to the same files as your IDE, start Claude Code from the same directory as your IDE project root"）;目录不一致时 Claude 访问的文件范围与 IDE 打开的项目不同
WSL2 + JetBrains 需额外网络配置	WSL2 的 NAT 网络或 Windows 防火墙可能阻断 WSL2 与 IDE 之间的连接

跟同类原语对比

启动方式	是否需要 `/ide`	说明
在 IDE 内置终端运行 `claude`	不需要	插件自动检测并建立连接
在外部终端运行 `claude`	需要 `/ide`	需手动触发连接 IDE
VS Code 扩展图形面板	不适用	扩展本身不走 CLI,无需此命令

经典使用场景

喜欢在系统终端工作但又想利用 IDE diff viewer:用外部终端运行 claude,输入 /ide 激活 IDE 集成,此后代码变更弹出 IDE 原生比较窗口而非纯文本
JetBrains 远程开发(Remote Development):官方要求插件安装在远程 host(Settings → Plugin (Host)),而非本地客户端。由于 /ide 需 claude 与 IDE 在同一机器上互通,远程开发时应在远程 host 的终端(如 SSH 会话)中启动 claude 再 /ide 连接,而不是在本地客户端终端启动
WSL2 + Windows JetBrains:在 WSL2 shell 中运行 claude,配置好防火墙规则后用 /ide 桥接 WSL2 与 Windows 侧 IDE

常见坑

"No available IDEs detected"(JetBrains + WSL2):WSL2 的 NAT 网络导致 IDE 与 WSL2 实例无法通信。解决方式:在 Windows PowerShell(管理员)添加防火墙规则放行 WSL2 子网,或在 .wslconfig 中设置 networkingMode=mirrored(需 Windows 11 22H2+)。
JetBrains 插件安装后无反应:插件安装完成后可能需要完整重启 IDE(有时需重启多次)才能生效,不能仅 reload。
目录不匹配:在 /home/user/ 运行 claude 但 IDE 打开的是 /home/user/project/,/ide 能连通 IDE,但 Claude 访问的是不同的目录树。应从 IDE 项目根目录启动 claude。
VS Code 图形扩展面板无 /ide:该命令是 CLI 专属。在 VS Code 扩展的图形 chat 面板里输入 /ide 不会生效,命令菜单中也不会出现(官方文档明确：部分 CLI 命令在扩展中不可用)。

来源

全网调研整理

典型场景

在外部终端（非 VS Code 内置终端）运行 claude CLI 时，手动挂载到 VS Code 或 JetBrains 实例
快速查看当前 IDE 集成连接状态，确认是否正常接入
同时运行多个 IDE 实例时，交互式切换或重新选择要连接的具体实例
IDE 集成突然失效时，用于诊断连接状态，配合 /doctor 排查问题
在 monorepo、远程服务器或 CI 环境等无法使用 IDE 扩展的场景，通过纯 CLI 接入 IDE

实用技巧

VS Code 内置终端中运行 claude 会自动集成，无需手动执行 /ide；/ide 主要用于外部终端
通过 /config 开启「Auto-connect to IDE」，或启动时加 --ide flag，或设置环境变量 CLAUDE_CODE_AUTO_CONNECT_IDE=1，可免去每次手动连接
连接成功后，Claude 自动将当前编辑器光标选区和活跃文件作为上下文注入每条 prompt（transcript 显示 ⧉ Selected N lines from <file>）
IDE 连接后代码差异在 IDE 原生 diff viewer 中展示，同时共享 VS Code Problems 面板的 linter 诊断信息（mcp__ide__getDiagnostics）
若 PreToolUse Hook 有工具白名单，需将 mcp__ide__getDiagnostics 和 mcp__ide__executeCode 加入，否则 IDE MCP server 调用会被拦截

常见坑

使用 /add-dir 添加的目录不会自动触发 IDE 集成发现，需直接在已打开的工作区中配置
JetBrains 的 /ide open 只输出需要手动打开的路径，不像 VS Code 可通过 code CLI 直接唤起编辑器
如果 .env 等敏感文件正在 VS Code 中打开，连接 IDE 后其内容会自动作为上下文发送给 Claude，需在权限设置中为该文件添加 Read deny 规则

来源

最早记录ⓘ

≤v2.1.73

变化时间线(按版本倒序)

改进v2.1.162· 2026/06/04 · 2026/06/04

菜单中把 Windsurf 改名为 Devin Desktop

修复v2.1.73· 2026/03/12 · 2026/03/12

修复了onInstall is not defined的crash问题