Claude Code 常用工作流：读代码、修 bug、写测试、提 PR

这篇适合谁、读完能做到什么

已经装好 Claude Code、想知道日常开发里该怎么问它的读者。读完你应该能用几句话让它熟悉一个陌生项目、定位并修掉一个报错、给改动补上测试，并且知道怎么提出一个 PR。^[1]

陌生项目怎么快速摸清

刚接手一个项目时，在项目根目录运行 claude，然后先问一句「give me an overview of this codebase」。接着再追问「explain the main architecture patterns used here」或者「how is authentication handled?」，逐步缩小范围。^[1] 文档的建议是先问宽的问题，再收窄到具体模块；还可以让它问项目的编码约定，或者请它整理一份项目专用术语表。^[1]

找某个功能的代码，可以先让它找出处理这个功能的文件，再问这些文件之间怎么配合，比如「trace the login process from front-end to database」，让它把登录流程从前端一路追到数据库。^[1]

修 bug 的提示怎么写

把报错信息原样贴给 Claude，先让它给出几种修法，再选一种让它动手。文档提醒，最好告诉它复现问题的命令和步骤，并说明错误是偶发的还是每次都出现，这些信息对定位很有帮助。^[1]

重构和补测试怎么问

重构的套路是：先找出仍在使用的过时 API，再让它给出重构建议，然后在保持行为不变的前提下动手改，最后运行测试。文档建议每次只做小步、可测试的改动。^[1]

补测试时，Claude 会先看现有的测试文件，沿用其中的风格、框架和断言写法。文档建议把要验证的行为说具体，并让它找出容易被忽略的边界情况。^[1]

怎么让 Claude 提 PR

可以直接说「create a PR」，也可以先让它总结改动，再生成 PR，最后让它补充安全改进等背景说明。文档提醒，提交前要自己审一遍生成的 PR，并请 Claude 指出可能的风险。^[1]

Claude Code 在通过 gh pr create 或 glab mr create 创建 PR 时，会把会话和这个 PR 关联起来。之后运行 claude --from-pr 1234，就能在会话选择器里只看到和这个 PR 相关的会话。^[1]

提示里怎么引用文件和图片

在提示里写 @ 加路径，比如「Explain the logic in @src/utils/auth.js」，文件内容就会直接放进对话里，省去让它先读的一步。文件超过 Read 工具默认的 25,000 token 上限时不会被完整放入，超过 256KB 的文本文件则不会被包含。^[1]

如果不想让 @ 引用带入文件内容，可以把环境变量 CLAUDE_CODE_DISABLE_FILE_MENTIONS 设为 1。文档还特别说明，对 @ 引用的文件，PreToolUse 钩子不会运行，因为这一步没有发生工具调用。想控制 Claude 能读哪些文件，要用 Read 的拒绝规则，而不是只靠钩子。^[1]

图片可以直接拖进窗口、用 Ctrl+V 粘贴，或者在提示里写图片路径。^[1]

并行会话和计划模式怎么用

想同时做两件事、又不让改动互相干扰，可以用 worktree：claude --worktree feature-auth 会在独立的 git worktree 里开一个隔离的会话。仓库至少要有一次提交才能这样用。^[1]

如果想先看计划再动手，用 claude --permission-mode plan 启动计划模式。Claude 只读文件、提出方案，在你批准前不会改任何文件。会话中按 Shift+Tab 也能切换，状态栏会显示 ⏸ plan mode on。^[1]

怎么让子代理去查资料

读大型代码库时，文件内容很快会占满上下文。可以让子代理去调研，比如「use a subagent to investigate how our auth system handles token refresh」。子代理在自己的上下文窗口里读文件，只把摘要返回给主会话。^[1]

怎么在脚本里调用 Claude

在 CI、提交前钩子或批处理里，可以用非交互方式运行它，比如 git log --oneline -20 | claude -p "summarize these recent commits"，通过标准输入传入内容，结果从标准输出返回。^[1]

怎么问 Claude 它自己能做什么

直接问 Claude「can Claude Code create pull requests?」之类的问题，它会根据当前的 Claude Code 文档回答，不受你所用版本的限制。想要带动画演示的交互式课程，可以运行 /powerup。^[1]

定时任务怎么跑

需要定期自动执行的任务，文档列出了几种方式：云端定时任务（routines）运行在 Anthropic 管理的云端；桌面端定时任务运行在本机；GitHub Actions 运行在 CI 里；/loop 则在当前 CLI 会话里运行。定时任务是自主执行的、不能反问，所以提示词里要写清楚怎样算完成，以及结果怎么处理。^[1]