为什么是扩展而不是终端

官方原话：扩展是「在 VS Code 里使用 Claude Code 的推荐方式」。相比在集成终端里跑 CLI，扩展多出的是 编辑器级整合：Claude 自动看见你选中的文本、diff 以 VS Code 原生视图呈现、方案能像审 PR 一样逐段评论、 多会话开成多标签页。CLI 的能力（MCP、hooks、skills、权限体系）一个不少——底层就是同一套引擎。

前置只有两条：VS Code 1.94+，一个付费 Claude 订阅（Pro / Max / Team / Enterprise）或 Console 账号。首次打开面板走浏览器授权登录，不需要配置 API key。

上下文供给：这个扩展的灵魂

  • 选区自动可见：编辑器里选中的代码 Claude 直接能看到，prompt 框底部显示选了几行；点选区指示器可切换隐藏（眼睛斜杠 = 对 Claude 不可见）。
  • Option+K（Win: Alt+K）：把当前选区变成带路径与行号的 @提及插进 prompt，如 @app.ts#5-10——讨论「这几行」再也不用描述位置。
  • @ 模糊匹配：@auth 能匹配 auth.js / AuthService.ts；目录加尾斜杠 @src/components/；大 PDF 可以指定页码范围只读几页。
  • 拖拽附件：按住 Shift 把文件拖进 prompt 框作为附件；截图、设计稿、错误日志都这么喂。

权限模式与 Plan 评论流

prompt 框底部的模式指示器可切四种：Auto（Pro / Max / Team 上的内置起始模式，分类器代审）、Manual（编辑前 side-by-side diff 逐个批，你直接在 diff 里改过的内容 Claude 会被告知）、Plan、Edit automatically。

Plan 模式是扩展的招牌：方案自动开成完整 Markdown 文档，你在文档里加内联评论表达不同意见， Claude 按评论改方案，认可后再放行动手。「先审方案再写码」这个最佳实践在扩展里的体验是所有形态里最顺的。

降噪三件套

  • Focus view（Ctrl+Option+F 或命令面板）：把工具调用、结果、思考折进可展开的行，只留你的提问和 Claude 的回答；待办清单与提问上下文保持可见。对所有打开的会话生效并持久保存。
  • /btw 旁支提问：借当前会话上下文问旁支问题，回答开在聊天旁边的独立面板，可以追问，不往主对话写任何内容；线程能扛住窗口重载，保留最近 20 轮。
  • 上下文指示器：prompt 框实时显示上下文占用，满了自动压缩，也可手动 /compact。

会话管理与云端续接

  • 历史：面板顶部 Session history 按关键词搜、按时间浏览，AI 自动起标题，可重命名删除；恢复以 Plan 模式结束的会话会还原 Plan 模式。
  • 多会话：命令面板 Open in New Tab，多个对话开成多标签甚至多窗口并行。
  • 续接云端会话：以 Claude.ai Subscription 身份登录（不是 Console）时，claude.ai/code 上的云端会话可以直接在 VS Code 里恢复继续——网页派活、编辑器收尾。
  • Remote Control：命令菜单里 /remote-control 反向把本地会话暴露给手机 / 网页盯进度，也可在设置里对所有会话默认开启。

命令菜单与设置速览

prompt 框输入 / 打开命令菜单：附件、切模型、扩展思考开关、/usage 看用量，Customize 区直达 MCP、hooks、memory、permissions、plugins（带终端图标的会开进集成终端执行）。/bug 或 Report a problem 直接向 Anthropic 报障。面板位置可拖拽，也可用 preferredLocation 设置固定到侧栏。

两个官方点名的坑

  1. 扩展 ≠ CLI 安装：扩展捆绑私有 CLI 副本供聊天面板用，不装 claude 进 PATH。集成终端里要用命令行，另跑一次标准安装——只装扩展的机器上 ~/.local/bin/claude 本来就不存在。
  2. 环境变量继承：Dock / 启动器打开的 VS Code 不继承 shell 环境。设了 ANTHROPIC_API_KEY 仍见登录页时，终端里 code . 启动，或改用账号登录。

上手清单

  1. 装扩展 → 登录 → 跑一遍命令面板的 Open Walkthrough 官方导览。
  2. 把 Option+K 练成肌肉记忆——精确行号引用是效率差距的主要来源。
  3. 复杂任务 Plan 起手，在 Markdown 方案文档上评论完再放行。
  4. 长会话开 Focus view，旁支问题一律 /btw。
  5. 要在终端跑 claude 的记得另装 CLI；两边共享同一份 settings 与登录。

如果说 Desktop 版的关键词是「并行」，VS Code 扩展的关键词就是「贴身」：上下文供给零摩擦、方案审查像审 PR、改动落在你正盯着的编辑器里。日常写码为主的人，这里往往是最高频的 Claude Code 入口。