parallel-code：让多个 AI 编程代理在各自 git worktree 里并行干活

一个工具，多个代理，各自独立的 git 分支

parallel-code 解决的是一个具体问题：当你想让多个 AI 编码代理同时干活时，它们会互相踩脚。如果都在同一个目录里改文件，冲突不可避免。如果开多个终端窗口，你又得手动管理分支、worktree 和合并，很容易搞混。这个项目把这一切收进了一个图形界面。你创建任务时，它自动从主分支拉出一个新分支，建立独立的 git worktree，把 node_modules 等被 gitignore 的目录符号链接进去，然后在该 worktree 里启动代理。每个代理在物理上隔离的目录中工作，互不干扰。你可以在侧边栏看到所有任务的状态，审阅 diff，决定哪些合并回主分支，哪些直接丢弃。它的定位很明确：不是替代 Claude Code 或 Codex，而是给这些 CLI 工具加一个并行调度层。适合那些已经用这些代理、但觉得串行执行太慢、手工管理多个副本太麻烦的开发者。

worktree 加 symlink：隔离的代价与妥协

核心机制是 git worktree，这是 git 自带的特性，允许同一个仓库有多个工作目录，每个目录对应不同分支。parallel-code 在每个 worktree 里启动代理，天然避免了文件冲突。但有一个细节值得注意：它把 node_modules 和 gitignored 目录符号链接进 worktree。这意味着依赖不是每个 worktree 独立安装的，而是共享的。好处是省磁盘空间和安装时间，坏处是如果代理需要修改 node_modules 里的东西，或者依赖版本与分支不匹配，就会出现奇怪的问题。文档没有提到如何处理这种共享依赖的冲突，这是一个潜在坑。另外，worktree 本身要求仓库必须是 git 仓库，虽然项目也支持无 git 仓库的文件夹，但那种情况下没有分支隔离，等于退化为普通的多代理并行。

从下载到跑起来：命令与配置

安装方式很简单，从 releases 页面下载 macOS 的 .dmg 或 Linux 的 .AppImage/.deb，不需要 npm 全局安装。前提是你已经装好了至少一个代理 CLI，比如 Claude Code、Codex CLI、Gemini CLI、Antigravity CLI 或 Copilot CLI。打开应用后，指向一个 git 仓库，就可以开始派发任务。如果你想从源码构建，文档给出了三条命令：git clone、npm install、npm run dev，要求 Node.js v18 以上。配置方面，有一个设置项可以切换代码问答所用的 LLM，默认是 Claude Code，也可以换成 MiniMax M2.7，后者有 204K 的上下文窗口。键盘快捷键是全局的，Ctrl+N 新建任务，Ctrl+Shift+M 合并到主分支，Ctrl+Shift+P 推送到远程。这些快捷键可以在设置里按代理预设调整。整个流程没有复杂的配置文件，属于开箱即用的类型。

Docker 沙箱的认证陷阱：Antigravity 的例外

项目支持用项目内的 .parallel-code/Dockerfile 来沙箱化任务，让代理在容器里运行。但文档明确警告了一个失败模式：Antigravity CLI 在 Docker 隔离下无法认证。原因是 agy 命令需要交互式登录，并把凭据缓存在操作系统的 keyring 里，比如 macOS 的 Keychain 或 Linux 的 libsecret。容器里没有 secret-service 守护进程，keyring 不可达，而 agy 又没有 API-key 回退机制，所以 Docker 隔离的 Antigravity 任务无法通过认证。文档给出的建议是让 Antigravity 以原生方式运行，而不是放进 Docker。这个限制暴露了一个通用问题：不是所有代理 CLI 都适合容器化。在依赖 Docker 沙箱之前，你应该确认所用代理是否支持非交互式认证。项目预留了 forward-compatible 的路径，说如果 agy 以后支持文件或 API-key 认证，Docker 支持就能用上，但那是未来的事。

界面与工作流：不只是并行，还有审阅和监控

并行只是起点，真正的价值在于事后的审阅和管理。内置的 diff 查看器支持行内评论和按提交导航，你可以直接在界面上标注问题，然后把笔记作为提示词发给代理。Steps tracking 面板会记录代理的进度时间线，写入 .claude/steps.json，有点像是工程经理视角的看板。每个任务还有独立的 shell 终端，工作目录就是对应的 worktree，方便你手动检查或干预。PR CI 状态监视器会在 GitHub 检查稳定后发桌面通知，省得你反复刷新网页。手机监控功能通过扫描二维码，在 Wi-Fi 或 Tailscale 网络下查看代理运行状态。这些功能合在一起，构成了一个完整的闭环：派发、观察、审阅、合并。对于同时跑五个代理的用户来说，这个界面比五个终端窗口清晰得多。

替代方案：终端、VS Code 扩展与串行执行

README 里有一张对比表，列出了三种常见替代方式。第一种是多个终端窗口或 tmux，缺点是没有 GUI，也没有自动的 git 隔离，你得手动管理 worktree、分支和合并。第二种是 VS Code 扩展，比如 Kilo Code 或 Roo Code，问题在于它们被绑定在 VS Code 里，而且无法在代理之间提供真正的并行 worktree 隔离，多个代理共享同一个工作区，冲突风险依然存在。第三种是串行执行代理，一次一个任务，虽然简单，但会阻塞你的工作流。parallel-code 的差异在于它把 worktree 隔离做成了自动化，并且不依赖特定编辑器。但这也意味着它需要你信任它的合并逻辑，你得手动确认每个 diff 再合并。如果你的工作流本来就习惯用 tmux 和手工 git 命令，这个工具的价值就打了折扣。

维护成本与许可：MIT 下的自主责任

项目采用 MIT 许可，意味着你可以自由使用、修改、分发，甚至商用，只要保留版权声明。没有额外的平台费用，代理的订阅费用直接付给对应厂商。维护方面，仓库最近一次推送是 2026 年 8 月，版本号到了 v1.14.5，说明还在活跃迭代。但维护成本取决于上游代理 CLI 的变化。如果 Claude Code 或 Codex 改变了命令行接口或认证方式，parallel-code 需要跟进适配，否则可能失效。文档没有提供升级指南或迁移说明，但既然是从 releases 下载的二进制，升级就是替换文件。另外，steps.json 这个文件写在 .claude 目录里，可能会与 Claude Code 自身的配置产生交互，如果你有自定义的 Claude 设置，需要留意是否会被覆盖或干扰。整体来说，MIT 许可给了你修改的自由，但也意味着出了问题你得自己解决，没有商业支持。

编辑结论

parallel-code 适合那些已经依赖 Claude Code、Codex 或 Gemini CLI、并且愿意接受桌面应用和 worktree 工作流的开发者，尤其是需要同时推进多个独立功能、希望减少手工切换上下文的场景。不适合完全在容器里运行 Antigravity 的用户，因为其交互式登录无法在 Docker 隔离中完成认证；也不适合不熟悉 git worktree 和分支合并的初学者，因为错误合并可能污染主分支。采用前应验证你的代理 CLI 是否支持非交互式认证，检查项目是否允许 symlink node_modules，并在小仓库上试用 worktree 导入和合并流程，确认与你的 CI 检查无冲突。该工具持续更新，但维护成本取决于上游 CLI 的变化，MIT 许可允许自由修改，但你需要自行承担适配新代理版本的责任。

官方来源

1. Official documentation
2. Official README
3. Project repository
4. Release notes