🚀 Claude Code 多智能体并行开发 SOP

🚀 Claude Code 多智能体并行开发 SOP
阿晖核心原理与准备
核心原理:利用 git worktree 实现物理目录隔离,利用 Prompt/配置文件实现 AI 的权限与上下文隔离,最后通过 Git 完成代码合并。
📋 准备工作
- 前提条件:已安装 Git 并熟悉基本操作;已全局安装并登录 Claude Code。
- 项目状态:主项目(假设名为
my-project)已初始化 Git 仓库,且代码处于干净状态(无未提交的修改)。 - 架构规约:在主项目中准备好一份接口文档(如
api-docs.md),确保前后端数据结构已定死。
🛠️ 第一阶段:创建物理隔离的开发环境
不要在同一个文件夹里开两个 Claude,我们需要用 Git 劈出两个平行的工作区。
1. 进入主干:打开终端,进入你的主项目目录。
1 | cd my-project |
2. 创建前端专属工作区:在主项目同级目录下新建文件夹,并绑定新分支。
1 | git worktree add ../project-frontend feature-frontend |
3. 创建后端专属工作区:同样在同级目录下新建文件夹,并绑定新分支。
1 | git worktree add ../project-backend feature-backend |
💡 提示:此时你的文件系统中会有三个平行的文件夹:
my-project(主干)、project-frontend(前端分支)、project-backend(后端分支)。
🛡️ 第二阶段:配置 Claude 的“责任边界”
为了防止前端 Claude 乱改 Java 代码,后端 Claude 乱改 Vue 页面,我们需要给它们立下规矩。
📍 1. 配置前端 Claude
进入前端工作区:
1 | cd ../project-frontend |
在根目录新建配置文件 .clauderc,写入以下内容:
1 | Custom Prompt: 你现在是 Vue 前端开发工程师。你的修改权限仅限于 src/views, src/components 和 src/api 目录。请严格参考根目录下的 api-docs.md 进行数据 Mock 和接口对接。绝对不允许修改任何后端代码或构建脚本。 |
📍 2. 配置后端 Claude
进入后端工作区(打开一个新的终端窗口):
1 | cd ../project-backend |
在根目录新建配置文件 .clauderc,写入以下内容:
1 | Custom Prompt: 你现在是 Spring Boot 后端开发工程师。你的修改权限仅限于 src/main/java 和 src/main/resources 目录。请严格参考根目录下的 api-docs.md 编写 Controller 和 Service。绝对不允许修改任何前端文件。 |
💻 第三阶段:启动并行开发
它们现在会同时在各自的文件夹里写代码,互不干扰。
前端开发:在前端终端(
project-frontend目录下),输入claude启动。- 指令示例:“帮我把
api-docs.md里的登录接口对接到Login.vue页面,包含表单校验。”
- 指令示例:“帮我把
后端开发:在后端终端(
project-backend目录下),输入claude启动。- 指令示例:“帮我实现
api-docs.md里的登录逻辑,使用 JWT,在UserController和AuthService中完成代码。”
- 指令示例:“帮我实现
🔄 第四阶段:代码收口与合并
当两边的 Claude 都告诉你任务完成后,即可进行合并。
1. 分别提交代码:在两边的终端里让 Claude 帮你提交,或者你手动提交。
1 | # 在前端和后端目录下分别执行 |
2. 回到主干合并:关闭 Claude Code,回到你的主项目目录。
1 | cd ../my-project |
3. 清理工作区(可选):合并完毕且测试无误后,你可以删掉那两个平行的文件夹,释放空间。
1 | git worktree remove ../project-frontend |
Comment
匿名评论隐私政策












