Claude Code 深度学习手册

主题

常见工作流 ​

用 Claude Code 完成探索代码、修 Bug、重构、测试、建 PR 等日常开发的配方集合。

是什么 ​

本页汇集了 Claude Code 日常开发的简短「配方」，覆盖探索陌生代码库、调试、重构、写测试、创建 PR、写文档等常见任务，每条配方在任意 Claude Code 界面都适用，可按项目调整措辞。

除了 Prompt 配方，本页还介绍了如何恢复历史会话、用 worktrees 跑并行会话、编辑前先 plan 审阅改动、把研究委派给 subagent，以及把 Claude 接入脚本用于 CI 与批处理。更高层的 prompt 与上下文管理指引见 Best practices。

怎么工作 ​

  • 理解新代码库：用 claude 启动后从「give me an overview of this codebase」等广义问题入手，逐步追问架构模式、数据模型、认证方式
  • 定位相关代码：让 Claude 找出处理某功能的文件（如用户认证），并追踪从前端到数据库的执行流
  • 高效修 Bug：把报错/复现命令告诉 Claude，请它给修复方案，再让它落地改动（如给 user.ts 加空值检查）
  • 重构代码：识别废弃 API、请求现代化重构建议、在保持行为不变前提下小步改写，再跑测试验证
  • 处理测试：找出未覆盖的函数、生成测试脚手架、补充边界用例，并运行修复失败用例（Claude 会参照已有测试风格）
  • 创建 PR：可直接说「create a pr」，或分步先总结改动、生成 PR、再丰富 PR 描述
  • 处理文档：找出缺注释代码、生成 JSDoc/docstring、丰富文档并校验是否符合项目规范
  • 在笔记/非代码目录工作：Claude Code 可在任意目录运行，搜索、编辑、重组 markdown，每次调用都读最新文件
  • 处理图片：拖拽、ctrl+v 粘贴或给路径加入图片，让 Claude 分析截图/设计稿/图表并据此生成代码
  • 引用文件与目录：用 @ 直接把文件内容、目录列表或 MCP 资源带入对话
  • 按计划定时运行：通过 Routines / Desktop scheduled tasks / GitHub Actions / /loop 让任务定期自动执行
  • 询问 Claude 自身能力：Claude 内置最新文档，可回答关于自身功能与限制的问题
  • 恢复历史会话、用 worktrees 跑并行会话、编辑前用 plan mode 审阅、把研究委派给 subagent、把 Claude 接入脚本

怎么配置 / 用法 ​

启动与概览：

bash
cd /path/to/project
claude
text
give me an overview of this codebase

引用文件/目录/MCP 资源（用 @）：

text
Explain the logic in @src/utils/auth.js
What's the structure of @src/components?
Show me the data from @github:repos/owner/repo/issues

恢复会话：

bash
claude --continue        # 恢复当前目录最近一次会话
claude --resume          # 从列表选择（会话内可用 /resume）
claude --from-pr <number> # 回到与某 PR 关联的会话

并行 worktree 会话：

bash
claude --worktree feature-auth

编辑前先 plan：

bash
claude --permission-mode plan   # 也可在会话中按 Shift+Tab 切换

委派研究给 subagent：

text
use a subagent to investigate how our auth system handles token refresh

接入脚本（非交互）：

bash
git log --oneline -20 | claude -p "summarize these recent commits"

什么时候用 ​

  • 刚加入新项目、需要快速摸清代码结构与架构时
  • 遇到报错需要定位并修复、或要把旧代码重构为现代写法时
  • 需要补测试、写文档、创建 PR 等日常开发动作时
  • 任务跨多次会话、要恢复上下文，或需并行/计划任务/委派研究时

限制 / 坑 ​

  • 粘贴图片用 ctrl+v，不要用 cmd+v
  • claude --continue 在当前目录无历史会话时会打印 No conversation found to continue 并退出
  • /loop 任务在开新对话时停止，仅 --resume / --continue 能恢复未过期的任务
  • @ 目录引用只显示文件列表，不含文件内容；Claude 对自身能力的回答基于文档而非实操演示

硬事实速查（11 条） ​

  • claude — 在项目根目录启动交互式会话
  • @file / @dir — 引用文件（带入完整内容）或目录（带入文件列表）
  • @server:resource — 引用 MCP 资源，如 @github:repos/owner/repo/issues
  • @ 文件引用会把该文件所在及上级目录的 CLAUDE.md 一并加入上下文
  • claude --continue — 恢复当前目录最近一次会话
  • claude --resume / 会话内 /resume — 从列表选择会话
  • 用 gh pr create 创建 PR 后会话自动与该 PR 关联，可用 claude --from-pr <number> 返回
  • claude --worktree <name> — 在独立分支检出上开并行隔离会话
  • claude --permission-mode plan 或按 Shift+Tab — 进入 plan mode，审批前不落盘
  • claude -p "..." — 非交互模式，支持 stdin/stdout 管道用于 CI/批处理
  • 图片加入方式：拖拽、ctrl+v 粘贴（非 cmd+v）、或提供图片路径

官方出处：https://code.claude.com/docs/en/common-workflows