教程

Claude Code 常用工作流完全指南:探索代码库、调试、重构与 Plan Mode

Claude Code 10 大核心工作流完全指南:快速理解新代码库、高效调试、Plan Mode 先规划后执行、测试工作流、PR 创建、Git Worktrees 并行处理多任务、扩展思考模式、Unix 管道集成、会话管理和图像输入处理。

2026/3/24分钟 阅读ClaudeEagle

本文整理了 Claude Code 的核心日常工作流,包含可直接复用的 prompt 示例,覆盖从理解新代码库到并行处理多个任务的完整场景。

1. 快速理解新代码库

接手一个陌生项目?

bash
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 中:

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:

bash
# 为新功能创建独立工作树
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 中配置:

json
{
  "thinkingMode": "auto"
}

auto 模式让 Claude 自行判断何时需要深度思考;always 则每次都启用。

8. 作为 Unix 工具使用

bash
# 分析 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. 会话管理

bash
claude --continue              # 继续上一个会话
claude --resume                # 交互式选择要恢复的会话
claude -c "项目名称"           # 按名称搜索并恢复会话

命名会话让你之后能快速找回特定项目的上下文。

10. 处理图像

Claude Code 支持视觉输入:

> [拖拽一张 UI 设计图到终端] > 根据这张设计图实现对应的 React 组件 > [拖拽一张报错截图] > 分析这个错误并给出修复方案

原文整理自:Common workflows - Claude Code | 来源:Anthropic 官方文档