Claude Code 常见工作流程完全指南
我是 Quentin，OpenClaw 拼车（cp.bizq.net）的作者。
这篇是 Claude Code「按任务找方法」的 12 个流程清单。每个流程都给你清晰的步骤、可直接抄的命令、避免踩坑的提示。
读完一遍，下次面对「我现在要 X，该怎么用 Claude Code」时直接对号入座。
接拼车配置 Claude Code 一行起飞：
curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x1. 理解新代码库
1.1 快速获取概览
刚加入新项目，先让 AI 帮你建立心智模型。
cd /path/to/project
claude进会话后：
> 给我一个这个 codebase 的概览
> 列出主要使用的架构模式
> 关键的数据模型有哪些？
> 鉴权是怎么处理的？实战提示：
- 从宽泛问题开始，再缩到具体领域
- 询问项目使用的编码约定和模式
- 让它生成一份「项目术语表」（哪些是业务术语、哪些是缩写）
1.2 查找相关代码
定位某个功能涉及的所有文件：
> 找出处理用户认证相关的所有文件
> 这些认证文件之间是怎么协作的？
> 把登录流程从前端到数据库 trace 一遍让它先 trace 一遍流程再动代码——省下来的时间比你想象的多。
2. 高效修复 bug
报错 → 修复的标准流程：
# 1. 分享错误
> 我跑 npm test 报这个错：<贴完整堆栈>
# 2. 请求修复建议
> 给我几种修 user.ts 那个 @ts-ignore 的方案
# 3. 应用修复
> 用方案 2 修：加 null check实战提示：
- 给完整堆栈，包括重现命令
- 明确说明错误是间歇的还是稳定复现的
- 如果你已经怀疑某个文件，直接说出来给方向
3. 代码重构
把老代码升级到现代写法：
# 1. 找需要重构的代码
> 找出 codebase 里使用 deprecated API 的地方
# 2. 让它给方案
> utils.js 怎么重构能用上现代 JS 特性
# 3. 应用重构
> 用 ES2024 重构 utils.js，保持行为一致
# 4. 验证
> 跑这部分代码的测试实战提示：
- 让它解释「为什么这种现代写法更好」
- 必要时让它保持向后兼容
- 小步重构、可测试增量——不要一次性大改
4. 写测试
补齐测试覆盖率：
# 1. 找出未覆盖的代码
> 找出 NotificationsService 里没有测试覆盖的函数
# 2. 生成测试骨架
> 给 notification service 加测试
# 3. 加边界场景
> 给 notification service 加边界条件测试用例
# 4. 跑并验证
> 跑新测试，修掉失败的实战提示：
- 让它专门覆盖边界条件和错误路径
- 适当时同时要求单元测试和集成测试
- 让它解释测试策略，避免堆毫无意义的覆盖率
5. 创建 Pull Request
完整 PR 流程：
# 1. 总结改动
> 总结我对认证模块做的所有修改
# 2. 让它创建 PR
> 创建 PR
# 3. 完善描述
> 在 PR 描述里加一段关于安全增强的上下文
# 4. 加测试说明
> 在 PR 里写明这些改动是怎么测试的实战提示：
- 让它直接帮你创建 PR（前提：装了
gh） - 提交前自己 review 一遍 AI 写的 PR 描述
- 让它明确列出潜在风险和回滚策略
6. 写文档
补 API 文档 / JSDoc / 注释：
# 1. 找未文档化的代码
> 找出 auth 模块里没有 JSDoc 注释的函数
# 2. 生成文档
> 给 auth.js 里没文档的函数加 JSDoc
# 3. 增强
> 优化生成的文档，加上下文和示例
# 4. 验证
> 检查文档是否符合项目的文档规范实战提示：
- 明确指定文档风格（JSDoc / docstring / TSDoc）
- 要求附示例代码
- 重点给公共 API、interface、复杂逻辑写文档
7. 处理图像
7.1 把图加进对话
三种方式（任选）：
- 拖拽：把图片拖到 Claude Code 终端窗口
- 粘贴：复制图片然后
Ctrl+V（不要用Cmd+V！） - 路径：
分析这张图：/path/to/image.png
mac 用户最常踩的坑就是 Cmd+V——它走的是字符粘贴，触发不了图像识别。一定是 Ctrl+V。
7.2 让它分析
> 这张图显示了什么？
> 描述这张截图里的 UI 元素
> 这张图里有问题的地方在哪？7.3 用图给上下文
> 这是报错截图，是什么原因导致的？
> 这是当前数据库 schema，新功能应该怎么改它？7.4 视觉 → 代码
> 写 CSS 实现这张设计稿
> 这个组件用什么 HTML 结构？实战提示：
- 文字描述不清/太繁琐时用图
- 报错截图、UI 设计、架构图都很合适
- 一次会话可以贴多张图
8. 使用扩展思考（think / ultrathink）
复杂架构决策、棘手 bug、多步实现规划——这些场景让 AI 多想一会儿比让它快回答更值钱。
8.1 触发深度思考
> 我要给 API 引入 OAuth2 认证。请深入思考最适合我们 codebase 的实现方案。它会从 codebase 收集相关信息，调用扩展思考，思考过程会以斜体灰字显示。
8.2 后续提示继续深化
> 继续思考这个方案的潜在安全漏洞
> 思考更多需要处理的边界场景8.3 思考深度梯度
| 关键词 | 强度 |
|---|---|
think | 基础 |
think more / think a lot | 中 |
think harder / think longer | 强 |
ultrathink | 最强（最贵） |
适合扩展思考的场景：
- 复杂架构变更规划
- 难定位的 bug
- 新功能实现规划
- 理解复杂代码库
- 评估方案的权衡
不适合的：CRUD、简单 bug、改样式——浪费钱。
9. 恢复之前的对话
9.1 自动续聊：--continue
claude --continue立刻接上最近一次对话，无需任何提示。
9.2 非交互续聊（适合脚本）
claude --continue --print "Continue with my task"--print 配 --continue 能写进 cron 或 CI。
9.3 选择特定历史：--resume
claude --resume弹出对话选择器：开始时间、初始提示、消息数量。方向键选，回车进。
机制说明：
- 对话历史存在本地
~/.claude/projects/ - 恢复时完整消息历史被反序列化回上下文
- 之前的工具调用结果也保留
- 用同样的模型和配置继续
我自己的节奏是「下班 /compact → 第二天早上 claude -c」——脑子接得上，token 也省。
10. 用 git worktrees 跑并行 Claude Code 会话
10.1 为什么要 worktree
需要同时干多件事，又不想多个 AI 实例互相改文件——worktree 是答案。
git worktree 把同一个 repo 的不同分支 checkout 到不同目录，每个目录有自己独立的工作区文件，但共享同一个 git 历史。
10.2 创建 worktree
# 用新分支建
git worktree add ../proj-feature-a -b feature-a
# 用已有分支建
git worktree add ../proj-bugfix bugfix-12310.3 在每个 worktree 里跑 Claude Code
cd ../proj-feature-a
claude
# 另一个终端
cd ../proj-bugfix
claude10.4 管理 worktree
# 列出所有
git worktree list
# 删除
git worktree remove ../proj-feature-a实战提示：
- 每个 worktree 文件状态隔离，AI 实例之间不会互相干扰
- 所有 worktree 共享 git 历史和远程
- 长任务挂一个 worktree，主开发另一个 worktree
- 用描述性目录名让你一眼看出哪个 worktree 在干什么
- 新 worktree 记得重新装依赖（
pnpm i/pip install -e .）
11. 把 Claude 当 Unix 工具用
11.1 当 linter / code reviewer
package.json 里加脚本：
{
"scripts": {
"lint:claude": "claude -p 'you are a linter. look at the changes vs main and report any typo issues. report filename and line number on one line, description on the next. no other text.'"
}
}CI 跑这条，得到结构化输出。
实战提示：
- 在 CI/CD 里跑做自动 code review
- 自定义 prompt 检查项目特定问题
- 不同检查类型分开多个脚本
11.2 管道输入输出
cat build-error.txt | claude -p '简洁解释这个 build 错误的根因' > output.txt实战提示：
- 用管道把 Claude 集成进现有 shell 脚本
- 配合其他 Unix 工具组合拳
- 配
--output-format拿结构化输出
11.3 控制输出格式
# 默认 text
cat data.txt | claude -p '总结这份数据' --output-format text > summary.txt
# JSON（带元数据）
cat code.py | claude -p '分析 bug' --output-format json > analysis.json
# stream-json（流式）
cat log.txt | claude -p '解析日志找错误' --output-format stream-json| 格式 | 用途 |
|---|---|
text | 简单集成，只要 Claude 的回答 |
json | 完整对话日志、含 cost/duration |
stream-json | 实时输出（每条消息一个 JSON） |
12. 创建自定义斜杠命令
12.1 项目级命令
mkdir -p .claude/commands
echo "Analyze the performance of this code and suggest three specific optimizations:" > .claude/commands/optimize.md调用：
> /project:optimize实战提示：
- 命令名 = 文件名（
optimize.md→/project:optimize） - 子目录会带前缀（
.claude/commands/frontend/component.md→/project:frontend:component） - 项目命令对所有 clone 这个 repo 的人都可用（适合团队共享）
- markdown 文件内容就是 prompt 模板
12.2 带参数：$ARGUMENTS
cat > .claude/commands/fix-issue.md <<'EOF'
分析并修复 issue #$ARGUMENTS：
1. 理解 ticket 描述的问题
2. 在 codebase 定位相关代码
3. 实现根因修复
4. 加测试
5. 准备简洁的 PR 描述
EOF调用：
> /project:fix-issue 123$ARGUMENTS 会被替换成 123。
其他用法：生成测试用例、写组件文档、review 特定文件、翻译内容到指定语言。
12.3 用户级（个人命令）
mkdir -p ~/.claude/commands
echo "Review this code for security vulnerabilities, focusing on:" > ~/.claude/commands/security-review.md调用：
> /user:security-review特点：
- 前缀是
/user:不是/project: - 只对你自己可用
- 在所有项目里都生效
- 跨 repo 保持一致工作流
我自己积累了大概 20 条 /user: 命令：push、PR 描述、code review、安全审计、文档生成。它们就是我的「肌肉记忆」。
总结：12 个工作流地图
| # | 工作流 | 关键命令 |
|---|---|---|
| 1 | 理解新代码库 | 概览 → 缩到具体领域 |
| 2 | 修 bug | 分享堆栈 → 多方案 → 应用 → 验证 |
| 3 | 重构 | 识别 → 方案 → 应用 → 测试 |
| 4 | 写测试 | 找未覆盖 → 骨架 → 边界 → 跑 |
| 5 | 创建 PR | 总结 → 创建 → 完善 → 测试详情 |
| 6 | 写文档 | 找未文档 → 生成 → 增强 → 验证 |
| 7 | 处理图像 | 拖/粘贴/路径 → 分析/上下文/生成代码 |
| 8 | 扩展思考 | think 梯度 + 后续深化 |
| 9 | 恢复对话 | --continue / --resume |
| 10 | worktree 并行 | 创建 → 各自跑 claude → 管理 |
| 11 | Unix pipeline | linter / 管道 / output-format |
| 12 | 自定义命令 | 项目级 / 用户级 / $ARGUMENTS |
拼车把这些工作流的成本压下来
每个工作流跑得熟，token 烧得越来越凶——这是好事，意味着 Claude Code 真的在帮你干活。但单订 Max 不便宜，团队多人更肉痛。OpenClaw 拼车把多人配额池子化了，按团队规模定制接入：
curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x详细文档见 https://cp.bizq.net。
相关文章
- Claude Code 最佳实践与使用技巧 — 维度更全的最佳实践
- Claude Code 16 个实用小技巧 — 短小精炼的高频招式
- 34 个 Claude Code 实用技巧 — 同类技巧合集