Claude Code IDE 集成

可复现实践

验证一次 IDE 辅助编辑，不混淆 extension 与 CLI 状态

在一个可丢弃改动上证明 editor context、diff review、terminal 验证和回退。

准备

• VS Code 1.94+ 或受支持 JetBrains IDE、trusted workspace 和官方 integration。
• 有效账户；JetBrains 和 integrated-terminal CLI 需要单独安装 claude。
• 干净 task branch 和已知定向测试。

执行步骤

1. 单独验证 terminal PATH

   VS Code panel 自带 private CLI，但 integrated terminal 不会因此获得 PATH。

   command -v claude
   claude --version
   claude auth status --text

2. 打开一个文件并选中窄范围

   先要求 IDE panel 解释 selection 并引用相关文件，再请求编辑。

3. 请求一个可回退改动

   使用 panel 的 plan 或 diff review，拒绝无关 hunk，避免 terminal session 同时编辑。

4. 在 integrated terminal 验证

   IDE 报告完成后，运行项目定向测试并检查 git diff。

   git diff --check
   git diff --stat
   # 运行项目自己的定向测试

预期结果

IDE 显示预期 selection 和 inline diff，terminal test 检查已保存文件，diff 可独立审查。

验证

• 测试前确认文件已保存。
• 检查 selected-code context 没有静默扩大范围。
• reload IDE 后确认磁盘文件一致。

失败处理

清理或回退

• 拒绝 proposed diff，或对该会话产生的改动使用 IDE checkpoint。
• 用 git diff 确认回退没有删除用户既有修改。

边界与不适用场景

• IDE 菜单和可用性受 editor version、remote environment、provider 和 rollout 影响。
• checkpoint 覆盖 Claude edits，但不覆盖所有外部编辑或不可逆命令。