返回博客
2026 年 11 月 13 日

如何同时运行多个 AI Coding Agent,而不失去掌控

用 Git Worktree 隔离代码、用 tmux 或 Herdr 管理会话与 Agent 状态、用 SSH/Tailscale 远程访问,同时运行 Claude Code、Codex 与 OpenCode,并附 macOS、Linux、Windows 兼容性与 Redock 手机工作流。

运行一个 AI Coding Agent 很简单,同时运行三个就是另一回事了。Claude Code 在实现登录认证,Codex 在写测试,OpenCode 在排查一个前端 Bug。每个 Agent 单独工作都没问题,放在一起却会带来一堆终端窗口、互相覆盖的代码改动,而且很难一眼看出哪个 Agent 正在等你。

多开几个终端窗口解决不了问题。你需要一套工作流:代码彼此隔离,会话持续运行,离开电脑后也能查看每个 Agent 的进展。

结论速览: 想同时运行多个 AI Coding Agent 又不失控,可以这样做:

  1. 为每个 Agent 创建独立的 Git Worktree,让它在自己的目录和分支里修改代码。
  2. 在持久会话中运行 Agent:通用场景用 tmux;需要 working、blocked、done 这类 Agent 状态时用 Herdr。
  3. 提前规划 Worktree 无法隔离的共享资源:端口、数据库、.env 文件和 Docker 服务。
  4. 通过 SSH 或 Mosh 连接主机,不在局域网时再配合 Tailscale。这样手机断线不会让 Agent 停下来。
  5. 合并前逐个审查分支(git diff、跑测试)。Agent 进入 idle 不等于任务已经完成。

本文于 2026 年 11 月 13 日核验,依据 Herdr TUI v0.9.5、Claude Code 文档与 Redock 3.3。Agent 支持范围和平台细节变化较快,请以文末来源为准。

1. 为什么同时运行多个 AI Coding Agent 会变得混乱

会话一多,几类不同的问题就会同时出现:

  • 工作目录混乱:每个 Agent 到底在哪个目录里工作?
  • 代码冲突:两个 Agent 修改同一批文件时会怎样?
  • 会话管理:要找的任务在哪个终端里?
  • 错过输入:Agent 还在运行、在等审批,还是已经结束了?
  • 远程访问:离开电脑后怎么查看 Agent 的进展?

每个问题都有对应的工具:

问题 解决方式
代码改动互相覆盖 Git Worktree
会话需要在断线后继续存在 tmux、Herdr,原生 Windows 用 psmux
判断哪个 Agent 需要处理 Herdr Agent 状态、Redock Agent 动态
连接开发主机 SSH 或 Mosh,外网配合 Tailscale
在手机上完成以上操作 Redock

Agent 变多,不应该意味着更混乱。 下文按这个顺序逐层搭建。

2. 用 Git Worktree 给每个 Agent 独立的工作区

第一步是隔离代码。如果 Claude Code 和 Codex 共用一个项目目录,它们可能覆盖彼此的文件、改动同一份依赖,或者干扰对方的 Git 操作。分开终端窗口也无济于事,因为这些终端仍然指向同一个工作目录。

什么是 Git Worktree?

Git Worktree 是挂在同一个仓库上的额外工作目录。每个 Worktree 检出自己的分支,拥有独立的文件和暂存区,所有 Worktree 共享同一份提交历史。这样你可以同时拥有多个工作目录,不必在一个目录里来回切分支,也不用重新 clone 仓库。

一个仓库对应三个 Git Worktree,每个 Worktree 有独立分支和独立 Coding Agent
概念示意图 一个仓库对应三个 Git Worktree,每个 Worktree 有独立分支和独立 Coding Agent Worktree 隔离文件与分支;数据库、端口、.env 和本地服务仍然共享。

每个任务创建一个 Worktree

在已有仓库中执行:

cd my-project

git worktree add -b agent/auth  ../project-auth  main
git worktree add -b agent/tests ../project-tests main
git worktree add -b agent/ui    ../project-ui    main

git worktree list

现在你有三个互不干扰的目录,每个都在自己的分支上:

目录 分支 Agent 任务
project-auth/ agent/auth Claude Code 登录认证
project-tests/ agent/tests Codex 单元测试
project-ui/ agent/ui OpenCode 前端 Bug

Claude Code 也可以自己创建 Worktree:claude --worktree feature-auth 会在独立分支上启动一个隔离会话。在另一个终端里换个名字再执行一次,就能启动第二个。Worktree 的存放位置和清理方式见 Claude Code Worktree 文档。上面的手动命令对所有 Agent 都适用。

