Anthropic官方文档里有一页"Common Workflows"(常用工作流),覆盖用Claude Code做日常开发的全套场景——老金把它完整翻译并整理成了这篇中文指南。与其在各种教程里拼凑技巧,不如直接读官方的第一手用法:探索陌生代码库、修Bug、重构、写测试、创建PR、管理会话,每个场景都附了可直接复制的提示词。

一、日常场景的官方套路
理解新代码库:从宽泛问题开始("给我这个代码库的概览")→缩小到特定领域("解释主要架构模式""身份验证如何处理")→询问编码规范和项目术语表。修Bug:分享完整错误信息→要几个修复建议→应用修复;要告知重现命令、是否间歇性。重构:先找遗留代码("查找已弃用API的用法")→要建议→小增量应用→跑测试验证,要求保持行为不变。测试:先找未覆盖的函数→生成测试脚手架→补边缘情况用例→运行修复;Claude会匹配你项目已有的测试风格。文档与PR:找未注释的函数→生成文档→增强示例;/commit-push-pr技能一步完成提交推送开PR。
二、三个高价值特性
子智能体:/agents命令查看并创建专用子智能体——描述性强的description字段可启用自动委派("review my recent changes for security issues"会自动派给安全审查体);.claude/agents/目录可放团队共享的定制体。计划模式:Shift+Tab循环切换或 --permission-mode plan 启动——只读分析代码后先出计划,适合多步骤实现和探索性研究;Ctrl+G可在编辑器里直接改计划再让Claude执行。图像输入:拖放/粘贴/给路径三种方式,错误截图、UI设计稿、数据库架构图都能作为上下文("生成匹配这个设计稿的CSS")。
三、容易被忽略的效率细节
@引用:@文件路径把完整内容包含进对话,@目录看结构,还能引用MCP资源——比让Claude自己找快得多。扩展思考:默认启用,最多31,999 Token的推理预算,适合架构决策和棘手Bug;Alt+T切换,MAX_THINKING_TOKENS环境变量可设上限(注意:即使显示的是摘要思考,所有思考Token都计费)。会话管理:尽早用/rename给会话起描述性名字("payment-integration"远比"explain this function"好找);claude --continue接最近对话,--resume按名恢复,--from-pr恢复PR关联会话。Git Worktrees并行:不同分支检出到不同目录,每个worktree跑一个Claude实例互不干扰——多任务并行的正确姿势。Unix管道:`cat build-error.txt | claude -p '解释根因' > output.txt`,--output-format支持text/json/stream-json,可把Claude当linter或代码审查员嵌进CI脚本。
我的总结:Claude Code的站内三层已经齐了——效率最大化三件事:CLAUDE.md、角色定义与Token陷阱(先做规范再做工作流)和Folkbench Switch:一个开关切换Claude Code / Codex(多工具切换的工程细节),配合本篇官方手册,从入门到并行开发的全路径就通了。