教程

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 自定义斜杠命令完全指南:用 /命令 封装常用工作流Claude Code 自定义斜杠命令(slash commands)完整教程:命令文件创建位置(.claude/commands/)、Markdown 格式规范、$ARGUMENTS 参数传递、项目级命令 vs 用户全局命令的区别、实用命令示例(/review、/test、/deploy-check、/refactor、/standup)、命令组合调用,以及如何在团队中共享和版本管理自定义命令。2026/3/18教程Claude Code 调试技巧大全:让 AI 帮你高效定位和修复 BugClaude Code 调试实战指南:错误信息分析技巧、堆栈追踪解读、断点调试辅助、日志分析、复杂 Bug 根因分析框架、多文件依赖排查、性能问题定位,以及 Python/JavaScript/TypeScript 各语言调试最佳实践。2026/3/15教程Claude Code Skills 自定义命令:打造你的团队专属 AI 工作流Claude Code Skills 自定义命令完整教程:Skills vs CLAUDE.md 使用场景对比、内置 Skills 速览(/batch/simplify/loop)、SKILL.md 文件格式与 Frontmatter 配置、四大实用 Skills 示例(代码审查/部署检查/功能开发/团队 OnBoarding)、传参方式、子代理执行与 Git 团队共享。2026/3/14教程Claude Code Hooks 实战指南:5 大自动化场景、三种 Hook 类型与故障排查Claude Code Hooks 实战指南:/hooks 交互菜单四步创建桌面通知 Hook、5 大常用自动化场景(等待通知/编辑后 Prettier 格式化/退出码 2 阻止受保护文件/PostCompact 重注入上下文/ConfigChange 审计日志)、四种 Hook 类型(command/prompt-based/agent-based/HTTP Webhook)、输入/输出机制(stdin JSON/stdout 注入上下文/退出码 0 继续/2 阻止/非零警告)、结构化 JSON 输出、Matcher 过滤器语法(Edit|Write/Bash(git *)/*/空字符串)、四级存储位置,以及五大故障排查方法和调试技巧。2026/3/8教程Claude Code Hooks 完全指南:五大自动化场景、三类 Hook 类型与 JSON 输入输出规范Claude Code Hooks 完整指南:30 秒创建第一个 Hook(/hooks 交互菜单)、五大常用场景(通知/自动格式化/保护文件/压缩后注入上下文/审计配置变更)、六个生命周期事件(PreToolUse/PostToolUse/Notification/PostCompact/SessionStart/Stop)、四类 Hook 类型(Command/Prompt/Agent/HTTP)、JSON 输入输出规范(decision/reason/output/updatedInput)、Matcher 过滤语法,以及五大故障排查方法。2026/3/6