工作流技巧

高效的 Claude Code 开发工作流程，提升团队协作效率

需要 API Key？ 前往注册 →·端点与 Base URL →

本文介绍如何将 Claude Code 融入日常开发工作流，从个人效率到团队协作，建立高效的 AI 辅助开发流程。

规划-执行工作流¶

最有效的 Claude Code 使用模式是先规划后执行，避免直接让 AI 写代码。

基本流程¶

1. 需求分析 → 2. 制定计划 → 3. 确认计划 → 4. 分步执行 → 5. 验证结果

实践步骤¶

第一步：让 Claude 理解需求

> 阅读 @src/services/ 目录下的代码，理解现有架构。
> 不要写任何代码，只分析。

第二步：制定实施计划

> 基于你对现有代码的理解，为"用户权限管理功能"制定详细的实施计划。
> 包括：文件变更、新增文件、依赖关系、风险点。

第三步：确认并调整计划

审查 Claude 的计划，提出修改意见：

> 计划中的第3步，我希望使用 Redis 缓存而不是内存缓存。请调整计划。

第四步：分步执行

> 现在执行计划的第1步：创建权限模型。

每完成一步，验证结果后再继续下一步。

功能分支工作流¶

Git 分支最佳实践¶

# 1. 创建功能分支
git checkout -b feature/user-permissions

# 2. 进入项目目录启动 Claude Code
cd your-project && claude

# 3. 开发过程中多次提交
> 帮我提交这次改动  # 第一次提交
# 继续开发...
> 帮我提交这次改动  # 第二次提交

# 4. 功能完成，创建 PR
> 为当前分支创建 PR 描述，总结所有提交的变更

提交频率建议¶

• 小步提交：每完成一个独立功能点就提交

• 提交信息：让 Claude 根据 diff 生成规范的 commit message（有自定义 /commit 命令的项目也可用它）

• 避免大提交：不要积累太多变更再一次提交

代码审查工作流¶

自我审查¶

在提交 PR 前，先让 Claude 审查：

> /review
> 重点检查：安全性、性能、代码风格

审查他人代码¶

# 获取 PR 变更
gh pr diff 123 | claude "审查这个 PR，关注：
1. 逻辑正确性
2. 边界情况处理
3. 错误处理
4. 代码可维护性"

多阶段审查流程¶

对于复杂 PR，使用结构化审查：

> 第一阶段：检查架构设计是否合理
> 第二阶段：检查实现是否符合设计
> 第三阶段：检查测试覆盖是否充分
> 第四阶段：检查文档是否完整

测试驱动工作流¶

TDD 与 Claude Code¶

1. 写测试 → 2. 运行测试（失败）→ 3. 写代码 → 4. 运行测试（通过）→ 5. 重构

实践步骤¶

第一步：定义测试

> 为用户注册功能编写测试用例，覆盖：
> - 正常注册
> - 邮箱格式错误
> - 密码太弱
> - 用户已存在
> 先写测试，不要实现功能。

第二步：验证测试失败

npm test  # 预期：测试失败

第三步：实现功能

> 现在实现代码，让所有测试通过。

第四步：验证并重构

npm test  # 预期：测试通过

> 测试通过了。现在重构代码，提高可读性，但不要破坏测试。

调试工作流¶

结构化调试¶

1. 复现问题 → 2. 收集信息 → 3. 分析原因 → 4. 验证假设 → 5. 修复问题

实践步骤¶

第一步：描述问题

> 问题描述：用户登录后，点击"我的订单"显示空白页
> 预期行为：显示用户的订单列表
> 复现步骤：登录 → 点击"我的订单"

第二步：收集信息

> 分析以下文件，找出可能的问题：
> @src/pages/MyOrders.tsx
> @src/services/OrderService.ts
> @src/api/orders.ts

第三步：分析日志

# 收集错误日志
cat app.log | claude "分析这些日志，找出与订单页面相关的错误"

第四步：修复并验证

> 基于分析，修复 OrderService 中的问题
> 修复后，我会测试验证

