Claude Code 日常工作流速查：读代码、修 bug、重构、测试到提 PR

Claude Code 上手不难,难的是把它真正揉进日常开发里——读陌生代码、修 bug、重构、补测试、提 PR,每个环节怎么问、用什么命令,才最省事。这篇把官方的 common workflows 速查整理成一份能直接抄的中文手册:前半是日常提示词配方,后半是几个能显著提效的进阶玩法。

每个提示词配方在 CLI、VS Code、Desktop 等任何界面都通用,你按自己的项目改改措辞即可。

一、读懂一个陌生代码库

先要个全局概览

刚进一个新项目,别急着钻细节。cd 到项目根目录、启动 claude,然后从粗到细地问:

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

拿到概览后再逐层下钻:

解释这里用到的主要架构模式
关键的数据模型有哪些?
认证是怎么处理的?

技巧: 先问大的、再收窄;顺手让它列一份项目专有术语表,以及项目里的编码约定和惯用模式。

定位相关代码

要找某个功能对应的代码:

找出处理用户认证的文件
这些认证文件是怎么协同工作的?
追踪登录流程,从前端一直到数据库

技巧: 说得具体些,用项目里的领域术语。给你的语言装一个代码智能插件,能让 Claude 用上精确的"跳转到定义"“查找引用"导航。

二、高效修 bug

碰到报错时,三步走:

我运行 npm test 时看到一个错误
建议几种修复 user.ts 里这个 @ts-ignore 的办法
更新 user.ts,加上你建议的空值检查

技巧: 把能复现问题的命令告诉它,让它拿到堆栈跟踪;说清复现步骤;告诉它这个错误是偶发还是稳定复现。

三、安全地重构

把老代码升级到现代写法,关键是小步、可测:

找出我们代码库里已废弃的 API 用法
建议怎么把 utils.js 重构成现代 JavaScript 写法
在保持行为不变的前提下,用 ES2024 特性重构 utils.js
为重构后的代码跑测试

技巧: 让它解释新写法好在哪;需要时要求保持向后兼容;分成小而可测的增量做,别一次性大改。

四、和测试打交道

给没覆盖的代码补测试:

找出 NotificationsService.swift 里没有被测试覆盖的函数
给通知服务加上测试
为通知服务补上边界条件的测试用例
跑新测试,修掉所有失败

Claude 会先翻你已有的测试文件,照着现有的风格、框架和断言模式来写,而不是自顾自地造一套。要全面覆盖的话,直接让它帮你找容易漏掉的边界情况——错误路径、边界值、异常输入,它能分析代码路径并给出建议。

五、生成 Pull Request

最简单就是一句话:给我的改动建个 pr。想更可控就分步来:

总结一下我对认证模块做的改动
建个 pr
在 PR 描述里补充更多关于这次安全改进的背景

一个关键细节: 当你用 gh pr create 建 PR 时,会话会自动关联到那个 PR。以后想回到它,运行 claude --from-pr <编号>,或把 PR 链接粘进 /resume 选择器搜索即可。

技巧: 提交前先 review 一遍它生成的 PR,并让它指出潜在风险和注意点。

六、处理文档

找出 auth 模块里没有正经 JSDoc 注释的函数
给 auth.js 里没文档的函数加上 JSDoc 注释
把生成的文档润色一下,补充更多背景和示例
检查文档是否符合我们项目的规范

技巧: 指定文档风格(JSDoc、docstring 等);要求带示例;优先给公开 API、接口和复杂逻辑写文档。

七、在笔记和非代码目录里工作

别忘了 Claude Code 能在任何目录工作,不限于代码。把它跑在笔记库、文档文件夹、或任何一堆 markdown 里,搜索、编辑、重组内容,用法和写代码时一样。

.claude/ 目录和 CLAUDE.md 能和其他工具的配置目录和平共处。Claude 每次工具调用都重新读文件,所以你在别的应用里改了内容,它下次读到时就能看到最新版本。

八、和图片一起工作

把图喂给 Claude 有三种方式:

把图片拖进 Claude Code 窗口
复制图片后在 CLI 里 Ctrl+V 粘贴(注意是 Ctrl+V,不是 Cmd+V)
直接给路径:分析这张图:/path/to/image.png

然后就能让它分析、用作上下文、或据此出代码:

这张截图里的 UI 元素都是什么?
这是报错的截图,什么原因导致的?
生成 CSS 来还原这个设计稿
什么样的 HTML 结构能重建这个组件?

