Parallel Code是一款免费开源的 AI 并行编程桌面应用，让你同时运行 Claude Code、Codex、Gemini 等多个 AI 编程 Agent，每个任务自动隔离在独立的 git 分支与 git worktree 中，零冲突地并行开发。本教程带你完成环境准备、应用安装，并跑通第一个多 Agent 并行任务，新手 15 分钟即可完成。

一、Parallel Code 是什么：一个任务、一个分支的并行范式

用 AI 编程工具时，多数人只能一个接一个地跑：等 Agent 干完活才干下一个，多个任务的改动混在同一个目录里，回滚起来很麻烦。Parallel Code 正是为解决这个问题而生：

• 自动隔离：创建任务时自动从主分支切出新分支，并建立独立的 git worktree，每个 Agent 在自己的目录里干活
• 并行派遣：同时让 5 个 Agent 处理 5 个功能，互不干扰、零冲突
• 统一评审：所有 Agent 的改动 diff 集中在同一界面审阅，好的合并、差的丢弃
• Agent 无关：Claude Code、Codex CLI、Gemini CLI、Copilot CLI 等主流命令行工具，一个界面全搞定

其工作流程（新建分支 → 建 worktree → 符号链接node_modules→ 启动 Agent）完整说明在 README.md 的 "How it works" 一节，官方演示动图效果更直观：

二、安装前准备：先备齐三样东西

项目技术栈为 Electron + SolidJS + TypeScript，构建脚本定义在 package.json 中；项目的开发约定可参考 AGENTS.md 与 CLAUDE.md。

三、最快安装方式

方式一：下载官方 Release（最快，2 分钟）

1. 从项目的 releases 页面下载对应平台的最新版本：macOS 为通用.dmg，Linux 为.AppImage或.deb
2. 打开安装文件，装完即用

安装步骤原文见 README.md 的 "Getting Started" 章节。

方式二：源码快速构建（适合想参与开发的伙伴）

需要 Node.js v18+：

git clone https://gitcode.com/gh_mirrors/pa/parallel-code cd parallel-code npm install npm run dev

npm run dev命令定义在 package.json，它会同时拉起 Vite 开发服务器与 Electron 窗口，代码改动可实时看到效果。

💡 小提示：开发模式下手机 Web 端使用8777端口，正式安装版使用7777，两者可以同时运行。

如果想构建正式安装包，install.sh 会自动处理 macOS（构建 → 挂载 DMG → 拷贝到 /Applications）和 Linux（构建 →dpkg安装.deb）全流程。

四、跑通第一个多 Agent 并行任务

第 1 步：添加项目并创建任务

打开 Parallel Code，在左侧Projects列表中添加本地 git 项目，点击+ New Task（快捷键Ctrl+N），输入一段任务描述，例如："为项目补一份 README 使用说明"。

第 2 步：看着多个 Agent 并行开工

重复上一步再创建几个任务，为每个任务挑选不同的 Agent（Claude Code、Codex、Gemini 随意组合）。主界面就是多任务网格布局，每个任务都有独立的终端、变更文件列表与进度条：

每个面板完全独立：Agent 运行在自己的 worktree 里，node_modules等 gitignored 目录会被自动符号链接进来，无需重复安装依赖。想专注单个任务时，按Ctrl+Shift+F切换聚焦模式，宽屏下是清爽的双栏布局：

第 3 步：审阅 diff 并合并回主分支

Agent 完成后，在任务里打开 diff 查看器逐行审阅。它支持行内评审批注，还能把批注直接发给 Agent 修改：

满意后在侧边栏把分支合并回 main（Ctrl+Shift+M打开完成对话框）。合并好的、丢弃差的，这就是 Parallel Code 的核心工作哲学。

五、进阶玩法一览

• 🏆AI Arena：让不同 Agent 就同一任务"赛跑"，并排对比输出、打分，把冠军方案合并回 main（入口在侧边栏底部）
• 📱手机监控：通过Connect Phone扫码，用 Wi-Fi 或 Tailscale 远程查看 Agent 进度，任务等待人工输入时还能收到推送通知
• 🌐浏览器预览：在任务 shell 中运行本地应用后打开+ → Browser，可直接圈选页面元素写进 prompt，详见 docs/browser-preview.md
• ⌨️键盘优先：所有操作都有快捷键，完整列表见 README.md

想深入了解实现的话：主进程逻辑在 electron/ 目录，多 Agent 协调的 MCP 服务在 electron/mcp/coordinator.ts，前端 UI 组件在 src/components/。

六、常用快捷键速查

macOS 上请把Ctrl换成Cmd。

写在最后

从安装到跑通第一个多 Agent 并行任务，通常不超过 15 分钟。当你第一次看到三个 Agent 同时在不同分支里改不同的文件、再把最优的那份合并回 main 时，就会明白：并行，才是 AI 编程时代的正确打开方式。Parallel Code 基于 MIT 协议开源免费，不妨装来试试，看看它能帮你省下几个下午。