在 VS Code、JetBrains 和桌面应用里用 Claude Code：三种入口怎么装、差在哪、怎么选

这篇教程解决一个问题：不想一直在终端里敲，Claude Code 还能在哪用，几种用法之间是什么关系。

本系列前面的文章都是在终端里做的。除了终端，官方还有三个图形入口：VS Code 的扩展、JetBrains 系列 IDE 的插件、Claude 的桌面应用。它们背后是同一个 Claude Code，区别在界面，以及各自带不带命令行、读不读同一份配置。

本站的实测环境是一台没有图形界面的服务器，这三样都测不了。下面的内容全部按官方文档整理。

先看全貌

	VS Code 扩展	JetBrains 插件	桌面应用	命令行
界面	编辑器里的对话面板	IDE 的终端，加上 diff 和选区的联动	独立的应用，Code 标签页	终端
要不要另装命令行	不用，扩展自带一份	要，插件不带	不用，应用自带	本身就是
账号要求（官方文档的说法）	任意付费订阅，或 Console 账号	同左	Pro、Max、Team 或 Enterprise 订阅	同 VS Code
功能	命令和 skill 是一部分	就是命令行，全部都有	交互式的大部分都有，脚本类的没有	全部
配置	和命令行共用	和命令行共用	和命令行共用，接口另设	—

账号一栏是文档对直连官方的说法。通过中转站用的情况，每一节末尾单独讲。

VS Code 扩展

安装

要求 VS Code 1.94.0 或更新。在扩展视图（Cmd+Shift+X 或 Ctrl+Shift+X）里搜 “Claude Code”，点安装。

Cursor 也可以装，官方给了直接安装的链接。其他基于 VS Code 的编辑器，在它们自己的扩展视图里搜，或者从 Open VSX 装。实在装不上的编辑器，文档的建议是装命令行，在它的内置终端里运行 claude，命令行在任何终端里都能用。

扩展的版本号就是它里面那份 Claude Code 的版本号。文章里说“需要某个版本以上”的功能，看扩展视图里显示的版本就知道有没有。

打开

VS Code 里凡是星芒形状的图标，指的都是 Claude Code。四个入口：

• 编辑器右上角的工具栏：最快。但要先打开一个文件，图标才出现。
• 左边的活动栏：打开会话列表。这个图标一直在。
• 命令面板（Cmd+Shift+P 或 Ctrl+Shift+P）：输入 “Claude Code”。
• 右下角状态栏的 ✻ Claude Code：没打开文件也能点。

输入框里能做的事

• 切权限模式：点输入框底部的模式标识。有 Auto、Manual、Plan、Edit automatically 四种。Plan 模式下，VS Code 会把计划作为一个完整的 Markdown 文档打开，你可以在上面加行内批注，再让它开始。几种模式的含义和命令行一样，见权限模式怎么选。
• 换模型：点输入框底部的模型名。
• 命令菜单：点 / 或输入 /。里面的 Customize 一栏可以直接查看和管理 MCP 服务器、hooks、权限规则、插件、输出风格。
• 引用文件：@ 加文件名。在编辑器里选中一段代码再提问，它会带上选区的行号范围。

历史和回退

面板顶部有会话历史的按钮，可以按关键词搜，点一条就带着完整的历史恢复。没起名字的会话会自动生成标题；默认 14 天没动静的会话自动归档，归档的可以恢复。

回退的做法和命令行不同：把鼠标悬在某条消息上，会出现回退按钮，有三个选项：

• Fork conversation from here：从这条消息开出一个新的对话分支，代码改动全部保留。
• Rewind code to here：把文件退回到这个时刻，对话历史保留。
• Fork conversation and rewind code：两样都做。

检查点的限制和命令行一样，用命令改的文件退不回去，见重构和迁移里的实测。

和命令行比，少了什么

官方给的对照表：

功能	命令行	VS Code 扩展
命令和 skill	全部	一部分，输入 / 看有哪些
MCP 服务器配置	有	有，在对话面板里用 /mcp 管理
检查点	有	有
! 开头直接跑命令	有	没有
Tab 补全	有	没有

要用扩展里没有的功能，就在 VS Code 的内置终端里运行 claude。这里有一个经常让人困惑的地方：装了扩展，不等于终端里有 claude 命令。 扩展自带的那份命令行是给对话面板私用的，不会加进 PATH。要在终端里用，得另外按安装教程装一次。

和命令行的关系

• 对话历史是共用的。 扩展里的对话，在终端里运行 claude --resume 能找到并接着聊。
• 在内置终端里运行的命令行会自动和 VS Code 联动：改动用 VS Code 的 diff 视图显示，能读到你当前的选区。在外部终端里运行的，输入 /ide 连上。
• 同一个对话不要在两个地方同时开。 扩展发现一个对话还在别处开着（另一个窗口，或者终端里的 claude），会在输入框的位置显示一条提示，说同时用会把消息弄混。先关掉另一边再继续。

