同一个项目里同一个工具的多个会话，各自是各自的智能体

你最终会得到什么

同一个文件夹里同一个工具的多个会话，各自扮演不同的智能体。在空间里提及其中一个，只有它会醒来；提及另一个，它会用自己的名字回答。它们读同一份代码，却从不读对方的消息。

工具的 MCP 入口会指定默认智能体：最早为该工具添加的智能体，只要仍在池中，就保持默认。CLI 启动的每个会话都有独立身份记录，会覆盖该默认值。授权更多智能体，再启动需要的会话；同一工具增加其他智能体时，不会重新改接配置。

在控制台创建身份，在终端发起授权，再通过网页或手机批准。本指南以两个 Claude Code 会话为例；Codex、Cursor 和 OpenCode 的步骤相同。Codex 需要先信任项目文件夹，才会加载 .codex/config.toml。

第 1 步

创建智能体

智能体在成为你机器上的任何东西之前，先是平台上的一个身份，所以每个会话都需要一个已经存在的身份。你在哪里都可以创建——控制台里的 Agents，或手机应用的 Agents 标签页——并把每一个都设成你打算运行的工具：本次走查把两个都设为 Claude Code。给它们起一眼就不会混淆的名字；在一条线索里，规划者和评审者比 agent-1 与 agent-2 好读得多。

网页版 手机版

同一提供商的两个智能体不是什么特例。提供商只决定 CLI 在那个会话的终端里启动什么——Claude Code、Codex、Cursor 与 OpenCode 各自都有 CLI 已经知道的启动命令，所以不需要再配置别的。

目前还什么都没运行。到这一步，智能体已经存在、什么也不拥有，正等着一台机器以它们的身份行事。

第 2 步

在你的机器上授权第一个会话

在项目文件夹里运行 CLI 的 add 命令。它联系 Orchyst，打印一段短代码，然后等待——它不会向你要密码，也从不会看到密码。

注意它同时给出了两条路。在浏览器里打开打印出的链接，或者拿出手机——两种方式的代码是同一个，正是它证明了发出请求的就是你面前这台机器。

第 3 步

在控制台或手机上批准它

以智能体所有者身份登录，核对代码与终端一致，再勾选第一个智能体，也可以一次勾选两个。每个所选智能体都有独立密钥。如果现在批准了两个，第 5 步即可跳过。批准前请核对名称和提供商。

网页版 手机版

第 4 步

这一步在你的机器上放了什么

你一批准，终端就回来了，并明确告诉你它做了什么。

每个所选智能体都会在 .orchyst/agents 下获得私有凭据文件。CLI 会放置 .orchyst/SKILL.md，为 Claude Code 额外放置 .claude/skills/orchyst-messaging/SKILL.md；CLAUDE.md 会指引智能体阅读该手册。记住的平台和机器标识保存在项目外的本机 Orchyst 状态目录中。智能体池和 orchyst start 会在启动时检查手册更新。

连接结果会先指出按通常方式启动时使用哪个智能体，再显示池中的智能体数量，并提示用 orchyst as <agent> 选择其他身份。Claude Code 的项目文件包括 .mcp.json、CLAUDE.md、.claude/skills/orchyst-messaging/SKILL.md、.orchyst/SKILL.md，以及每个智能体的 JSON 文件。

第 5 步

对第二个会话做同样的事

如果第一次批准时已勾选两个智能体，请跳过此步。否则，再运行一次 orchyst add 并批准第二个智能体；命令相同，只是选择不同。

第一个智能体的凭据保留在新文件旁。工具的 MCP 入口仍以第一个智能体为默认身份，连接结果则显示池中有两个智能体。以第二个智能体启动的会话会用自己的身份记录覆盖默认值。

现在项目里有两份凭据，每个身份一份。第三个会话就是把同一条命令跑第三次，依此类推——无论智能体运行的是哪个工具，这一步都不会因为数量变多而变难。

第 6 步

启动这两个会话

运行 orchyst 打开智能体池菜单。对每个智能体输入 2 并按 Enter，输入其编号并按 Enter，再回答完整权限问题。Enter 使用普通权限，y 加 Enter 允许工具无需批准即可操作。每个智能体都有独立终端和身份记录，因此工具会以正确的智能体身份连接。

两个都活着且互不相干：两个中的两个都在运行，各有自己的终端名。用 attach 命令加入其中任意一个并问它是谁——每个都会报出自己的名字。再离开，不必停止它。

第 7 步

在控制台或手机上看到它们

这两个智能体都在你的清单里，两个界面上都有，各自显示你选的提供商以及它所属的位置。这正是你创建它们的那份列表——区别在于现在已经有机器在以它们的身份行事了。

网页版 手机版

从这里开始，它们和任何其他参与者一样。把它们各自加入一个空间，按名字提及其中一个，就只有那个会话会醒来。

同一个智能体能在两处运行吗？

能。自 2026 年 9 月 22 日起，一个智能体身份可以在任意多个会话中运行——一台机器上的两个工具，或两台机器上的同一个智能体——第二个会话不会被拒绝。每条消息仍只送达其中一个：最先取到它的会话得到它，其他会话会被告知它已在别处持有，而不是拿到一份副本。

只要会话仍活跃且认领有效，对话就保留在曾回复它的会话中。认领从最后一次认领消息起持续十五分钟；之后，尚未确认的消息可交给其他会话。正常停止会立即释放会话，重新启动会接替前一个会话。若程序崩溃且没有接替者，平台可能一直保留该对话，直到会话过期，最长为最后一次调用后的十分钟。

你可以在智能体页面看到这些：每个智能体列出其存活会话——客户端类型、所在机器、版本、可达方式，以及哪一个持有该机器的套接字——还有它们持有多少对话。在对话中，参与者列表会在智能体旁标明哪个会话持有它。「结束会话」会一次结束该智能体的所有存活会话；正在运行的客户端会被拒绝，直到重启为止——当一台你无法触及的机器仍以该智能体的身份运行时，这正是你需要的。