跳到内容

并行运行和管理多个 Claude Code 会话

发布于

要同时运行多个 Claude Code 会话,可以在每个 Paneflow 面板中打开独立智能体,并为其分配边界明确的任务。如果两个会话都要修改同一仓库,就使用不同的 Git worktree。Paneflow 集中显示终端、任务上下文和活动状态;每个会话能修改什么、结果何时可以接受,仍由您决定。

本指南介绍 Paneflow 0.17.4 的会话管理流程。Claude Code 需要在实际使用的 shell 中单独安装并完成认证。Paneflow 是采用 GPL-3.0-or-later 许可证的自由软件;Claude Code 的访问和使用仍遵循其服务商规定。

Paneflow 中打开的 Claude Code 终端,侧栏显示项目任务、分支及任务状态。

侧栏在活跃的 Claude Code 终端旁显示项目任务、分支和状态。

独立会话还是子智能体?

独立会话适合需要亲自指导的任务:一个会话修复问题,另一个更新文档,各自拥有终端,必要时使用不同的检出目录。每个会话都需要单独查看和回复。

Claude Code 子智能体在一个会话内执行委派任务,使用独立上下文,并将结果返回主会话。如果希望由主会话协调范围明确的调查,可以选择这种方式。在 Paneflow 中打开两个面板不会建立这种委派关系,也不会自动共享会话历史。

如果需要混合使用工具,可参考 Claude Code 与 Codex 并行指南。以下步骤专门讨论多个 Claude Code 实例的管理。

为每个会话分配可检查的任务

先在现有项目中选取两项能独立推进的工作:一个会话更新 docs/setup.md,另一个为已经实现的解析器补充边界测试。如果测试依赖尚未完成的解析器重写,应先完成重写。

启动前,为每项任务明确以下 4 点:

  • 预期结果,以及允许修改的文件。
  • 由其他任务负责、必须保持不变的文件。
  • 可以依赖的现有行为或接口。
  • 用于验证结果的检查,以及需要您决定的事项。

确保每个检出目录都能访问项目指令。新会话不会继承另一个会话尚未保存的计划、决定或对话。

共享文件还是单独使用 worktree

第二个面板会打开另一个终端,但不会隔离文件。要在同一仓库中独立修改,可在 New branch 表单中启用 Worktree,创建分支后在该目录打开 Claude Code。另一项任务也从选定基线创建。Worktree 参考介绍了创建、复用和移除流程。

Paneflow 的 New branch 表单,Worktree 开关已启用,启动选项中包含 Claude Code。

Worktree 是可选项。只读调查可以使用现有检出目录,但需要接受文件在读取期间可能发生变化。两个会话同时写入共享文件时,需要明确协调;在同一检出目录中换一个分支名,并不会多出一份文件。

分配任务前,在每个面板中检查目录、分支和已有修改:

git rev-parse --show-toplevel
git branch --show-current
git status --short

依赖、开发服务器端口、数据库和服务商限额仍需分别处理。Worktree 分离的是工作文件,不是网络访问或运行中的服务。

找到等待处理的会话

打开 Settings > Agents,检查 Claude Code 集成。Install hooks 可启用生命周期报告;智能体监督参考说明了配置方法和没有 hooks 时的行为。Paneflow 通过可用集成显示活动及输入请求。

会话需要处理时,先切换到其终端,阅读请求后再批准。一个回合结束后,应检查实际产出。完成状态表示智能体事件,不代表实现已经验收或测试已经通过。如果状态看起来不对,应先查看终端输出,而不是重复启动同一任务。

将会话数量控制在能够逐一审查的范围内。只有任务可以独立推进,而且能够整合结果时,增加进程才有帮助。

检查修改并找回上下文

保存编辑器缓冲区,然后在任务的检出目录中查看 Changes。它会将暂存、未暂存和未跟踪的修改与该目录的 HEAD 比较。已经提交的分支改动需要另外审查。检查任务的验证结果,再按正常 Git 流程整合已审查的贡献,并验证合并后的代码树。不同 worktree 仍可能产生合并冲突。

要关闭窗口但保留运行中的终端,选择 Keep sessions running。只要会话主机和机器仍在运行,重新打开应用就会重连;持久会话指南说明了关机和睡眠的限制。如果进程已经结束,Sessions 可以加载当前目录下已保存的 Claude Code 对话。Restart 只会启动一个新 shell。

Paneflow 可以管理多个 Claude Code 会话吗?

可以。Paneflow 运行独立的 Claude Code 终端,按项目组织上下文,并通过可用集成显示活动。它不会合并模型上下文,也不会免除对工作结果的审查。

每个会话都需要 Git worktree 吗?

不需要。当任务需要独立的工作文件和分支时再使用 worktree。只读取共享检出目录的会话可以直接使用该目录,但可能看到其他会话产生的修改。

增加会话能绕过 Claude Code 的使用限额吗?

不能。Paneflow 不会改变服务商对账户、并发或用量的限制。如果任务争用同一额度、机器资源或尚未完成的结果,应减少并行任务。

继续此工作流

所有文章

v0.17.5GPL-3.0-or-later

在 Paneflow 中启动你的下一个智能体。