本文整理了 Claude Code 在日常开发中最常用的工作流模式,每个场景都附有可直接使用的提示词示例。
理解新代码库
快速获得全局概览
# 进入项目目录后启动 Claude Code
cd /path/to/project
claude
# 获取高层次概览
> 给我这个代码库的概览
# 深入特定方面
> 解释这里使用的主要架构模式
> 主要的数据模型有哪些?
> 认证是如何处理的?技巧:先问宏观问题,再逐步聚焦;询问项目特定术语的词汇表;了解编码约定。
找到相关代码
> 找到处理用户认证的文件
> 这些认证文件是如何协作的?
> 从前端到数据库追踪登录流程
建议:安装对应语言的代码智能插件,给 Claude 提供精确的「跳转到定义」和「查找引用」导航能力。
高效调试
# 分享错误信息
> 运行 npm test 时我看到这个错误:[粘贴错误]
# 让 Claude 提供修复建议
> 建议几种修复 user.ts 中 @ts-ignore 的方法
# 应用修复
> 更新 user.ts,添加你建议的 null 检查提供的信息越具体,结果越好:告诉 Claude 重现问题的命令、错误是否间歇性出现、相关的堆栈跟踪。
重构旧代码
# 识别需要重构的遗留代码
> 找出所有使用旧版 Promise 而不是 async/await 的文件
# 理解当前实现
> 解释这个认证流程是如何工作的
# 现代化升级
> 将认证系统更新为使用 JWT Token重要原则:重构前询问 Claude 的计划;大型重构时使用 Plan Mode;要求 Claude 每次修改后运行测试。
使用专属 Subagent
将特定探索任务委托给 Subagent,保护主上下文:
> 使用 subagent 调查认证系统如何处理 Token 刷新,
> 以及是否有可复用的 OAuth 工具
Subagent 探索代码库、读取相关文件,汇报发现,主对话不受污染。
Plan Mode:安全的代码分析模式
Plan Mode 让 Claude 在只读模式下分析代码并制定计划,不做任何修改。
何时使用 Plan Mode
| 场景 | 说明 |
|---|---|
| 风险操作 | 大规模重构、数据库迁移、架构变更 |
| 不熟悉的代码库 | 在修改前充分理解代码 |
| 团队协作 | 让计划可见并可供讨论 |
| 用户偏好 | 你在做决定前始终想看到计划 |
使用方法
# 启动 Plan Mode
claude --plan
# 或在 VS Code 侧边栏切换
# 或按 Shift+Tab 在对话中切换
# 示例:复杂重构的规划
> 我们的 Node.js 应用使用回调函数。
规划出将认证模块迁移到 async/await 的方案,
而不修改任何文件。
# Claude 分析后输出:
# - 需要修改的文件和位置
# - 正确的错误处理方法
# - 受影响的代码路径
# - 潜在风险点设置 Plan Mode 为默认
// settings.json
{
"defaultMode": "plan"
}测试工作流
# 为现有代码生成测试
> 为 CartService 创建全面的测试
# TDD 工作流
> 为用户注册写一个失败的测试:
用户应该能用邮件和密码注册,
密码必须 8 位以上
> 实现让测试通过的代码
# 提升测试覆盖率
> 找出未被测试覆盖的代码区域,
并为最关键的 Gap 添加测试创建 Pull Request
# 让 Claude 创建 PR
> 创建一个 PR
# Claude 会自动:
# - 分析 diff
# - 创建结构化的 PR 标题和描述
# - 总结关键变更
# - 使用 gh CLI 提交处理文档
# 生成文档
> 为 DateUtils 文件中的所有公共方法写 JSDoc
# 编写 README
> 为这个项目写一个全面的 README,
包含安装步骤、使用示例和配置选项
# 文档翻译
> 将 README 翻译为西班牙语、保持技术术语原文使用扩展思考(Thinking Mode)
对于复杂架构问题,激活扩展思考获得更深入的分析:
# 在提示中包含 "think" 相关词语
> 仔细考虑我们认证系统的安全漏洞
# 或使用 --thinking 标志
claude --thinking high
# 具体思考时间控制
> think hard: 我们的微服务架构最佳实践是什么?
> think harder: 把所有用户数据迁移到新模式的最佳策略?思考模式级别:
think:基础扩展思考think hard:更深入分析think harder:全面、彻底的分析ultrathink:最大思考深度(最高 Token 消耗)
Git Worktree 并行会话
使用 Git Worktree 同时在多个功能上工作,每个 Claude Code 实例独立操作自己的 Worktree,避免冲突:
# 创建 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 # 终端 2Subagent 自动 Worktree:在 Subagent Markdown 文件中设置 isolation: worktree,Subagent 在隔离的 Git Worktree 中自动运行。
通知系统
当 Claude 需要你注意时收到系统通知:
# macOS
claude --notification
# 或在 settings.json 中配置
# 通过系统通知了解 Claude 何时完成或需要输入Unix 风格管道用法
Claude Code 可以作为命令行工具融入脚本和管道:
# 从文件读取内容
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 官方文档