快速开始
同一个项目里同一个工具的多个会话，各自是各自的智能体
在同一个项目文件夹里把 Claude Code、Codex 或 OpenCode 打开两次——或者十次——并给每个会话各自的 Orchyst 智能体：在对话里有自己的名字、自己的消息、自己的终端。这里是完整的走查：在控制台里做什么、在终端里运行什么、在手机上点什么。
你最终会得到什么
同一个文件夹里同一个工具的多个会话，各自扮演不同的智能体。在空间里提及其中一个，只有它会醒来；提及另一个，它会用自己的名字回答。它们读同一份代码，却从不读对方的消息。
这之所以可行，是因为项目里没有任何地方写死了某个智能体。工具自身的配置只指向 Orchyst 一次——每个会话都是同一行——而每个会话在 CLI 启动它的那一刻被告知自己是哪个智能体。所以同一个工具的第二、第三乃至第十个会话，都只是把授权与批准这两步再做一遍，什么都不用重新接线。
这需要三个界面、大约五分钟：控制台用来创建身份，你的终端用来授权，控制台或手机应用用来逐个批准。下面的一切都是一次真实运行——两个 Claude Code 会话，一张截图接一张。对 Codex 和 OpenCode 步骤完全相同，而且这些会话甚至不必运行同一个工具。
第 1 步
创建智能体
智能体在成为你机器上的任何东西之前，先是平台上的一个身份，所以每个会话都需要一个已经存在的身份。你在哪里都可以创建——控制台里的 Agents，或手机应用的 Agents 标签页——并把每一个都设成你打算运行的工具：本次走查把两个都设为 Claude Code。给它们起一眼就不会混淆的名字；在一条线索里，规划者和评审者比 agent-1 与 agent-2 好读得多。
同一提供商的两个智能体不是什么特例。提供商只决定 CLI 在那个会话的终端里启动什么——Claude Code、Codex 与 OpenCode 各自都有 CLI 已经知道的启动命令，所以不需要再配置别的。若列表里没有你要的工具，就选 Other——你自己的启动器，或任何你自行启动的东西——然后在那个智能体的配置文件里一次性告诉 CLI 该怎么启动它。
目前还什么都没运行。到这一步，智能体已经存在、什么也不拥有，正等着一台机器以它们的身份行事。
第 2 步
在你的机器上授权第一个会话
在项目文件夹里运行 CLI 的 add 命令。它联系 Orchyst，打印一段短代码，然后等待——它不会向你要密码，也从不会看到密码。
注意它同时给出了两条路。在浏览器里打开打印出的链接，或者拿出手机——两种方式的代码是同一个，正是它证明了发出请求的就是你面前这台机器。
第 3 步
在控制台或手机上批准它
以这些智能体所有者的身份登录，核对屏幕上的代码与终端里的一致，然后选择这台机器以你的哪个智能体行事——先选两个中的第一个。列表里每个智能体的名字下方都标着它的提供商，所以同一工具的两个智能体只能靠名字区分：请读清楚。控制台一屏完成；手机应用分三步。
第 1 张，共 3 张
代码就是那道核对，所以请把它读一遍，而不是凭当下的感觉相信它。如果出现了一个不是你发起的请求，请拒绝——在你批准之前什么都不会写入，而无人理会的请求会自行过期。
第 4 步
这一步在你的机器上放了什么
你一批准，终端就回来了，并明确告诉你它做了什么。
该智能体的凭据只为这一个身份写入，并且只有你能读。在它旁边，CLI 留下了该会话将要遵循的消息说明，在这个项目内把工具接到 Orchyst，并把这些说明加进工具启动时会读取的文件里。项目文件夹之外的任何东西都不会被碰到。
请仔细读那一行接线，因为它正是本页的要点：工具的配置由这里的每个会话共用，而且它不指名任何智能体。它告诉你这个项目目前有几个智能体——到现在是一个——以及每个会话各自绑定到自己的那一个。具体是哪些文件取决于工具；对 Claude Code 来说是 .mcp.json 与 CLAUDE.md。
第 5 步
对第二个会话做同样的事
把同一条命令再运行一次，并以另一个智能体的身份批准。这就是一个会话与两个会话之间的全部差别：命令不变，只是批准时你选的智能体不同。
同一个工具、同样的文件，而且什么都没有被覆盖：那一行接线现在算上了两个共用它的智能体。第一个智能体的凭据原封不动地待在新凭据旁边，工具的配置也和先前一模一样——它从来就没有指向过其中任何一个。
现在项目里有两份凭据，每个身份一份。第三个会话就是把同一条命令跑第三次，依此类推——无论智能体运行的是哪个工具，这一步都不会因为数量变多而变难。
第 6 步
启动这两个会话
不带参数运行 CLI，它会为这个项目打开一个小菜单。启动每个智能体，它就会在自己的终端里起来，运行 Claude Code，监听一切发给它的内容。CLI 在打开每个终端时会告诉那个会话它是哪个智能体，工具便正是以那个身份连接到 Orchyst——你从来不用敲名字。
两个都活着且互不相干：两个中的两个都在运行，各有自己的终端名。用 attach 命令加入其中任意一个并问它是谁——每个都会报出自己的名字。再离开，不必停止它。
如果你改为自己从普通 shell 启动工具，而这个项目里有不止一个智能体，它并不知道自己是哪一个：它能看到的唯一 Orchyst 工具就是 use_agent，直到该会话说明自己以哪个智能体的身份行事为止。由 CLI 启动的会话从不会看到这个问题。
第 7 步
在控制台或手机上看到它们
这两个智能体都在你的清单里，两个界面上都有，各自显示你选的提供商以及它所属的位置。这正是你创建它们的那份列表——区别在于现在已经有机器在以它们的身份行事了。
从这里开始，它们和任何其他参与者一样。把它们各自加入一个空间，按名字提及其中一个，就只有那个会话会醒来。
这里显示的状态，是每个智能体最后一次报告的自身状态——工作中、等待中、空闲——而不是它的终端是否打开。要看真正在运行什么，请到 CLI 里看。