子代理协作工作流¶

并行处理¶

利用子代理并行处理多个任务：

> 同时执行以下任务：
> 1. 使用 Explore 代理分析项目结构
> 2. 使用 Plan 代理设计新功能方案

专业分工¶

不同子代理有不同专长：

IDE 集成工作流¶

VS Code 集成¶

1. 安装 Claude Code VS Code 扩展

2. 使用 Cmd+Esc / Ctrl+Esc 快速切换

3. 在编辑器中选中代码后呼叫 Claude

终端 + IDE 协作¶

终端 (Claude Code)          IDE (VS Code)
     ↓                          ↓
  分析、规划               手动调整、阅读
     ↓                          ↓
  生成代码  ←──────────→   查看差异、测试
     ↓                          ↓
  提交代码                   继续开发

团队协作工作流¶

CLAUDE.md 规范化¶

团队共享 CLAUDE.md 配置：

# 团队开发规范

## 代码风格

- ESLint 配置：.eslintrc.js
- Prettier 配置：.prettierrc

## Git 规范

- 分支命名：feature/xxx, fix/xxx, hotfix/xxx
- Commit 格式：type(scope): description

## 测试要求

- 单元测试覆盖率 > 80%
- E2E 测试覆盖核心流程

PR 模板¶

让 Claude 使用统一的 PR 模板：

> 使用以下模板创建 PR 描述：
> ## 变更内容
> ## 测试计划
> ## 截图（如有 UI 变更）
> ## Checklist

工作流检查清单¶

开始新任务前¶

• [ ] 创建功能分支

• [ ] 使用 /clear 清空上下文

• [ ] 让 Claude 先理解现有代码

• [ ] 制定实施计划

开发过程中¶

• [ ] 分步执行，每步验证

• [ ] 小步提交，频繁让 Claude 提交

• [ ] 监控上下文使用 /context

• [ ] 需要时使用 /compact

提交前¶

• [ ] 运行 /review 自我审查

• [ ] 运行所有测试

• [ ] 检查 lint 错误

• [ ] 生成 PR 描述

工作流里最常用的几个开关¶

截至 2026-10-15，据 Claude Code 官方文档：

关于回退的两个限制：官方文档说明每个会话保留最近 100 个检查点的文件快照，快照默认在会话最后保存后约 30 天被清理，之后回退可能报 No files were restored；想保留更久，可调整 cleanupPeriodDays。

在 QCode 上跑这些工作流的注意点¶

• 并发：个人套餐和按量包每个 API Key 并发 5（尊享版 10；见 常见问题 FAQ）。同时开多个 Claude Code 实例、或让大量子代理并行时，可能先碰到限流（常见表现为 429）。
• 长会话：规划-执行流程往往很长，接近上下文上限时会出现 E015 / 429，先 /compact，不行再重启会话，详见 上下文管理。
• 模型分工：规划和审查可以用更强的型号，批量改动用 claude-sonnet-5，用 /model 切换；QCode 按 token 计费，各模型单价见 qcode.cc/models。

常见报错与排查¶

常见问题¶

一定要先规划再执行吗？¶

小改动可以直接做；涉及多个文件、或改错了代价高的任务，先让它在计划模式里出方案、你确认后再执行，通常返工更少。

多久 /compact 一次合适？¶

不用固定频率。完成一个阶段、或 /context 显示占用到 70% 到 80% 时压缩一次，比等到溢出再处理稳妥。

做错了怎么回退？¶

代码层面靠 git 和 /rewind 双保险：小步提交，/rewind 处理会话内的撤回。重要节点先提交，再放心让 Claude 往下改。

同时开几个会话并行做不同任务，会不会互相影响？¶

对话内容互不影响，但它们共用同一把 Key 的并发额度；并行任务多时可能被限流，按上文减少并发即可。

下一步¶

• 学习 CLI 技巧 掌握更多命令

• 了解 自定义命令 创建团队专属命令

• 探索 最佳实践 深入优化工作流

企业团队版 →