本文整理了 Claude Code 的核心日常工作流,包含可直接复用的 prompt 示例,覆盖从理解新代码库到并行处理多个任务的完整场景。
1. 快速理解新代码库
接手一个陌生项目?
cd /path/to/project
claude> give me an overview of this codebase
> explain the main architecture patterns used here
> what are the key data models?
> which files would I need to modify to add a new API endpoint?
Claude Code 会自动读取项目文件,生成结构化的代码库概览,通常比手动阅读 README 快得多。
2. 高效调试
遇到 Bug,直接描述问题:
> 运行 npm test 时出现以下错误,帮我找出根本原因:[粘贴错误信息]
> 这个函数在边界条件下行为异常,帮我分析所有可能的问题
> 检查 src/api/auth.js,找出可能导致 JWT 验证失败的地方
Claude Code 会主动读取相关文件、追踪调用链,而不只是猜测。
3. Plan Mode:先规划后执行
Plan Mode 是 Claude Code 最重要的安全工作模式:先制定计划,等你确认后再执行。
何时使用 Plan Mode
- 重构影响多个文件的代码
- 不熟悉代码库时
- 想先理解 Claude 的思路再允许修改
- 任何高风险操作前
如何使用
方法一:对话中开启
> 先不要做任何修改,只告诉我你打算怎么重构这个认证模块
方法二:设为默认
在 ~/.claude/settings.json 中:
{
"defaultMode": "plan"
}开启后,所有操作都先生成计划,你明确说「执行」或「go ahead」后才真正修改文件。
实际示例:规划复杂重构
> 我想把整个用户认证系统从 session-based 改为 JWT,先给我一个详细的重构计划,不要动任何代码
Claude Code 会列出:
- 需要修改的文件列表
- 每个文件的具体变更
- 潜在风险和需要注意的点
- 建议的测试策略
确认计划合理后,再说「开始执行」。
4. 测试工作流
> 为 src/utils/validation.js 中的所有导出函数写 Jest 单元测试
> 当前测试覆盖率只有 45%,帮我找出哪些关键路径没有测试覆盖
> 这个测试用例一直失败,帮我分析原因:[粘贴测试代码]
5. 创建 Pull Request
> 帮我为这次修改写一个详细的 PR 描述,包含改动原因、变更内容和测试方法
> 根据这个 issue 的要求,生成完整的 PR 包括代码修改和描述
Claude Code 会分析 git diff,生成结构清晰的 PR 描述。
6. 并行处理多任务(Git Worktrees)
需要同时处理多个功能分支?使用 Git Worktrees:
# 为新功能创建独立工作树
git worktree add ../feature-auth feature/auth-refactor
git worktree add ../bugfix-api bugfix/api-timeout
# 在不同终端中各启动一个 Claude Code
cd ../feature-auth && claude
cd ../bugfix-api && claude两个 Claude Code 实例同时工作,互不干扰,各自有独立的文件上下文。
7. 扩展思考模式(Thinking Mode)
对于复杂的架构决策或算法问题:
> 我需要设计一个支持百万并发用户的消息队列系统,请深度思考后给出方案
在 ~/.claude/settings.json 中配置:
{
"thinkingMode": "auto"
}auto 模式让 Claude 自行判断何时需要深度思考;always 则每次都启用。
8. 作为 Unix 工具使用
# 分析 git log 并总结
git log --oneline -20 | claude -p "总结这些提交的主要变更"
# 代码审查
git diff HEAD~1 | claude -p "审查这次提交,找出潜在问题"
# 文档生成
cat src/api.js | claude -p "为这个文件的所有导出函数生成 JSDoc 注释"-p 标志(或 --print)让 Claude Code 以非交互模式运行,适合管道和脚本集成。
9. 会话管理
claude --continue # 继续上一个会话
claude --resume # 交互式选择要恢复的会话
claude -c "项目名称" # 按名称搜索并恢复会话命名会话让你之后能快速找回特定项目的上下文。
10. 处理图像
Claude Code 支持视觉输入:
> [拖拽一张 UI 设计图到终端]
> 根据这张设计图实现对应的 React 组件
> [拖拽一张报错截图]
> 分析这个错误并给出修复方案
原文整理自:Common workflows - Claude Code | 来源:Anthropic 官方文档