Claude Code IDE 使用教程

IDE 入口适合解释当前文件、处理选中代码、做局部小改和审查 inline diff。它不是 CLI 的替代品，而是让 CC 更贴近正在编辑的代码。

IDE 入口的优势是“贴近当前文件”。当用户已经在 VS Code、Cursor 或 JetBrains 里定位到某段代码时，IDE 入口能让 CC 直接围绕当前文件、选中代码、报错位置来工作。

但 IDE 入口不是万能入口。大范围读项目、运行检查、处理 Git 状态、跨目录批量修改，通常还是 CLI 更稳。

IDE 适合做什么

第一次在 IDE 里用 CC，不要直接让它改代码。先让它解释当前文件。

请解释当前文件。

要求：
1. 先说明这个文件的作用。
2. 说明主要函数、组件或模块的职责。
3. 标出它依赖哪些外部文件或接口。
4. 标出你不确定的地方。
5. 不要修改文件。

如果选中了一段代码，可以这样问：

请解释我选中的这段代码。

要求：
1. 用中文说明它在做什么。
2. 说明输入和输出是什么。
3. 说明可能的边界情况。
4. 如果有潜在问题，只给建议，不要直接修改。

局部修改要明确范围。

请只修改当前选中的代码。

目标：
【写清楚要改什么】

限制：
1. 不修改选区之外的代码。
2. 不做无关重构。
3. 不新增依赖。
4. 修改后解释 diff。
5. 如果必须改选区外内容，先说明原因并等待确认。

如果没有选区，要把范围写清楚：

请只修改当前文件中的【函数名/组件名/样式块】。

不要修改其他文件。
不要顺手调整格式。
改完后说明：
1. 改了哪里。
2. 为什么这样改。
3. 还需要如何验证。

出现这些信号，就不要继续在 IDE 里硬改：

可复制：

这个任务可能超出 IDE 局部范围。

请判断是否应该切到 CLI：
1. 需要读取哪些额外文件。
2. 是否涉及多个模块。
3. 是否需要运行检查。
4. IDE 中继续做有什么风险。
5. CLI 里第一步应该做什么。

IDE 的一个好处是能直观看到 inline diff。不要只点接受，要让 CC 解释每个改动。

请解释这次 IDE diff。

要求：
1. 按文件或代码块说明每处改动。
2. 说明每处改动和原任务的关系。
3. 标出是否有无关改动。
4. 标出是否需要运行检查。
5. 如果有风险，先说明，不要继续修改。

如果 diff 超出预期：

这次 IDE diff 超出范围了。

请先暂停，不要继续改。
请列出：
1. 哪些改动必须保留。
2. 哪些改动可以撤回。
3. 哪些改动需要我确认。
4. 如何收窄到原任务。

推荐流程：

切换到 CLI 前，让 IDE 里的 CC 生成交接说明：

我要从 IDE 切到 CLI 继续。

请生成交接说明：
1. 当前问题是什么。
2. 相关文件有哪些。
3. 已经分析了什么。
4. 已经修改了什么。
5. CLI 里下一步应该做什么。
6. 哪些内容不要扩大修改。

IDE 里改完小代码，也要回到验收：

请验收这次 IDE 局部修改。

请说明：
1. 是否只改了指定范围。
2. inline diff 是否符合目标。
3. 是否需要切到 CLI 运行检查。
4. 是否可能影响其他文件或调用方。
5. 如果需要继续修改，最小下一步是什么。

请在 IDE 里帮我处理当前文件。

任务目标：
【写清楚目标】

范围：
【当前文件 / 当前选区 / 某个函数 / 某个组件】

限制：
1. 不修改范围外内容。
2. 不新增依赖。
3. 不做无关重构。
4. 改完后解释 inline diff。
5. 给出需要在 CLI 里运行的检查建议。