通过具体示例了解 Claude Code 在真实场景中的工作流程。
探索新代码库
当你接手一个新项目时，可以让 Claude 先了解代码结构：
这个项目的整体架构是什么？用到了哪些框架和库？
Claude 会：
- 读取项目根目录的文件列表
- 检查 package.json / requirements.txt / Cargo.toml 等依赖文件
- 查看主要的源代码目录结构
- 给你一个项目概览
构建新功能
用自然语言描述你想要什么：
给我添加一个用户个人资料页面，包含：
- 头像上传
- 昵称和简介编辑
- 密码修改
路由放在 /api/profile 下
Claude 会规划方案、创建文件、编写代码，并在完成后运行相关测试。
修复 Bug
描述症状或粘贴错误信息：
登录时报 500 错误。
最近的改动在 middleware/auth.py 中。
错误信息：AttributeError: 'NoneType' object has no attribute 'split'
Claude 会：
- 定位到相关文件
- 分析错误原因
- 提出修复方案
- 实施修改
- 运行测试验证
代码重构
把 auth.py 里的数据库查询提取成独立的 repository 模块。
遵循项目的三层架构：routes → services → repositories
编写测试
给 services/user_service.py 写完整的单元测试。
覆盖正常流程、异常情况和边界条件。
生成文档
给 API 的所有端点生成 OpenAPI 规范的文档。
包括请求参数、响应格式和错误码说明。
Git 操作
提交更改
提交我的更改，写一个有意义的提交信息
创建 Pull Request
把当前分支推送到远程，创建一个 PR 到 main 分支。
PR 描述总结一下做了什么。
解决合并冲突
合并 main 分支到我当前分支，解决出现的冲突。
保留两边的改动，合理整合。
处理大型代码库
对于大型项目，建议分步来：
- 先让 Claude 了解项目结构
- 明确告诉它关注哪些目录或文件
- 拆分成小任务逐步执行
- 每步完成后验证结果
命令行管道
Claude Code 可以与其他命令行工具组合使用：
# 分析日志
tail -200 app.log | claude -p "找出错误模式"
# 批量审查变更
git diff main --name-only | claude -p "审查安全问题"
# 一键运行完整流程
claude -p "运行测试，如果通过就提交更改"