通过中转站用

扩展要在 VS Code 自己的设置里填接口地址和凭据，只写在 ~/.claude/settings.json 里不够。具体写法见Claude Code 接入中转站里“VS Code 扩展和桌面应用要单独设置”一节。

官方文档还说明：不走 claude.ai 账号登录时，扩展里依赖这个账号的功能不会出现，包括订阅用量的进度条、语音输入、云端会话的标签页。

常见问题

• 看不到星芒图标：先打开一个文件，只打开文件夹不行。还没有的话，确认 VS Code 版本、重新加载窗口、暂时停用别的 AI 扩展。另外，工作区处在受限模式（Restricted Mode）时扩展不工作。
• macOS 上按 Cmd+Esc 没反应：新版 macOS 把这个组合键默认给了系统的游戏浮层。到系统设置的键盘快捷键里关掉它，或者在 VS Code 里给 Claude Code 换一个键。
• 发了消息一直没回应：文档建议到终端里运行 claude 试一次，那里的报错更详细。排查的办法见常见报错怎么查。

安全上要知道的一点

文档提醒：允许它自动改文件时，它也能改 VS Code 的配置文件（比如 settings.json、tasks.json），而这些文件可能被 VS Code 自动执行。打开不信任的代码时，用受限模式，权限模式选 Manual。

JetBrains 插件

支持 IntelliJ IDEA、PyCharm、Android Studio、WebStorm、PhpStorm、GoLand 等大多数 JetBrains IDE。

它和 VS Code 扩展不是一个思路

VS Code 扩展是一个图形面板。JetBrains 插件没有自己的对话界面：它在 IDE 的内置终端里运行你装的那个 claude，然后把 IDE 和它连起来。所以要装两样：

1. 命令行，按安装教程装。
2. 插件，在 JetBrains Marketplace 里搜 Claude Code，装完重启 IDE。

只装插件不装命令行，会弹出 “Cannot launch Claude Code” 的通知。claude 装在 IDE 找不到的位置时，到插件设置（Settings → Tools → Claude Code）里把 Claude command 填成完整路径。

连上之后多了什么

• 快捷键启动：Cmd+Esc（Mac）或 Ctrl+Esc（Windows、Linux）。
• 改动用 IDE 的 diff 视图显示，不在终端里刷。
• 选区共享：你在编辑器里选中的内容、当前打开的标签页，会自动作为上下文。
• 插入文件引用：Cmd+Option+K（Mac）或 Alt+Ctrl+K，插入 @src/auth.ts#L1-99 这样的引用。
• 读 IDE 的诊断：IDE 检查出的语法错误、lint 问题，它可以读到。

在 IDE 的内置终端里运行 claude，这些自动生效。在外部终端里运行的，输入 /ide 连上；连接成功会显示类似 Connected to IntelliJ IDEA. 的提示。

几个设置

• diff 在哪显示：在 Claude Code 里输入 /config，把 Diff tool 设成 auto（在 IDE 里）或 terminal。这一项只有连上 IDE 之后才出现。
• 按 ESC 中断不了：JetBrains 的终端默认把 ESC 用来把焦点切回编辑器。到 Settings → Tools → Terminal，取消勾选 “Move focus to the editor with Escape”。
• 远程开发：插件要装在远程主机上（Settings → Plugin (Host)），不是装在本地的客户端。
• WSL：把 Claude command 设成 wsl -d Ubuntu -- bash -lic "claude"，发行版的名字换成你自己的。

通过中转站用

插件运行的就是你装的那个 claude，所以命令行的配置在这里直接生效，包括写在 ~/.claude/settings.json 里的接口地址和凭据。这一点是从“插件在内置终端里运行 claude 命令”这个机制推出来的，我们没有实测。

常见问题

• /ide 提示 “No available IDEs detected”：确认插件已安装并启用，彻底重启 IDE。
• 功能没出现：确认是从项目根目录启动的 Claude Code；文档说可能要多重启几次 IDE。
• 点图标提示 command not found：在终端里运行 claude --version 确认装上了，再到插件设置里填路径。

桌面应用

Claude 的桌面应用有三个标签页：Chat 是普通的对话，Cowork 是在后台自己干活的代理，Code 是 Claude Code。这里只讲 Code。

安装和第一个会话

macOS 和 Windows 下载安装包，Linux 用 apt。应用里已经带了 Claude Code，不需要装 Node.js，也不需要装命令行。官方文档写明要 Pro、Max、Team 或 Enterprise 订阅。

打开 Code 标签页，开一个会话要选三样：

1. 在哪跑：
   • Local：在你的电脑上，直接用你的文件。
   • Cloud：在云端跑，关掉应用也继续。见云端会话。
   • SSH：连到一台远程机器，第一次连接时应用会自动在那边装上 Claude Code。
   • WSL（Windows）：在 WSL 2 的发行版里跑。
