Claude Code 怎么用？从打开项目到修复第一个 Bug

Claude Code 的核心价值，是让 AI 不只回答代码问题，而是进入你的项目目录，理解代码库，帮你定位问题、修改文件、运行命令和测试。对新手来说，最好的第一课不是让它重构整个项目，而是让它修复一个小 Bug：范围清楚、结果可验证、风险可控。

本文基于 Anthropic 官方 CLI 用法和 Claude Code 入门流程，演示从打开项目到修复第一个 Bug 的完整步骤。你会看到如何启动 Claude Code、怎么描述问题、什么时候让它先给计划、如何确认权限、怎样看 diff 和跑测试。安装配置还没完成的读者，可以先看本站 安装部署教程 和 环境配置教程。

摘要

Claude Code 修复第一个 Bug 的推荐流程是：进入项目目录，运行 claude 启动交互模式；先让它解释项目结构，不要马上改文件；提供 Bug 现象、复现步骤、报错信息、预期行为和修改边界；要求它先给定位思路和修改计划；确认权限后让它编辑文件；修改完成后查看 diff、运行测试、复现 Bug 是否消失；最后让 Claude Code 总结改了哪些文件、如何验证、还有哪些风险。整个过程必须由开发者审查，不能无脑接受文件修改或命令执行。

正文

第一步：进入项目目录

打开终端，进入你要修复 Bug 的项目目录。建议先确认当前分支和工作区状态，避免把 Claude Code 的修改混进未提交的个人改动里。

cd your-project
git status
git branch --show-current

第二步：启动 Claude Code

在项目目录运行：

claude

官方 CLI 文档说明，claude 会启动交互式 REPL。你也可以用 claude “explain this project” 带初始问题启动，或用 claude -p “query” 做非交互输出。新手修 Bug 建议先用交互模式，因为你需要逐步确认计划和权限。

第三步：先让它理解项目

第一次进入项目，不要直接说“修复这个 Bug”。先让 Claude Code 解释项目结构、主要目录、测试命令和相关技术栈。例如：

请先只读探索这个项目，不要修改文件。
请说明项目结构、主要入口、测试命令，以及你认为前端和后端代码分别在哪里。

这样可以减少它误改无关文件，也能帮助你判断它是否理解项目。

第四步：描述第一个 Bug

Bug 描述越清楚，Claude Code 越容易定位。至少写清：Bug 现象、复现步骤、预期结果、实际结果、报错日志、相关页面或文件、允许修改的范围。

Bug 修复提示词模板

请帮我修复一个 Bug，但先不要直接改文件。
现象：【描述哪里出错】
复现步骤：【1、2、3】
预期结果：【应该发生什么】
实际结果：【现在发生什么】
报错信息：【粘贴日志】
修改范围：优先只改相关模块，不要改接口协议，不要做无关重构。
要求：先定位可能原因并给出修改计划，等我确认后再改。

第五步：先看计划，再确认权限

Claude Code 可能会请求读取文件、编辑文件或运行命令。不要看到请求就直接确认。先看它的计划是否合理：是否只修改相关文件，是否理解 Bug，是否会运行测试，是否避免无关重构。涉及删除文件、改配置、安装依赖、执行脚本和提交代码时，要更谨慎。

第六步：让它修改并运行测试

确认计划后，可以让 Claude Code 修改文件。修改后要求它运行项目已有测试或最小验证命令。例如：

可以按刚才计划修改。
修改完成后，请运行相关测试或 lint 命令。
如果测试失败，请先解释失败原因，再继续修复。

官方 CLI 支持多轮交互，也支持继续最近会话，例如 claude -c 或 claude –continue。修复 Bug 时保留同一会话更容易保持上下文。

第七步：检查 diff

不要只看 Claude Code 的总结。你必须查看实际文件差异：

git diff

重点看它是否改了无关文件、是否引入硬编码、是否删除了重要逻辑、是否改变了接口约定、是否绕过了测试。

第八步：复现 Bug 是否消失

自动测试通过不代表 Bug 一定修好。你还需要按原复现步骤手动验证一次。如果是前端问题，打开页面检查；如果是接口问题，跑请求或集成测试；如果是命令行问题，重新执行原命令。

第九步：让 Claude Code 总结

修复完成后，可以要求 Claude Code 输出总结，方便写提交说明：

请总结本次修复：
1. Bug 根因是什么
2. 修改了哪些文件
3. 如何验证
4. 是否还有剩余风险
5. 建议的 commit message

第十步：提交前人工审查

最后一步仍然是人的责任。确认测试通过、diff 合理、没有密钥和敏感信息、没有无关重构，再提交代码。更多项目级 AI 编程流程可以阅读本站 实战工作流；如果 Claude Code 运行命令或安装环境出错，可以查看 问题排查教程。

FAQ

Claude Code 第一次应该修什么 Bug？

建议选择范围小、容易复现、测试明确的 Bug，例如按钮点击无效、表单校验错误、文案显示错误、简单类型错误或单测失败。

可以让 Claude Code 直接改文件吗？

可以，但新手建议先要求它只读探索并给出计划，确认后再改。这样能减少无关修改和误解需求。

Claude Code 修改后一定要跑测试吗？

一定要。至少运行相关单测、lint、构建或手动复现步骤。AI 生成的代码必须经过验证。

Claude Code 请求权限时怎么判断能不能同意？

看命令是否和任务相关、是否会删除或覆盖文件、是否会安装依赖、是否会访问敏感路径。看不懂时先拒绝，并要求它解释命令目的。

修复结果不对怎么办？

不要马上重开会话。把问题具体反馈给 Claude Code：哪里不对、测试怎么失败、哪些文件不能改、期望行为是什么，让它在当前上下文中继续修正。