如何管理10个并行Claude智能体Worktrunk Claude Code完整配置指南【免费下载链接】worktrunkWorktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows项目地址: https://gitcode.com/GitHub_Trending/wo/worktrunkWorktrunk 是一个专为并行 AI 智能体工作流设计的 Git worktree 管理命令行工具。当你同时运行 510 个 Claude Code 实例时让每个智能体在独立的 worktree 中工作、互不干扰再配合 Claude Code 官方插件和 Hooks 自动化这套组合堪称并行开发的最优解。本文将带你从零完成完整配置。为什么需要 Git worktrees 来跑并行智能体现在 Claude Code 这类智能体可以长时间无人值守地工作同时管理 10 个以上智能体已经可行。但问题在于多个智能体共用一个工作目录会互相踩坑——改同一批文件、互相覆盖修改。Git 原生的 worktree 功能可以给每个智能体一个独立工作目录但原生体验很粗糙创建一个新 worktree 需要把分支名敲三遍还要手动cd切换。这正是 Worktrunk 要解决的痛点让 worktree 像分支一样简单。任务Worktrunk原生 git切换工作区wt switch featcd ../repo.feat创建并启动 Claudewt switch -c -x claude featgit worktree add -b feat …cdclaude清理wt removegit worktree removegit branch -d三步安装Worktrunk 快速上手macOS / Linux推荐 Homebrewbrew install worktrunk wt config shell install或通过 Cargo 安装cargo install worktrunk wt config shell install 第二行的wt config shell install必不可少——它启用Shell 集成让wt switch这类命令能真正帮你切换目录。也可以用git clone https://gitcode.com/GitHub_Trending/wo/worktrunk获取源码后阅读文档。安装完成后wt config show可以检查你的 Shell 与 CLI 是否都检测正常。核心三命令wt switch / list / removeWorktrunk 的哲学是worktree 用分支名寻址路径由模板自动计算日常只需记住三个命令1️⃣ 创建并切入工作区wt switch --create feature-auth # ✓ Created branch feature-auth from main and worktree ~/repo.feature-auth2️⃣ 一眼查看所有工作区状态wt list输出包含每个分支的改动状态、相对主干的领先/落后提交数、远程状态、最近提交和提交时间标记当前所在的工作区——管理 10 个并行智能体时这是你的总控台。3️⃣ 完成后清理wt remove一行命令删除 worktree 和分支无需手动 cd 回主目录再敲两遍 git 命令。一条命令启动 10 个 Claude 智能体这是并行工作流最爽的部分——-x参数在切换后自动运行命令--之后的内容作为任务指令传给 Claudewt switch -x claude -c feature-a -- Add user authentication wt switch -x claude -c feature-b -- Fix the pagination bug wt switch -x claude -c feature-c -- Write tests for the API三条命令三个智能体各自在独立 worktree 里开工互不干扰。想更短可以配个别名alias wscwt switch --create --executeclaude wsc new-feature # 建 worktree、跑 hooks、启动 Claude wsc feature -- Fix GH #322 # 并附带任务指令官方插件让 wt list 显示智能体在忙什么Worktrunk 为 Claude Code 提供了官方插件一键安装wt config plugins claude install插件带来三大能力详见 plugins/worktrunk/README.md 活动追踪wt list中每个分支旁会显示状态标记——表示智能体正在工作表示在等待输入会话结束后自动清除。10 个智能体谁在忙、谁在等一目了然/wt-switch-create技能在 Claude 会话内直接创建新 worktree 并切入不中断当前会话工作区隔离Claude Code 的isolation: worktree模式会经由wt switch --create/wt remove执行自动遵循 Worktrunk 的命名规范和生命周期管理插件源码位于 plugins/worktrunk/配套的技能说明见 skills/worktrunk/SKILL.md。Hooks 自动化建工作区自动装依赖、起服务智能体刚建好 worktree 时最烦的是手动装依赖。Worktrunk 的Hooks 系统在 worktree 生命周期的关键节点自动执行命令Hook 类型触发时机典型用途pre-start新建 worktree 时阻塞式安装依赖、生成 env 文件post-start新建 worktree 后后台起 dev server、长构建pre-commit提交前格式化、lintpre-merge合并前跑测试、安全扫描post-merge合并后后台部署、通知在项目里创建.config/wt.toml配置pre-start npm install [post-start] server npm run dev这样wt switch -c创建的每个新 worktree 都会自动装好依赖、起好服务智能体落地即开工。Hooks 支持{{ branch }}、{{ worktree_path }}等模板变量还有hash_port过滤器让每个 worktree 的 dev server 跑在独立端口上10 个实例并行开发也不怕端口冲突。完整文档见 docs/public/hook.md。合并回主干wt merge 一条命令搞定智能体干完活后wt merge把squash → rebase → fast-forward 合并 → 清理 worktree串成一条流水线wt merge main如果你配置了 LLM 提交信息生成[commit.generation]它会先分析 diff 自动生成规范的 commit message全程无需手写。10 个智能体的产出每个都是一条干净的合并记录。项目 Hooks 命令首次运行需要审批确认Allow and remember?审批信息保存在本地配置文件命令一旦变更会重新请求审批——对无人值守的智能体工作流是很好的安全护栏。进阶技巧速查交互式选择器wt switch不带参数打开可视化选择器浏览所有 worktree 并实时预览 diff 和日志CI 状态与 AI 摘要wt list --full展示每个分支的 CI 状态和 AI 生成的进度摘要PR 直达wt switch pr:123直接切到某个 PR 的分支自定义别名在配置里定义wt name自定义命令把团队常用流程固化为一条命令这些配方在 docs/public/tips-patterns.md 里有完整清单Claude Code 插件的详细说明在 docs/public/claude-code.md。总结管理 10 个并行 Claude 智能体的完整配方✅brew install worktrunk Shell 集成30 秒装好✅wt switch -x claude -c 分支 -- 任务批量启动智能体✅wt config plugins claude install获得 / 活动追踪✅.config/wt.toml配置 Hooks自动装依赖、起服务✅wt list总览全局wt merge main逐个收尾Worktrunk 把 worktree 从繁琐的 git 命令变成像分支一样简单正是这个转变让并行 AI 智能体工作流真正可用。【免费下载链接】worktrunkWorktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows项目地址: https://gitcode.com/GitHub_Trending/wo/worktrunk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考