教程

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 官方文档

相关文章推荐

教程Claude Code 常用工作流完全指南:理解代码库、调试、重构与并行会话Claude Code 日常开发工作流全面指南:理解新代码库的提示技巧、高效调试策略、重构方法论、Plan Mode 使用场景、TDD 测试工作流、Git Worktree 并行开发,以及 Unix 管道用法等,每个场景都附有可直接复用的提示词示例。2026/2/28教程Claude Code Ultraplan 完整指南:云端规划 + 本地执行的全新工作流Ultraplan 官方完整使用指南:三种触发方式(/ultraplan 命令/关键词/从本地 Plan 升级);终端三种状态指示器(researching/needs input/ready);浏览器审阅界面(内联评论/Emoji 反馈/章节导航);两种执行方案(云端直接执行创建 PR/传送回本地 Terminal 的三选项);Ultraplan vs 本地 Plan vs Ultrareview 对比;以及 5 个实战技巧(先澄清/评论要具体/大任务才用/加约束/保存计划文件)。2026/5/6教程Claude Code Plan Mode 深度指南:用「先想再做」模式彻底消灭 AI 蝴蝶效应Claude Code Plan Mode 完整指南:蝴蝶效应是什么以及为什么危险、Plan Mode 工作原理、什么时候用什么时候不用的详细清单、采访模式大功能必用流程、Plan Mode + 新 Session 黄金组合,以及完整的限流功能实现案例演示。2026/4/18教程Claude Code Plan Mode 深度解析:让 AI 先想清楚再动手,避免改代码越改越乱Claude Code Plan Mode 深度解析:进入只读分析模式,让 AI 先制定完整方案再动手,彻底解决「越改越乱」。含典型工作流、4 大使用价值和场景判断。2026/4/9教程Claude Code Sub-agents 官方完整指南:内置 Agent、自定义配置、并行模式和 Fork 会话Claude Code Sub-agents 官方文档完整整理:解决的核心问题(保护上下文/成本控制);三个内置 Sub-agent(Explore/Plan/General-purpose 及各自模型和工具);/agents 创建流程(界面/描述生成/工具选择/持久内存配置);完整 Frontmatter 字段参考;模型选择策略(Haiku 探索→Sonnet 审查→Opus 复杂任务);MCP 服务器限定到 Sub-agent;自动委托 vs 显式调用;前台/后台运行;隔离高容量/并行调研/链式 Sub-agent 三种模式;Fork 会话(与命名 Sub-agent 的区别);以及 4 个官方示例配置。2026/5/8教程Claude Code 官方最佳实践完全指南:Anthropic 工程团队总结的 25 条黄金法则Anthropic 官方 Best Practices 完整整理:核心约束(上下文管理);给 Claude 可验证标准(最高杠杆);探索→规划→实现→提交四步流程;精准提示 4 策略;丰富上下文输入方式;CLAUDE.md 有效写法(含 ✅/❌ 清单和 @ 引入语法);权限预设;CLI 工具配置;MCP 服务器选择;Hooks 自动化;Skills vs CLAUDE.md 选择;高效沟通技巧;会话管理(提前纠正/激进 /compact/Subagent 调研);以及非交互模式和多 Session 并行的规模化技巧。2026/5/8