Claude Code / 平台集成
Claude Code 与 VS Code
VS Code 集成适合在编辑器里选择上下文、查看 diff，并和终端命令配合。
VS Code 入门
VS Code 扩展让 Claude 在编辑器里读取当前文件、选区和项目上下文，支持面板、侧边栏、终端模式、会话恢复、插件管理和 Chrome 自动化。
安装后重点掌握提示框、@ 引用、会话恢复、模式选择器、inline diff 和命令面板。编辑器入口适合小步修改和即时审查。
提示框和引用
在 VS Code 中可以引用文件、文件夹或选区。引用越精确，Claude 越少浪费上下文，也越不容易改错文件。
@src/auth/token.ts 请解释这里的刷新逻辑，并列出可能导致 401 的路径。先不要改文件。命令和快捷键
官方文档列出焦点输入、打开边栏、终端中打开、新对话、恢复关闭会话、插入 @ 提及、显示日志和登出等命令。
| 动作 | 典型快捷键/入口 |
|---|---|
| 焦点输入 | Cmd+Esc / Ctrl+Esc |
| 新对话 | Cmd+N / Ctrl+N，需启用设置。 |
| 重新打开已关闭会话 | Cmd+Shift+T / Ctrl+Shift+T。 |
| 插入 @ 提及 | Option+K / Alt+K。 |
扩展设置
关键设置包括 useTerminal、initialPermissionMode、preferredLocation、autosave、useCtrlEnterToSend、respectGitIgnore、allowDangerouslySkipPermissions 和环境变量等。
权限模式别乱开
initialPermissionMode 可设 default、plan、acceptEdits 或 bypassPermissions。bypass 需要额外开关，只应在隔离环境使用。
完整使用要点
补充官方文档中容易被压缩遗漏的核心概念、操作顺序、权限边界和验证要求，方便中文学习者按页面完整学习。
VS Code 补充
VS Code 集成适合在编辑器内引用文件、选区、当前错误和打开的上下文。它支持提示框、侧边栏、终端模式、@ 引用、会话恢复、inline diff、命令面板和部分设置项。
推荐工作流：用 @ 精确引用文件或目录；先要求解释和计划；小步修改；在 inline diff 中审查；再运行项目命令验证。对于跨仓库或部署任务，仍应回到 CLI 或 CI。
关键设置包括初始权限模式、是否使用终端、首选显示位置、autosave、发送快捷键、是否尊重 gitignore、环境变量和是否允许高风险 bypass。
学习检查清单
把本页内容落到真实任务中，用入口、上下文、权限、验证和团队规则五个维度检查是否真正掌握。
学习检查清单
读完本页后，不要只记住概念名。你应该能把“Claude Code 与 VS Code”放回 Claude Code 的真实工程流程里：任务从哪里发起，系统会加载什么上下文，哪些动作需要审批，结果如何验证，失败时如何回退。
如果这是入口或平台页面，要特别确认本入口能访问哪些上下文：本地文件、云端仓库、浏览器登录态、团队消息、外部工具，以及这些上下文是否足以完成验证。
- 能用自己的话说明本页解决的具体问题，而不是只复述标题。
- 能写出一个最小示例任务，并标明目标、范围、禁止事项和验收标准。
- 能判断哪些信息应该放进当前提示，哪些应该沉淀到项目规则或配置里。
- 能说明哪些长期规则应该写进 CLAUDE.md，哪些运行行为应该交给 settings、permissions、Hooks、Skills 和 MCP。
- 能在任务完成后检查 diff、命令输出、测试结果、截图或 PR 说明，而不是只相信自然语言总结。
如果要把本页用于团队培训，可以让学员用 Claude Code 完成一个小任务：先只读解释，再提交计划，再执行最小改动，最后用真实验证命令和人工 diff 审查收尾。