审查、合并与清理

Agent 完成后,先审查它的分支再合并:

cd ../project-auth
git status
git diff main...agent/auth
git diff --check

运行相关测试,再按平常的流程合并。分支合并之后删除 Worktree,避免过期目录越积越多:

git worktree remove ../project-auth
git branch -d agent/auth
git worktree prune

Worktree 隔离不了什么

Worktree 只隔离文件和分支,仓库之外的东西仍然是共享的:

  • 数据库与迁移:两个分支对同一个开发数据库做迁移会互相冲突。
  • 端口:两个开发服务器不能同时监听 3000。给每个 Worktree 分配独立端口,例如 PORT=3001。
  • 未跟踪文件:.env 等被忽略的文件不会被复制到新 Worktree,需要手动复制或生成。
  • 依赖:每个 Worktree 都需要自己的 node_modules、虚拟环境或构建产物。
  • Docker 容器和其他本地服务。
  • 同一个功能或 API:即使在不同分支上,合并时仍可能产生冲突。

原则:代码要分开,共享资源的使用方式也要提前规划。 更多选项见 git-worktree 官方文档。

3. 用 tmux 让 Agent 会话持续运行

Worktree 管好了代码,接下来需要能一直存活的终端会话。

tmux 是终端复用器(Terminal Multiplexer)。终端进程由它的 Server 持有,所以在 tmux 会话中运行的 Agent,在你 Detach、关闭终端 App 或 SSH 断开之后都会继续运行。

每个 Agent 一个会话

可以直接在对应的 Worktree 中创建后台会话,再在里面启动 Agent:

tmux new-session -d -s auth  -c ../project-auth
tmux new-session -d -s tests -c ../project-tests
tmux new-session -d -s ui    -c ../project-ui

tmux send-keys -t auth  'claude'   Enter
tmux send-keys -t tests 'codex'    Enter
tmux send-keys -t ui    'opencode' Enter

tmux ls
tmux attach -t auth

Attach 会回到已有会话,不会启动新的 Agent。按 Ctrl+B 再按 D 即可再次 Detach,Agent 继续工作。

常用 tmux 快捷键

快捷键 作用
Ctrl+B,然后 D 从会话 Detach
Ctrl+B,然后 S 从列表中选择会话
Ctrl+B,然后 C 新建窗口
Ctrl+B,然后 N / P 下一个/上一个窗口
Ctrl+B,然后 % 左右分屏
Ctrl+B,然后 " 上下分屏
Ctrl+B,然后 W 在所有会话的窗口中选择

Session(会话) 是一个工作环境,Window(窗口) 是其中的全屏标签页,Pane(窗格) 是窗口内的分屏。像上面那样每个任务一个会话,在手机上看名字也一目了然;每个项目一个会话、每个 Agent 一个窗口也可以。选择你一眼能看懂的布局即可。

在这个工作流里,tmux 有一个局限:它管理终端进程,但不理解 Agent 的状态,无法告诉你 Codex 是在思考还是在等审批。更多内容见 tmux 入门指南 和我们的 tmux 移动开发一文。

4. 需要 Agent 感知能力时,使用 Herdr

Herdr 是专为运行 Coding Agent 设计的终端工作区管理器。和 tmux 一样,它由后台 Server 持有终端,Detach 后 Agent 继续运行。它多了一层 tmux 没有的能力:识别每个 Pane 里的 Agent,并报告它正在做什么。

用的是哪个 Herdr? 本文指的是终端版 Herdr TUI(命令 herdr)。新的 Herdr 桌面 App 基于 herdr-core(命令 hc),这是另一套独立的 Runtime,两者之间的 Agent 不互通。Herdr 官网也列出了自己的 iPhone、iPad 和 Android App,用于查看和回复 Agent;本文以及 Redock 的 Herdr 集成针对的都是 Herdr TUI。详见 Herdr TUI 与 herdr-core 的区别。

Workspace、Tab 与 Pane

Herdr 通常为每个项目或分支建立一个 Workspace。Workspace 里有多个 Tab,每个 Agent 或终端运行在自己的 Pane 中,侧栏按状态归类所有 Agent。配合 Worktree 时,自然的做法是每个 Worktree 一个 Workspace,里面放一个 Agent Pane,再加一个跑测试或看日志的 Pane。

Herdr 的 Agent 状态