技巧: 文字描述说不清的时候就上图——报错截图、UI 设计、架构图都行;一次对话里可以放多张图。当 Claude 引用图片(如 [Image #1])时,Cmd+Click(Mac)或 Ctrl+Click(Win/Linux)能在默认查看器里打开它。

九、用 @ 引用文件和目录

用 @ 可以立刻把文件或目录塞进对话,不用等 Claude 自己去读:

解释 @src/utils/auth.js 里的逻辑          # 注入整个文件内容
@src/components 的结构是怎样的?            # 给出目录列表(不是内容)
给我看 @github:repos/owner/repo/issues    # 拉取已连接 MCP 服务器的数据

技巧: 路径可相对可绝对;@ 引用文件时,会把该文件所在目录及其父目录的 CLAUDE.md 一并带进上下文;一条消息里可以引用多个文件(如 @file1.js 和 @file2.js)。

十、让 Claude 按计划定时跑

想让某个任务周期性自动执行(每天早上 review PR、每周审计依赖、夜里查 CI 失败),按"想在哪跑"选方案:

方案	在哪跑	适合
Routines	Anthropic 托管的基础设施	电脑关机也要跑的任务;还能被 API 调用或 GitHub 事件触发
Desktop 定时任务	你本机(桌面 app)	需要直接访问本地文件、工具或未提交改动的任务
GitHub Actions	你的 CI 流水线	绑定仓库事件(如开 PR)、或想和 workflow 配置放一起的 cron
`/loop`	当前 CLI 会话	会话开着时的快速轮询;开新对话就停

技巧: 给定时任务写提示词时,务必说清"成功长什么样"以及结果怎么处理——它自主运行,没法回头问你。例如:“review 所有打了 needs-review 标签的 PR,在问题处留内联评论,然后在 #eng-reviews Slack 频道发一份总结。”

十一、直接问 Claude 它自己的能力

Claude 内置了自己的文档访问能力,可以回答关于它自身功能和限制的问题——而且不管你用的是哪个版本,它拿到的都是最新文档:

Claude Code 能创建 pull request 吗?
Claude Code 怎么处理权限?
有哪些 skill 可用?
怎么在 Claude Code 里用 MCP?
Claude Code 有什么限制?

想要动手演示而非文字解答,跑 /powerup 看带动画 demo 的互动教程。

下面是几个能明显提效的进阶玩法。

进阶一:恢复历史会话

任务跨了好几次坐下来做,不必每次重新交代背景——Claude Code 把每次对话都存在本地:

claude --continue

这会恢复当前目录下最近的一次会话(没有的话会打印 No conversation found to continue 并退出)。想从列表里挑,用 claude --resume;在运行中的会话里则用 /resume。

进阶二:用 worktree 跑并行会话

一个终端里你自己写功能,另一个终端里让 Claude 修 bug,两边改动互不打架——每个 worktree 是各自分支上的独立检出:

claude --worktree feature-auth

在第二个终端用不同的名字跑同样的命令,就开了一个隔离的并行会话。想从一块屏幕监控多个并行会话(而不是开一堆终端),看 background agents。

进阶三:plan 模式——先审后改

对那些"想先看清楚再落盘"的改动,切到 plan 模式:Claude 只读文件、提方案,在你批准前不做任何编辑。

claude --permission-mode plan

会话中途按 Shift+Tab 也能切进 plan 模式。(关于 plan 模式的批准流程,我之前写过一篇权限模式详解可以参考。)

进阶四:把探索丢给 subagent

在大代码库里探索会把一堆文件读进你的主上下文,很快就塞满了。把探索委托出去,只让结论回来:

用一个 subagent 调查我们的认证系统是怎么处理 token 刷新的

subagent 在它自己的上下文窗口里读文件,最后只回报一份摘要,你的主对话保持干净。想定义带专属工具和提示词的自定义 agent,看 Subagents。

进阶五:把 Claude 接进脚本

非交互方式运行 Claude,用于 CI、pre-commit hook 或批处理——stdin/stdout 和任何 Unix 工具一样:

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

更多输出格式、权限 flag 和 fan-out 模式,看非交互模式。

小结

这份速查可以这样用:日常七件事(读码、修 bug、重构、测试、PR、文档、图片)记住对应的提示词节奏,需要时翻出来抄;当任务变大、变长、变并行,再上四件进阶武器——--continue 续接、--worktree 并行、plan 模式先审、subagent 隔离探索、-p 接脚本。配齐这套,Claude Code 才算真正融进了你的开发流。

关于

本文改写自 Claude Code 官方文档 Common workflows,内容以官方文档为准。

关注我获取更多资讯

📢 公众号

💬 个人号