Claude Code 常用工作流程

公众号名称：奇点先锋

作者名称：扶苏

发布时间：2026-05-25 08:00

最近 Anthropic 更新了 Claude Code 的官方文档，里面藏了一整套日常开发工作流，这可能是我们构建多智能体系统方式迄今为止最大的转变。我仔细啃完发现，很多开发者还在用最原始的方式跟它交互——提问像挤牙膏，代码改完不敢提交。这篇文章我把官方文档里最精华的 Common workflows 全部拆解出来，从读陌生代码、修 Bug、安全重构、写测试、创建 PR，到并行开发、plan mode、子代理委派，一条不落。

太长不看（TL;DR）：

🔥 先用宽泛问题再逐步收窄，是理解陌生代码库最快的姿势
🔥 Bug 修复三板斧：报错误信息 → 要修复方案 → 让 Claude 直接改
🔥 大项目用子代理做调研，主上下文保持清爽

一、Prompt 配方：日常开发的万能模板

这一节是整篇文章的核心。下面每个场景都来自官方文档，直接拿去用。

1.1 快速理解陌生代码库

刚接手一个新项目？别慌，按这个节奏来：

第一步：导航到项目根目录

cd /path/to/project

第二步：启动 Claude Code

claude

第三步：要一个高层概览

给我这个代码库的整体概览

第四步：深入具体模块

解释一下这里用到的主要架构模式

核心数据模型有哪些？

认证是怎么处理的？

💡 小贴士：

先问大的，再问小的。 别上来就钻细节
问问项目的编码规范和约定
让 Claude 帮你整理一份项目专属术语表

1.2 精准定位相关代码

想知道某个功能对应的代码在哪？别自己手动翻文件了：

第一步：让 Claude 找到相关文件

找出处理用户认证的所有文件

第二步：了解组件之间如何协作

这些认证文件是怎么配合工作的？

第三步：理清执行流程

从前端到数据库，完整走一遍登录流程

💡 小贴士：

描述要具体。 说 “用户认证” 比说 “那个登录的东西” 强
用项目自己的领域语言去提问
装一个 code intelligence 插件，让 Claude 能精准跳转定义和查找引用

1.3 高效修 Bug

线上报错了？这个工作流你一定用得上：

第一步：把错误信息告诉 Claude

我运行 npm test 的时候报了一个错误

第二步：要修复方案

给我几个修复 user.ts 里那个 @ts-ignore 的方案

第三步：直接应用修改

按你建议的方案，在 user.ts 里加上 null 检查

💡 小贴士：

告诉 Claude 复现步骤，让它自己跑命令拿 stack trace
说明错误是必现还是偶发
别光贴错误信息，说说你在干嘛的时候触发的

1.4 安全重构

祖传代码看着难受？重构要稳扎稳打：

第一步：找出需要重构的旧代码

在我们的代码库里找出已废弃的 API 调用

第二步：获取重构建议

建议一下怎么把 utils.js 重构为使用现代 JavaScript 特性

第三步：安全地应用修改

用 ES2024 特性重构 utils.js，同时保持行为不变

第四步：验证重构结果

对重构后的代码跑测试

💡 小贴士：

小步重构，步步有测试。 别一口气改一百个文件
需要兼容老接口的话，提前说清楚
让 Claude 解释新写法的好处，学习两不误

1.5 写测试

有没有没被测试覆盖的代码？让 Claude 帮你找：

第一步：找出未经测试的代码

找出 NotificationsService.swift 中没有被测试覆盖的函数

第二步：生成测试脚手架

为通知服务添加测试

第三步：补充有意义的测试用例

为通知服务中的边界条件添加测试用例

第四步：运行并验证测试

跑一下新测试，修复所有失败的用例

💡 小贴士：

Claude 会 自动匹配项目现有的测试风格 和框架。你问它写测试的时候，它先看你的项目里已有的测试文件，照着风格、框架和断言写法来
提问时越具体越好， 说清楚你想验证什么行为
让 Claude 帮你发现容易忽略的边界条件、异常路径和意外输入

1.6 创建 PR

改完代码想提 PR？一句话就行：

第一步：总结你的改动

总结一下我对认证模块做了哪些改动

第二步：生成 PR

创建一个 PR

第三步：审查并优化描述

在 PR 描述里补充更多关于安全改进的背景信息

💡 小贴士：

用 gh pr create 创建的 PR，Claude Code 会 自动关联当前会话
下次回来时用 claude --from-pr 或直接贴 PR URL 恢复上下文
⚠️ 提交前一定自己审查一遍 Claude 生成的 PR，让它标出潜在风险点和需要考虑的地方

1.7 搞定文档

哪些函数没写注释？让 Claude 帮你扫：

第一步：找出未写文档的代码

找出 auth 模块中没有 JSDoc 注释的函数

第二步：生成文档

给 auth.js 里那些没文档的函数加上 JSDoc 注释

第三步：审查并增强

改进生成的文档，补充更多上下文和示例

第四步：验证文档质量

检查一下文档是否符合我们项目的规范

💡 小贴士：

指定文档风格（JSDoc、docstring 等）
让 Claude 在文档里加示例代码
公共 API、接口定义、复杂逻辑是文档的三大重点

1.8 在非代码目录工作

Claude Code 不只是写代码的工具。你把它跑在笔记库、文档目录、Markdown 集合里，它照样能搜索、编辑、重组内容。

.claude/ 目录和 CLAUDE.md 跟其他工具的配置目录和平共处，不冲突。Claude 每次工具调用都会重新读取文件，所以你在别的编辑器里改了内容，它下次读的时候就能看到。

简单说：你的笔记 vault 也能被 Claude Code 管起来。