状态 含义 该怎么做
working Agent 正在运行 不用管它
blocked 等待可见的审批、问题或权限确认 去回答
done 已结束,在你查看前会一直标记 查看输出
idle 停在输入提示符 先确认,再发送输入

实际使用时要注意两点。第一,done 和 idle 不代表任务成功,只说明 Agent 停下了,一定要看输出、跑测试。第二,Herdr 对 blocked 的判断刻意从严,没见过的新提示可能先显示为 idle。官方文档也提醒,不要把 idle 当作可以直接发送输入的信号。

支持的 Agent 与集成

Herdr 能识别 23 种 Agent,包括 Claude Code、Codex、OpenCode、GitHub Copilot CLI、Cursor Agent CLI、Pi、Kimi Code、Qwen Code 和 Gemini CLI。大多数通过读取 Pane 底部的屏幕内容识别。安装集成后,部分 Agent 会主动上报状态,并且能在 Herdr Server 重启后恢复对话:

herdr integration install claude
herdr integration install codex
herdr integration status

最新列表和每个 Agent 的识别方式见 Herdr Agents 文档。

断开、重启之后还剩什么

事件 tmux Herdr TUI
Client Detach 或 SSH 断开 Agent 继续运行 Agent 继续运行
Server 重启 会话丢失 恢复布局和工作目录;装有最新集成的 Agent 可恢复对话
主机重启或断电 会话丢失 从最近保存的布局恢复,效果等同 Server 重启

(来源:Herdr Session State 文档)

选 tmux 还是 Herdr?

tmux Herdr TUI
持久会话、窗口/Tab、Pane 支持 支持
识别 Coding Agent 不支持 23 种 Agent
Agent 状态(working/blocked/done/idle) 不支持 支持
Server 重启后恢复 Agent 对话 不支持 安装集成后支持
命令兼容性 业界标准 独立 CLI,不兼容 tmux
适合 轻量、通用的终端 跨项目管理多个 Agent

同一个 Agent 只选其一。不要在 Herdr Pane 里再用 tmux 包住 Agent。 Herdr 依据 Pane 的前台进程识别 Agent,嵌套的 tmux 会把它挡住,导致状态识别和对话恢复都失效。更深入的对比见 Herdr 原理详解及与 tmux 的区别。

5. 平台兼容性:macOS、Linux 与 Windows

工作流在各平台上都一样,但工具的支持情况不同:

macOS Linux Windows(原生) Windows(WSL2)
Git Worktree 支持 支持 支持 支持
tmux 支持(Homebrew) 支持 不支持,改用 psmux 支持
Herdr TUI 支持 支持 Beta(ConPTY) Linux 版本
Redock 会话持久化 tmux、Herdr tmux、Herdr psmux tmux、Herdr
Redock「后台长任务」Action 支持 支持 不支持 支持

macOS

brew install tmux
tmux -V

curl -fsSL https://herdr.dev/install.sh | sh   # 可选:Herdr TUI

在 系统设置 → 通用 → 共享 → 远程登录 中开启远程登录,就能通过 SSH 访问这台 Mac。然后按各 Agent 的官方说明安装即可。

Linux

sudo apt update && sudo apt install tmux
tmux -V

curl -fsSL https://herdr.dev/install.sh | sh   # 可选:Herdr TUI

长期开机的 Linux 工作站或服务器,是运行长时间 Agent 任务最稳定的主机。

Windows