2. 哪个文件夹。
3. 哪个模型，发送按钮旁边的下拉框。

然后输入要它做的事。

图形界面带来的东西

• 看改动：它改了文件之后出现 +12 -1 这样的标识，点开是 diff 视图，可以逐个文件看，在具体的行上写评论，它读了评论再改。
• 权限模式：发送按钮旁边的选择器，有 Auto、Manual、Accept edits、Plan。Manual 模式下每处改动先给你看 diff，点接受才写进文件。
• 窗格：对话、diff、终端、文件、浏览器几个窗格可以拖着排。
• 预览：在应用里启动开发服务器，页面会开在浏览器窗格里，它能看到运行中的页面并据此修改。
• 并行会话：侧边栏里开多个会话，每个可以放在自己的 git worktree 里。
• 盯 PR：开了 PR 之后它可以跟着 CI 的结果，失败了自动修。
• 定时任务：让它按计划重复运行。

和命令行比

官方文档的说法是两者是同一个引擎，可以在同一台机器、同一个项目上同时用。共用的有：

• 项目里的 CLAUDE.md；
• ~/.claude.json 和 .mcp.json 里配的 MCP 服务器；
• 设置里的 hooks 和 skill；
• ~/.claude/settings.json 里的权限规则等设置。

桌面应用里没有的，都是为脚本和自动化设计的东西：

命令行有	桌面应用里
-p 和 --output-format	没有，应用只做交互
dontAsk 权限模式	没有
--allowedTools、--disallowedTools	没有按会话设置的办法，设置文件里的权限规则仍然生效
代理团队	没有
/permissions 这类会打开终端面板的命令	不可用，直接改设置文件

这些怎么用，见把 Claude Code 接进脚本和 CI。

环境变量的坑

桌面应用不一定继承你 shell 里的环境。文档的说明是：macOS 上从程序坞或访达启动时，它会读你的 shell 配置文件，但只取 PATH 和固定的一组 Claude Code 变量，你另外 export 的变量拿不到；Windows 上它继承用户和系统的环境变量，但不读 PowerShell 的配置文件。

要给本地会话设环境变量，在输入框里打开环境的下拉菜单，把鼠标悬在 Local 上，点齿轮，在本地环境编辑器里加。这里存的变量是加密保存在本机的。

把终端里的会话搬过来

• 在终端的会话里输入 /desktop：保存会话，在桌面应用里打开，然后退出命令行。
• 在 shell 里运行 claude --desktop --resume <会话 ID>，或者 claude --desktop --continue。
• 在桌面应用的输入框里输入 /resume，会列出这台电脑上从命令行开的会话。

文档注明，前两种只在 macOS 和 x64 的 Windows 上、用 Claude 订阅登录时可用；用 API key 认证的不可用。搬过去的是同一个会话，不是副本，之后在终端里 claude --resume 仍然找得到它。会话的更多操作见会话和上下文。

通过中转站用

桌面应用的接口要在应用里单独配置，和命令行不是一处。步骤见Claude 桌面应用接入中转站。

怎么选

你的情况	用哪个
平时就在 VS Code 或 Cursor 里写代码	VS Code 扩展。用到扩展里没有的命令时，在内置终端里开命令行
用 JetBrains 的 IDE	装命令行加插件
想在一个窗口里管好几个并行的会话，或者想直观地看 diff、预览页面	桌面应用
不想装任何开发环境	桌面应用
要写脚本、接 CI、在服务器上跑	命令行
用的是别的编辑器	命令行，在编辑器的内置终端里跑

官方文档对桌面应用和命令行的建议是：想在一个窗口里管理并行的会话、并排摆放窗格、直观地审改动，用桌面应用；要脚本、自动化，或者习惯终端，用命令行。

这几样不是只能选一个。配置和项目的 CLAUDE.md 是通用的，会话可以互相接，按当时手上的事换着用就行。

这篇没有覆盖到的

• 全篇没有实测。 实测环境没有图形界面。界面上的按钮名称、菜单位置都照官方文档写，版本更新后可能有出入。
• JetBrains 插件通过中转站的情况是推断，文中已注明。
• 开发容器、GitHub Codespaces、远程 SSH 下的 VS Code 没有涉及。
• 桌面应用的电脑操作（computer use）、iOS 模拟器窗格、企业部署和管理策略没有涉及。
• Windows 和 WSL 的细节只提了最常用的一两处。
• 网页端和手机端不在这篇里，见云端会话。

相关文章

• 系列的上一篇：怎么省用量。
• 还没装命令行：安装 Claude Code。
• 三个入口各自怎么接中转站：Claude Code 接入中转站、Claude 桌面应用接入中转站。