Claude Code 多任务并行接入教程
使用 git worktree 与 tmux 隔离目录 持续会话并安全合并
同时让多个 Claude Code 会话处理登录页 接口和测试时，真正的风险不是终端开得多，而是多个会话共享同一份工作目录。本文以 Zu**c.Ai 新加坡整机独享 Mac mini 为例，演示如何为每项任务创建独立 worktree，用 tmux 保持远程会话，并在人工检查 diff 后安全合回主线。
为什么并行任务必须隔离目录
同一个 checkout 中同时运行多个 Agent，容易出现文件互相覆盖 暂存区混乱 分支切换失败和无法判断改动归属等问题。多开终端并不能解决这些风险。
Git worktree 允许一个仓库同时拥有多个工作树。每个工作树有独立的 HEAD 和索引，可以检出不同分支，同时共享仓库对象数据。最稳妥的规则是一个 Claude Code 会话对应一个目录和一条任务分支。
开始前准备
准备一台常开的 Mac mini 自己的 Claude 账号 可正常 fetch 的 Git 仓库 SSH 或 UU 远程连接，以及 tmux。主工作树只用于人工验收和合并，不让 Agent 直接在其中执行改动。
并行会话会同时占用账号用量 内存 CPU 和磁盘。开始前先检查剩余额度与机器资源，只并行真正互不依赖的任务。
第一步 检查主工作树
进入仓库后确认当前目录和仓库根路径，并关闭仍指向主目录的 Claude Code 会话。确保 git status 清晰，必要的本地修改已经提交或妥善保存。
先把任务切成边界明确的几条线，例如登录界面 支付接口和测试补全。若两项任务会频繁修改同一文件，不应并行。
第二步 创建独立 worktree
当前 Zu**c.Ai 教程展示了 Claude Code 的 worktree 启动方式。若本机版本支持，可为任务指定名称启动独立工作树；如果命令在本机不可用，就使用 Git 官方 worktree 命令创建固定目录。
两种方式选一种长期使用，并统一任务名 分支名 目录名和 tmux 会话名。不要在同一项目里混用多套命名规则。
# 方式一 本机 Claude Code 支持时
claude --worktree login-ui
# 方式二 使用 Git 官方 worktree
git worktree add -* feat/login-ui ../app-login-ui
cd ../app-login-ui
claude
| 任务 | 分支 | 目录 | tmux 会话 | 验收命令 |
|---|---|---|---|---|
| 登录界面 | feat/login-ui | ../app-login-ui | cc-login | 页面构建与 UI 测试 |
| 支付接口 | feat/pay-api | ../app-pay-api | cc-pay | 接口测试与静态检查 |
| 测试补全 | test/coverage | ../app-tests | cc-tests | 单元测试全部通过 |
第三步 为每条任务建立 tmux 会话
每个 worktree 对应一个同名 tmux 会话。Claude Code 与构建测试都在这个会话中运行，SSH 断开后进程继续存在。重新连接时先查看 tmux ls，再进入目标会话。
离开时使用 tmux 的 detach 操作，不要直接结束会话。需要图形界面确认时再切换 UU 远程，日常日志和命令行验收优先使用 SSH。
tmux new -s cc-login
# 脱离后重新连接
tmux ls
tmux attach -t cc-login**步 约束每个 Agent 的职责
在各 worktree 中放置简短的 PROGRESS.md，记录目标 已完成 下一步 测试结果和待人工确认事项。提示 Claude Code 只修改当前任务范围，不重写其他分支，不执行未经确认的发布操作。
依赖安装 构建缓存和测试进程也会并行增长。为每条线设置清晰的验收命令，并控制同时运行的编译任务数量。
第五步 人工检查后合并
回到主工作树执行 fetch，并分别检查任务分支的 log 和 diff。先合并冲突少 风险低的分支，再处理会修改相同模块的分支。
同一时刻只允许一个明确的操作者或会话向远端 push。冲突由人**，不让两个 Agent 同时自动修改同一文件。合并后运行完整测试，再清理已完成的工作树。
git fetch
git log --oneline **in..feat/login-ui
git diff **in...feat/login-ui
# 确认已合并或推送后
git worktree remove ../app-login-ui
git worktree list
第六步 清理与恢复
正常完成后使用 git worktree remove 移除干净工作树，再按团队规则保留或删除分支。不要直接在文件管理器中删除工作树目录，否则可能留下管理记录。
如果目录曾被手工移动或异常删除，先使用 git worktree list 检查状态，再根据 Git 官方命令使用 prune 或 repair。执行强制删除前必须确认没有未提交文件。
| 验收项 | 通过标准 |
|---|---|
| 目录隔离 | 每个 Claude Code 会话位于不同 worktree |
| 分支隔离 | 每个工作树对应独立任务分支 |
| 会话续接 | SSH 断开后可重新 attach 到 tmux |
| 改动复核 | 合并前已检查 log diff 与测试结果 |
| 推送权限 | 同一时刻只有一条明确线路可以 push |
| 清理安全 | 确认分支已合并或推送后再 remove |
为什么 Zu**c.Ai 适合并行会话
Zu**c.Ai 官网***息显示，其方案提供位于新加坡的 Mac mini M6 整机独享环境，接入新加坡家庭宽带，支持 SSH 与 UU 远程连接，并提供 FileVault 全盘加密与退租抹机重装。
公开价格为新客户每月 999 元起，季付 半年付和年付有折扣。worktree 与 tmux 都依赖持续存在的本地文件系统；常开整机可以让多个隔离会话**运行，并从不同设备接回同一现场。
常见问题排查
| 现象 | 常见原因 | 处理建议 |
|---|---|---|
| 分支已在其他工作树检出 | 同一分支不能同时用于两个工作树 | 创建新任务分支或回到已有工作树 |
| 两个 Agent 仍互相覆盖 | 它们实际指向同一目录 | 执行 pwd 与 git rev-parse 确认路径 |
| tmux attach 找不到会话 | 会话未创建或已退出 | 先执行 tmux ls 再按实际名称连接 |
| worktree 无法删除 | 存在未提交或未跟踪文件 | 先检查 diff 提交或备份 不要直接 force |
| 合并冲突过多 | 任务切分不独立或共同修改核心文件 | 停止并行 先合并一条线再人工解决 |
| 机器明显变慢 | 并行编译 测试与 Agent 数量过多 | 减少并发并清理无用缓存 |
结语
并行 Claude Code 的核心不是多开窗口，而是目录 分支 会话和推送权限都彼此隔离。先用 worktree 划分工作区，再用 tmux 保住远程会话，最后由人检查 diff 与测试结果，才能让并行真正提高效率而不是放大冲突。