Windows 有两条路线:

  • WSL2(Linux 工作流):在管理员 PowerShell 中执行 wsl --install,按提示重启,然后在 Ubuntu 里安装 tmux、Git 和各个 Agent。仓库放在 Linux 文件系统里(例如 ~/code),不要放在 /mnt/c 下,性能更好,路径问题也更少。要从手机访问这个环境,请参考 Windows(WSL2)远程登录指南。
  • 原生 Windows:Herdr TUI 提供 Windows Beta(powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"),通过 ConPTY 运行 Pane,支持持久会话、Agent 识别和 Git/Worktree 识别。它通过扫描 Pane 的进程树识别 Agent,而不是使用 Unix 前台进程组,所以结果可能和 macOS、Linux 不同,可安装的集成也更少。如果需要在 PowerShell 中使用兼容 tmux 的持久会话,请用 psmux。

在 Redock 中: Redock 的 Herdr 集成目前面向 macOS 和 Linux 主机(包括 WSL2)。通过 OpenSSH 连接的原生 Windows 主机,请把会话持久化设为 psmux。「后台长任务」Action 需要装有 tmux 的 POSIX 主机。参考 Herdr Windows Beta 说明 和微软的 WSL 安装指南。

6. 让工作流随时随地可访问

离开电脑后,Agent 仍在工作。你可能需要回答一个审批、看一眼结果,或者启动下一步。你不需要把开发环境搬到手机上,只需要连上它。

手机上的 Redock 通过 SSH 或 Mosh 连接开发主机,tmux 或 Herdr 让三个 Agent 持续运行
概念示意图 手机上的 Redock 通过 SSH 或 Mosh 连接开发主机,tmux 或 Herdr 让三个 Agent 持续运行 断线时只有手机这条连接中断,Agent 继续在主机上运行。

每一层只负责一件事:

层 职责 不负责什么
SSH 到主机的加密远程终端 断线后让进程继续存活
Mosh 在 Wi-Fi/蜂窝切换和休眠后保持交互终端可用 替代 tmux 或 Herdr
Tailscale 设备间的私有网络,无需公开 SSH 端口 提供 Shell,主机上仍需运行 SSH
tmux/Herdr 持有终端,让 Agent 比连接活得更久 在崩溃或关机后保留原来的进程

手机断开时会发生什么?

  1. 你在开发主机的 tmux 会话或 Herdr Pane 中启动 Claude Code。
  2. 用手机上的 Redock 连上去,看一眼进度。
  3. 锁屏,或者从 Wi-Fi 切到蜂窝网络。
  4. SSH 连接断开,主机上的会话继续运行。
  5. 重新连接,回到同一个会话,Agent 的输出完整保留。

Agent 运行在开发主机上,而不是手机上。手机断线不会让编码任务停下来。只有主机关机、崩溃或进程被杀掉,持久化才会失效。

7. Redock 在多 Agent 工作流中的位置

Redock 是一款面向 AI Coding Agent 设计的移动 SSH/Mosh 终端,支持 iOS 和 Android,下面的截图来自 iOS 版。它不替代 Git、tmux、Herdr 或你的 Agent,而是把手机接入你已经在用的这套环境。

每个 Worktree 一个 Project

Redock 的 Project 把一个 Host 和一个工作目录绑定在一起,同时收纳 Action、Snippet 和连接。为每个 Worktree(project-auth、project-tests、project-ui)各建一个 Project,每个 Agent 的上下文都只需点一下。

包含 Actions 和 Snippets 的 Redock Project Home
操作截图 包含 Actions 和 Snippets 的 Redock Project Home Project Home 将目录、Host、Actions、Snippets 和活动连接集中在同一个上下文中。

用 Action 启动工作

Action 是保存好的命令,可以选择运行方式:

  • 终端交互:打开终端并保留会话,适合 claude、codex。
  • 快速任务:通过 SSH 执行、等待完成,并把输出保存为一次 Run,适合 npm test、git status。
  • 后台长任务:在远程 tmux 中启动并保存日志,手机断开后仍会继续运行。

回到已有会话

把 Host 的会话持久化设为 tmux、Herdr 或 psmux 后,Redock 会重新连接到已有会话,而不是开一个新 Shell。使用 Herdr 时,herdr 工作区面板会列出 Space、Tab、Pane 和 Agent 及其状态(Working、Attention、Done、Idle),点击条目即可跳到对应终端。

Redock 的 herdr 工作区面板,列出 Space、Tab、Pane 与 Agent
操作截图 Redock 的 herdr 工作区面板,列出 Space、Tab、Pane 与 Agent 点击 Pane 或 Agent 条目即可跳到对应终端,也可在面板中新建、分屏、重命名和关闭工作区。

看到哪个 Agent 需要你

在主机上安装可选的 Redock Hook(Redock Pro)后,Agent 动态页会把每个会话显示为工作中、需要处理、已完成或失败。Agent 完成或需要输入时,即使 App 没有打开,也会收到通知和实时活动。状态、通知和对话视图适用于 Redock 支持的 Agent,包括 Claude Code、Codex 和 OpenCode,具体信号取决于各 Agent 的集成方式。

在对话视图中阅读和回复

对话视图把正在进行的 Agent 对话显示为易读的消息,保留 Markdown、表格和代码排版,你的回复会回到同一个终端会话。支持 Claude Code、Codex、OpenCode、Pi、Oh My Pi、Kimi Code、Grok Build 和 Antigravity CLI。

Redock 对话视图中以消息形式呈现的 Coding Agent 回答
操作截图 Redock 对话视图中以消息形式呈现的 Coding Agent 回答 对话视图保留 Markdown、表格和代码排版,工具细节默认折叠,需要时再展开。

在手机上审查改动

  • Git 变更视图:查看当前会话所在仓库的已暂存、未暂存和未跟踪改动,支持单栏/双栏 Diff,也可以暂存和提交。合并前检查 Worktree 分支,用它最顺手。
  • 文件:通过 SFTP 浏览和预览文件。
  • Web 预览:通过 SSH 隧道打开开发服务器的 localhost 地址。每个 Worktree 使用独立端口时尤其方便。
  • 语音输入:口述长段 Prompt,发送前可以编辑转写结果。

电脑负责干活,手机让你保持掌控。

8. 串起来:一套实用的多 Agent 工作流

第 1 步:把工作拆成互相独立的任务。 比如登录认证、前端改进、单元测试。如果两个任务会改同一批文件或迁移,就先后执行。

第 2 步:创建 Worktree。

git worktree add -b agent/auth  ../project-auth  main
git worktree add -b agent/ui    ../project-ui    main
git worktree add -b agent/tests ../project-tests main

复制所需的 .env 文件,并为每个 Worktree 分配不同的开发服务器端口。

第 3 步:选定一种会话管理方式。 每个任务一个 tmux 会话,或者每个 Worktree 一个 Herdr Workspace,不要嵌套。

第 4 步:启动 Agent。 在 project-auth 中运行 claude,在 project-ui 中运行 opencode,在 project-tests 中运行 codex。

第 5 步:关注「需要处理」的 Agent,而不是逐个翻终端。 用 Herdr 侧栏或 Redock 的 Agent 动态查看谁处于 blocked 或 done。只用 tmux 时,按 Ctrl+B 再按 S 逐个查看会话。

第 6 步:逐个审查分支。 运行 git diff main...agent/<task> 和测试,全部通过再合并。看起来已经结束的终端,不等于测试已经通过。

第 7 步:远程继续。 打开 Redock,选择对应的 Project,回到同一个会话:回答审批、查看 Diff,或者启动下一个 Action。

第 8 步:清理。 执行 git worktree remove,并删除已合并的分支。

常见问题

可以同时运行多个 Claude Code 会话吗?

可以,每个 Claude Code 进程彼此独立。需要修改代码的任务,应给每个会话分配独立的 Worktree:用 git worktree add,或者用 Claude Code 内置的 claude --worktree <name>。

应该同时运行多少个 AI Coding Agent?

先从两三个开始。瓶颈通常不是机器性能,而是你审查结果、处理审批的精力。只有在任务真正互相独立、而且你能审查每个分支时,再增加 Agent。

每个 AI Coding Agent 都需要独立的 Git Worktree 吗?

会修改文件的 Agent 都应该有。只读代码、回答问题或做分析的 Agent 可以共用一个目录。

tmux 和 Herdr 有什么区别?

两者都能让终端在断开后继续运行。tmux 是通用的终端复用器,不知道 Agent 在做什么;Herdr 能识别 Coding Agent,并显示每个 Agent 处于 working、blocked、done 还是 idle。每个 Agent 用其中一个即可,不要嵌套。

Herdr 支持 Windows 吗?

Herdr TUI 提供基于 ConPTY 的原生 Windows Beta,可用的集成更少,键盘和光标也有一些限制;它也可以作为 Linux 程序运行在 WSL2 中。Redock 的 Herdr 集成面向 macOS 和 Linux 主机,原生 Windows 请使用 psmux。

SSH 断开后,AI Agent 还会继续运行吗?

如果它运行在主机上的 tmux、Herdr 或 psmux 中,就会继续运行。没有这些工具时,关闭 SSH 会话通常会结束 Agent。不过它们都无法在重启、崩溃或断电后保留原来的进程。

可以用手机管理多个 AI Coding Agent 吗?

可以。在 Redock 中,你可以重新连接 tmux 或 Herdr 会话,查看哪些 Agent 需要输入,在对话视图或终端中回复,并审查 Diff,而 Agent 始终运行在你的开发主机上。

总结

同时运行多个 AI Coding Agent,只有在工作流井然有序时才能真正提高效率:

  • Git Worktree 隔离代码;
  • tmux 或 Herdr 让会话持续运行,Herdr 还会告诉你哪个 Agent 需要你;
  • SSH、Mosh 与 Tailscale 让主机随时可达;
  • Redock 把这一切带到手机上。

代码、工具和 Agent 都留在开发主机上,手机让你随时跟进需要你做的决定。

开始使用 Redock

参考资料

在手机或平板上试试 Redock

用手机控制运行在自己主机上的终端编码 Agent