将 Claude Code 接入 VS Code 后，直接让 AI 修改大段代码容易引发上下文混乱或权限异常。本文按官方推荐顺序，梳理扩展安装、登录验证、提示技巧、计划模式与内联修改的关键步骤，并提供最小闭环验证方法，帮助开发者快速建立稳定协作环境。
安装扩展与基础环境确认
在 VS Code 中按 Cmd+Shift+X（macOS）或 Ctrl+Shift+X（Windows/Linux）打开 Extensions 面板，搜索 Claude Code 并完成安装。官方提供直接安装入口，但在编辑器内手动搜索同样有效。安装前需确认环境版本满足要求：VS Code 1.94.0 及以上。
安装完成后，若侧边栏未显示 Spark 图标，请先执行窗口重载（Reload Window）。此外，若当前仅打开文件夹而未打开具体文件，图标也可能不会显示。建议首次接入时直接打开一个真实代码文件，再点击编辑器右上角的 Spark 图标。你也可通过左侧 Activity Bar、命令面板或右下角状态栏调出面板。首次使用的核心目标是确认“图标可见、面板可打开、当前文件可被识别”，而非立即发送复杂提示。
登录链路与权限校验
面板首次打开时会触发登录流程。该流程使用 Anthropic 账号体系，支持付费 Claude 订阅或 Claude Console 账号，无需配置 API Key。登录成功后，建议核对当前账号是否与目标工作区匹配。若你在终端已设置 ANTHROPIC_API_KEY 环境变量，但面板仍弹出登录页，可通过终端执行 code . 启动 VS Code 以继承环境变量，或直接改用 Claude 账号登录。
在团队协作环境中，“能打开面板”不等于“权限已就绪”。需确认当前工作区、所属组织与登录账号绑定一致，再允许 Claude 读取代码。此举可避免后续出现访问范围不足、会话频繁断开或部分文件无法读取等问题，并为排查提供清晰方向。
精准提示与上下文引用
Claude Code 支持自动读取选中文本。当需要引用特定代码段时，先选中目标区域，再按 Option+K（macOS）或 Alt+K（Windows/Linux），系统会自动将类似 @file.ts#5-10 的引用插入提示框。该操作适合首次接入时进行“最小验证”：仅针对一小段代码提问并请求修改，以确认上下文传递链路正常。
若频繁在代码编辑区与 Claude 输入框之间切换，可记住快捷键 Cmd+Esc（macOS）或 Ctrl+Esc（Windows/Linux）。该组合键可在代码区与 Claude 输入框间快速切换焦点，减少鼠标与键盘间的来回操作，提升交互效率。
启用计划模式审核变更
若希望首次协作先查看方案而非直接修改文件，可将默认模式设为 plan。对应配置项为 claudeCode.initialPermissionMode，也可在面板底部的模式指示器中手动切换。Plan 模式会生成完整的 Markdown 变更计划，允许你在执行前补充 inline comments，再决定是否让 Claude 动手。
该模式特别适合接入新仓库。通过审查计划内容，可提前了解 Claude 拟修改的文件、涉及的目录结构及拟执行的命令，从而评估风险。相比直接放行，先审核计划能显著减少后续回滚成本。
在 Diff 视图中直接修改提案
当 Claude 准备写入文件时，VS Code 会先展示原始内容与提案的并排差异视图，等待用户确认。该视图的核心优势在于：你可以直接在 Diff 中编辑 Claude 的提案内容，修改完成后再点击接受。官方明确指出，Claude 会识别你已修改草稿，不会将旧方案视为最终状态。
相比在聊天窗口中反复补充说明，这种方式更稳定。例如，若变量命名过长、函数拆分过细或代码顺序不符合仓库规范，均可直接在 Diff 视图中调整，再让 Claude 继续后续步骤。最终保留的版本是双方共同收敛的结果，而非简单的“接受/拒绝”二选一。
构建最小验证闭环与排错
首次接入时不建议直接处理复杂任务。推荐执行以下最小闭环：打开一段代码 → 请求小范围修改 → 在 Diff 视图中手动修正一处 → 接受变更。若该流程顺利跑通，说明扩展激活、登录状态、上下文引用、计划模式与内联修改均已正确连接。
若闭环失败，优先排查以下三项：
- 当前文件是否已真实打开（非仅打开文件夹）
- VS Code 版本是否 ≥ 1.94.0
- 窗口是否已重载以激活扩展
多数表现为“Claude 无响应”的问题，实际源于扩展未激活、焦点未切换或工作区信任未开启等基础配置项。牢记标准顺序：安装扩展 → 打开面板 → 完成登录 → 选择文件 → 查看计划 → 在 Diff 中修改提案。首次接入越克制，后续处理大规模变更时越稳定。
