教程

Claude Code 常用工作流完全指南:理解代码库、调试、重构与并行会话

Claude Code 日常开发工作流全面指南:理解新代码库的提示技巧、高效调试策略、重构方法论、Plan Mode 使用场景、TDD 测试工作流、Git Worktree 并行开发,以及 Unix 管道用法等,每个场景都附有可直接复用的提示词示例。

2026/2/285分钟 阅读ClaudeEagle

本文整理了 Claude Code 在日常开发中最常用的工作流模式,每个场景都附有可直接使用的提示词示例。

理解新代码库

快速获得全局概览

bash
# 进入项目目录后启动 Claude Code
cd /path/to/project
claude

# 获取高层次概览
> 给我这个代码库的概览

# 深入特定方面
> 解释这里使用的主要架构模式
> 主要的数据模型有哪些?
> 认证是如何处理的?

技巧:先问宏观问题,再逐步聚焦;询问项目特定术语的词汇表;了解编码约定。

找到相关代码

> 找到处理用户认证的文件 > 这些认证文件是如何协作的? > 从前端到数据库追踪登录流程

建议:安装对应语言的代码智能插件,给 Claude 提供精确的「跳转到定义」和「查找引用」导航能力。

高效调试

bash
# 分享错误信息
> 运行 npm test 时我看到这个错误:[粘贴错误]

# 让 Claude 提供修复建议
> 建议几种修复 user.ts 中 @ts-ignore 的方法

# 应用修复
> 更新 user.ts,添加你建议的 null 检查

提供的信息越具体,结果越好:告诉 Claude 重现问题的命令、错误是否间歇性出现、相关的堆栈跟踪。

重构旧代码

bash
# 识别需要重构的遗留代码
> 找出所有使用旧版 Promise 而不是 async/await 的文件

# 理解当前实现
> 解释这个认证流程是如何工作的

# 现代化升级
> 将认证系统更新为使用 JWT Token

重要原则:重构前询问 Claude 的计划;大型重构时使用 Plan Mode;要求 Claude 每次修改后运行测试。

使用专属 Subagent

将特定探索任务委托给 Subagent,保护主上下文:

> 使用 subagent 调查认证系统如何处理 Token 刷新, > 以及是否有可复用的 OAuth 工具

Subagent 探索代码库、读取相关文件,汇报发现,主对话不受污染。

Plan Mode:安全的代码分析模式

Plan Mode 让 Claude 在只读模式下分析代码并制定计划,不做任何修改。

何时使用 Plan Mode

场景说明
风险操作大规模重构、数据库迁移、架构变更
不熟悉的代码库在修改前充分理解代码
团队协作让计划可见并可供讨论
用户偏好你在做决定前始终想看到计划

使用方法

bash
# 启动 Plan Mode
claude --plan

# 或在 VS Code 侧边栏切换
# 或按 Shift+Tab 在对话中切换

# 示例:复杂重构的规划
> 我们的 Node.js 应用使用回调函数。
  规划出将认证模块迁移到 async/await 的方案,
  而不修改任何文件。

# Claude 分析后输出:
# - 需要修改的文件和位置
# - 正确的错误处理方法
# - 受影响的代码路径
# - 潜在风险点

设置 Plan Mode 为默认

json
// settings.json
{
  "defaultMode": "plan"
}

测试工作流

bash
# 为现有代码生成测试
> 为 CartService 创建全面的测试

# TDD 工作流
> 为用户注册写一个失败的测试:
  用户应该能用邮件和密码注册,
  密码必须 8 位以上

> 实现让测试通过的代码

# 提升测试覆盖率
> 找出未被测试覆盖的代码区域,
  并为最关键的 Gap 添加测试

创建 Pull Request

bash
# 让 Claude 创建 PR
> 创建一个 PR

# Claude 会自动:
# - 分析 diff
# - 创建结构化的 PR 标题和描述
# - 总结关键变更
# - 使用 gh CLI 提交

处理文档

bash
# 生成文档
> 为 DateUtils 文件中的所有公共方法写 JSDoc

# 编写 README
> 为这个项目写一个全面的 README,
  包含安装步骤、使用示例和配置选项

# 文档翻译
> 将 README 翻译为西班牙语、保持技术术语原文

使用扩展思考(Thinking Mode)

对于复杂架构问题,激活扩展思考获得更深入的分析:

bash
# 在提示中包含 "think" 相关词语
> 仔细考虑我们认证系统的安全漏洞

# 或使用 --thinking 标志
claude --thinking high

# 具体思考时间控制
> think hard: 我们的微服务架构最佳实践是什么?
> think harder: 把所有用户数据迁移到新模式的最佳策略?

思考模式级别

  • think:基础扩展思考
  • think hard:更深入分析
  • think harder:全面、彻底的分析
  • ultrathink:最大思考深度(最高 Token 消耗)

Git Worktree 并行会话

使用 Git Worktree 同时在多个功能上工作,每个 Claude Code 实例独立操作自己的 Worktree,避免冲突:

bash
# 创建 Worktree
git worktree add ../project-feature-a feature-a
git worktree add ../project-feature-b feature-b

# 在各 Worktree 中启动独立的 Claude Code
cd ../project-feature-a && claude  # 终端 1
cd ../project-feature-b && claude  # 终端 2

Subagent 自动 Worktree:在 Subagent Markdown 文件中设置 isolation: worktree,Subagent 在隔离的 Git Worktree 中自动运行。

通知系统

当 Claude 需要你注意时收到系统通知:

bash
# macOS
claude --notification

# 或在 settings.json 中配置
# 通过系统通知了解 Claude 何时完成或需要输入

Unix 风格管道用法

Claude Code 可以作为命令行工具融入脚本和管道:

bash
# 从文件读取内容
cat logs.txt | claude -p "找出这个日志文件中的错误"

# 控制输出格式
claude -p "列出所有 API 端点" --output-format json

# 流式输出
claude -p "分析这段代码" --output-format stream-json

# 在提交前验证代码
git diff | claude -p "审查这些更改,查找 Bug 和改进空间"

原文:Common workflows - Claude Code Docs | 来源:Claude Code 官方文档

相关文章推荐

教程Claude Code 常用工作流完全指南:探索代码库、调试、重构与 Plan ModeClaude Code 10 大核心工作流完全指南:快速理解新代码库、高效调试、Plan Mode 先规划后执行、测试工作流、PR 创建、Git Worktrees 并行处理多任务、扩展思考模式、Unix 管道集成、会话管理和图像输入处理。2026/3/2教程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