1.9 用图片辅助工作

有些东西文字说不清？上截图。

第一步：添加图片到对话

支持三种方式：

拖拽图片到 Claude Code 窗口
Ctrl+V 粘贴剪贴板里的图片（注意是 Ctrl，不是 Cmd）
直接给路径：分析这张图片: /path/to/your/image.png

第二步：让 Claude 分析图片

这张图片显示了什么？

描述一下这个截图里的 UI 元素

这个图里有没有有问题的地方？

第三步：用图片提供上下文

这是报错的截图，什么原因导致的？

这是我们当前的数据库 schema，为了支持新功能该怎么改？

第四步：从视觉内容生成代码

生成能匹配这个设计稿的 CSS

这个组件应该用什么样的 HTML 结构来复现？

💡 小贴士：

错误截图、UI 设计稿、架构图，全都支持
一次对话可以用多张图
Claude 提到 [Image #1] 时，Cmd+点击（Mac）或 Ctrl+点击（Win/Linux）就能在新窗口查看

1.10 引用文件和目录

用 @ 前缀可以快速包含文件或目录：

第一步：引用单个文件

解释一下 @src/utils/auth.js 里的逻辑

这会把文件的完整内容加载到对话里。

第二步：引用目录

@src/components 的结构是怎样的？

这会返回目录列表及文件信息。

第三步：引用 MCP 资源

展示来自 @github:repos/owner/repo/issues 的数据

这会从已连接的 MCP 服务器获取数据，格式为 @server:resource。

💡 小贴士：

文件路径可以是相对路径也可以是绝对路径
@ 引用会自动加载对应目录和父目录的 CLAUDE.md
一次消息可以引用多个文件：@file1.js 和 @file2.js

1.11 定时自动任务

想让 Claude 每天自动帮你 review 未关闭的 PR？每周自动审计依赖？四种方案可选：

方案	运行位置	适合场景
Routines	Anthropic 基础设施	电脑关机也能跑，支持 API 调用和 GitHub 事件触发
Desktop 定时任务	你的机器 + 桌面端	需要访问本地文件、未提交变更
GitHub Actions	CI 流水线	跟 PR 等仓库事件绑定的任务
`/loop`	当前 CLI 会话	快速轮询，适合会话开着时用

⚠️ 写 Prompt 的注意事项： 定时任务在后台自动跑，没法问你问题。所以 Prompt 里要 明确成功的标准和结果的处理方式，比如：

“请评审所有标记为 needs-review 的开放 PR，针对发现的问题添加行内评论，并在 #eng-reviews Slack 频道中发布评审总结。“

1.12 询问 Claude 自身能力

Claude 能随时访问自己的最新文档，你可以直接问它：

Claude Code 能创建 PR 吗？

Claude Code 的权限机制是怎么工作的？

有哪些可用的 skills？

怎么在 Claude Code 里用 MCP？

怎么把 Claude Code 配置为使用 Amazon Bedrock？

Claude Code 有什么局限性？

Claude 会基于文档回答这些问题。想动手实操的话，可以跑 /powerup 进入带动画演示的交互课程，或者直接参考上面的工作流章节。

💡 小贴士：

不管你的 Claude Code 是什么版本， 它总能拿到最新的官方文档
问得越具体，回答越详细
Claude 能解释 MCP 集成、企业级配置、子代理等高级功能

二、恢复之前的对话

一个任务分多次做？不用重新解释上下文。Claude Code 会把每次对话都保存到本地。

claude --continue

这条命令会恢复当前目录的最近一次会话。如果没有记录，会提示 No conversation found to continue 然后退出。

想用列表选之前的会话：

claude --resume

在运行中的会话里也可以用 /resume 命令。

三、用 worktree 并行开发

一个终端修 Bug，另一个终端写 Feature，两边互不干扰。每个 worktree 是独立分支上的独立 checkout。

claude --worktree feature-auth

在另一个终端用不同的名字再跑一次命令，就是并行开发了。

想看所有并行会话的汇总而不是在多个终端间切换？用 background agents 可以在一个屏幕里监控。关于 worktree 的清理、.worktreeinclude 配置和非 git VCS 支持，详见 Worktree 文档。

四、编辑前先规划

有些改动你想在落盘之前先审查一遍？切换到 plan mode：

claude --permission-mode plan

Claude 会读取文件、提出修改计划，但 在你批准之前不会做任何改动。

在运行中的会话里，按 Shift+Tab 也可以随时切换进 plan mode。关于审批流程和用文本编辑器直接修改计划的细节，详见 Plan mode 文档。

五、把调研任务委派给子代理

探索大代码库时，大量文件读会撑爆你的上下文。让子代理去干活：

让子代理去调研一下我们的认证系统是怎么处理 token 刷新的

子代理在 自己的上下文窗口里读文件，然后只把结论汇报回来。主上下文干干净净，不被淹没。

还可以自定义子代理的工具集和 Prompt，让它们变成专属领域的专家。详见 Subagents 文档。

六、管道模式：把 Claude 接入脚本

在 CI、pre-commit hook 或者批量处理中非交互式地跑 Claude：

git log --oneline -20 | claude -p "总结最近的提交"

Stdin 和 stdout 都支持，Claude Code 在管道里就是一个普通 Unix 工具。关于输出格式、权限标志和扇出模式，详见 Non-interactive mode 文档。

总结

Claude Code 的强大不只是 “能写代码”，更在于 一整套围绕开发者日常工作的流程体系。上面的每个工作流都是官方验证过的最佳实践，建议挑几个明天就试试。

核心就一句话：把 Claude Code 当成你的 pair programmer，而不是一个高级 autocomplete。 你会打开新世界的大门。

内容效果不满意？点此反馈