多台电脑
小去是默认名字,你可以在它的页面里改;改了以后 App 里处处跟着变。
这是什么
把家里、公司的几台 Mac 连起来,像一台用:会话在哪台上干活都行,你在任何一台上都能看、能聊、能批。
什么时候用
- 一台电脑同时跑的会话不够用,想多一台分担。
- 想合上笔记本出门,活还在家里那台一直开着的电脑上接着做。
- 有些东西只在某一台上有:签名证书、连着的测试手机、某个账号的钥匙。
只有一台电脑时,这一篇可以先跳过。
先说几个词
- 电脑:装了 QU Studio 的每台 Mac,在「电脑」页里一台一张卡。Agent 在那台上跑,用的是那台电脑上你自己装、自己登录的 Agent(比如 Claude Code、Codex)。
- 主力机:小去住的那台。看板、记忆、项目列表都只在主力机上存一份,别的电脑按需来取。最好选一台一直开着的电脑当主力机。
- 别的电脑:主力机以外的电脑。上面的会话照常跑,看板这些都转给主力机。
连之前要准备
- 那台电脑也是 Apple 芯片的 Mac。
- 两台最好都更新到最新版;版本对不上时会提示先更新哪台。
- 在那台电脑上装好、登录一个 Agent(比如 Claude Code、Codex,见 装好、登录 Agent)。有一个能用就行。
- 只连你自己的电脑:配对过的电脑等于你本人,能操作你所有电脑上的会话。从别的电脑开会话、改权限,都照发起那台选的来,不再到这台确认。
连接其他电脑
- 打开「电脑」(左栏左下角的电脑按钮,或 ⌘K 搜「电脑」),点「连接其他电脑」。框里一次放全: - 那台还没装 QU Studio:复制下载链接,到那台上下载、装好打开就行(和这台是同一个 App,见 从哪开始)。 - 在那台输这个码:这台的配对码,形如
12-482 916,10 分钟内有效。 - 或者,输入那台给的码:那台出了码的话,在这里输。 - 在另一台上也打开「电脑」→「连接其他电脑」,输入这台的码(也能粘贴配对链接),点「连接」。哪台出码、哪台输码都行。
- 输码的那台会问 主力机用哪台?:两台都列出来,写着名字、开机习惯、上面有几个项目。默认选已经有项目、一直开着的那台;都没有就选出码的那台。 - 下面写着选了以后哪台的东西会并过去。全新的电脑也会问这一步。 - 两台都有的同一个仓库(按 git 远端认出来),可以选「合成一个项目」或「分成两个」。 - 设置两台不一样的,可以挑用哪台的,默认用选的主力机上的。 - 并过去以后不能自动拆回来,看清楚再点「确定」。
- 选了输码这台当主力机时,点「确定」以后框里写着进度:连上那台 → 把两台的项目、任务、记忆合在一起 → 小去搬到这台;可以「放到后台」。
- 出码的那台:那台输好码,框里出绿字「连上了:那台的名字」,点「下一步」给那台起个名字(左栏、会话里都用这个),选它一般什么时候开着、同时最多跑几个任务,点「完成」。
配对码前面的编号(12)是中继给的,中继只看得到这一段,看不到后面 6 位。码过了 10 分钟或者输错太多次就作废,点「重新出一个码」。
- 这台已经连在别的电脑上(它不是主力机):框里不出码,到主力机上去连。
- 这台已经连着别的电脑:照样能出码让新的电脑输,但不能再输别人的码。
加好以后
- 会话:别的电脑上的会话也出现在左栏,能看能聊。会话头部写着它在哪台电脑上跑。
- 新项目:建项目时选放在哪台电脑;以后能在项目的「⋯ → 换电脑」里换(那台上要先有这个仓库)。填那台上的目录时可以用
~。 - 在哪几台上:一个项目可以在几台电脑上各放一份代码(项目设置 ›「在哪几台上」)。代码以远端仓库(GitHub 这类代码托管上的那份)为准:在哪台干就在哪台合,合完推到远端,别的几份开工前拉一下就是最新的。
- 派活落在哪台:任务详情「在哪台跑」写着实际去的那台,左栏也标电脑名。 - 你点名了哪台,就去哪台; - 没点名时,跟着同一需求上一步那台走; - 都没有时,比较几台谁更空(在线、版本一样、有这个项目的一份或在「派给哪些电脑和 Agent」里勾了、有空位),派给更空的那台。换了台会在任务动态里写一行改在哪台、为什么; - 原型任务一律在原型登记的那台。
- 按电脑看:左栏「项目 · 全部电脑」能只看某一台上的项目。
- 限额:左下角的限额能换一台电脑看。
- 同时最多跑几个:「电脑」页每台都能设,这台上所有 Agent 共用这个名额。满了新交出去的任务排队,空出来自动接上;排着的任务等到另一台空出位置也会改过去。
- 新对话开在别的电脑上:截图、文件照样能贴、能拖,直接传到那台。
- 帮手开在别的电脑上:要用只有另一台才有的钥匙、设备或工具时,会话可以直接在那台叫一个帮手,在那台的项目副本里干,左栏挂在发起它的会话下面。
- 能签名发版:「电脑」页每台的菜单里能勾。发版任务(说「发版」后自动建的,或标题是「发版 0.4.28」这样的)没指定电脑时,只交给勾了的、在线的、有这个项目一份的那台,不落到默认那台;一台都用不了就不交,在「等你处理」里问你、写明为什么。钥匙串里有 Developer ID 证书的电脑第一次连上时自动勾上,之后只按你勾的来。指定了电脑的照指定;一台都没勾时,你自己点「交出去」照常交到默认那台。
多机协作:项目留在一台,Agent 在另一台改
项目可以只留在一台电脑上(项目电脑),由另一台电脑上的 Claude Code 或 Codex 来改,那台不用放一份代码。
- 怎么设:项目设置 ›「派给哪些电脑和 Agent」里勾这个项目能派给哪些「电脑+Agent」,可以设一个默认。没设过时照旧派到项目所在那台或有一份项目的电脑;勾了以后只在勾的里面派。
- 怎么挑:交出去时先看你有没有点名;没点名用项目默认;默认满了、连不上或额度用完,就在勾的里面挑有空位、额度够的。几台是同一个账号时,额度一起算。
- 谁读写:Agent 在另一台想,读文件、改文件都由项目电脑按这个任务的授权去做;任务详情里能看到是哪台、哪个 Agent 在做,改动都来自项目电脑。被拒的会写最近一次拒的是哪个文件、为什么。
- 它碰不到的:
.env这类密钥文件、.git、工作区外面的文件;开发版命令、部署;数据库文件。要查本地数据库,先在项目设置 ›「数据源」登记(目前只支持 SQLite),它只能按名字发只读查询,查询在项目电脑上跑,只回结果,取多少有上限;任务详情里能看到这个任务在各数据源上用了多少。数据源只有你能登记、改、删。 - 检查:项目设置 ›「检查」里加要跑的检查(比如
pnpm test),批过才能跑,命令改了要重批。默认另一台的 Agent 自己跑不了,它改完会说要跑哪项,由你在任务详情里点「跑检查」;在规矩里打开以后,它能在隔离环境里自己跑批过的检查,看到失败自己修,隔离里只放这次任务能碰的文件,本地数据库默认不放。 - 两台都要更新到 0.4.28 或更新的版本。
电脑之间怎么连
- 能直连就直连(同一个局域网,或者不在一个局域网但打通了);打不通才经中继转。中继是一台帮两台电脑传话的服务器。「电脑」页那台的「⋯ → 关于这台的 QU」里写着现在是直连还是经中继、延迟多少。
- 直连和中继都是端到端加密的,中继只转加密后的内容,看不到你的代码和对话。
- 默认用 QU 自己的中继 QU Studio Relay。想全程用自己的服务器,见 自建中继。
- QU Studio 不改你的路由器、防火墙、代理设置。macOS 弹出防火墙提示时由你自己决定。
离线、休眠时会怎样
- 项目设置里打开「每一轮推到任务分支」后,每一轮做完会把已有的提交推到这个任务的分支(不替你提交,不合进主线)。第一次要推时会问你一声。
- 那台 10 分钟内回来,原地接着做;24 小时内回来,自动从中断的那一轮开头重做,最多 3 次。
- 推分支没推上去时会写清原因(比如要登录、没有远端)和下一步怎么办,能点「现在再推」。
- 等不及可以「换台电脑重跑」:换到一台在线的电脑,从分支拉下来,从中断的那一轮开头重做;会先看那台装了哪些 Agent。没允许推分支、分支没推上去过、没接任务的会话,只能等它回来。
- 固定在某台上的任务(比如要用那台连着的测试手机)不换电脑,会等它回来。
- 主力机关着、睡着时,小去和看板也停,别的电脑上的会话照常跑。
- 有会话在跑时,QU 不让电脑闲着自己睡着(合上盖子、手动睡眠照常)。在「设置 › 通用」里能关。
换主力机、搬项目、移除
- 换主力机:「电脑」页要换去的那台「⋯ → 设成主力机」,小去和看板、记忆、项目列表整份搬到那台;各项目的会话还在原来的电脑上。两台都在线时才能换。搬到一半断了,看板先只读,那台连上以后接着搬,也能放弃这次。
- 项目换电脑:项目「⋯ → 换电脑…」,填那台上的代码仓目录,换之前会先到那台上核对这个目录。以后新会话开在新电脑上,原来的会话留在原处。还有在跑的任务时换不了。
- 移除电脑:「电脑」页那台的「⋯ → 移除这台电脑」,要在主力机上做,上面还有项目的先搬走。移除后马上断开,它变回单独的一台;要再连得重新配对。
连不上怎么办
「电脑」页里连不上的那台会分三段写清断在哪:
| 断在 | 多半是 | 怎么办 |
|---|---|---|
| 这台连中继 | 网络断了,或者代理、VPN 把它挡住了 | 检查网络;开着 VPN 或代理的话先关掉试试,或者在设置里换一个中继 |
| 中继找那台 | 那台关机、睡着了,或者没开 QU Studio | 去那台看看,QU Studio 在不在菜单栏 |
| 和那台握手 | 这台被它移除了,或者它重装过、密钥换了 | 在主力机上重新「连接其他电脑」,再配对一次 |
点「复制诊断信息」能把这些复制下来,反馈问题时附上。
别的电脑读不懂这台发过去的东西时(多半是两台的 QU 版本不一样),会写出那台的版本;把两台都更新到最新版就好。
远程终端
在这台电脑上打开别的电脑上的终端,也能在终端里接手别的电脑上的会话。只有配对过的电脑能开,手机、平板不能。
在被打开的那台上打开开关:默认关。到要被打开的那台的「设置 › 电脑」,打开「允许别的电脑打开这台的终端」。关着时,别的电脑只能看那台上的会话,开不了它的终端。要开哪台的终端,就到哪台上打开这一项;关掉的那一刻,开着的远程终端全部断开。
怎么开:别的电脑上的会话下面开终端(⌃`),就开在会话所在的那台上,终端右上角标「远程」。会话头部「⋯ → 在终端里接手」也一样能用。
第一次要在那台上点「允许」:
- 这台上点「请求(那台)允许」;
- 那台的 QU 里弹出确认,在那台上点「允许」(只能在那台上点,别的电脑替不了);
- 允许一次,以后同一个人从这台电脑再开就不用问了。
那台点了「不允许」,这台就开不了;改主意的话,到那台的「设置 › 电脑」里允许,或者从这台再请求一次。
命令记录:记在被打开的那台,「电脑」页最下面的「远程终端记录」(有记录才出现,点开展开),谁、从哪台、开在哪个会话、开了多久、大致敲了什么,保留 30 天。
- 记的是按键还原的大致命令:上箭头翻出来的、Tab 补全的可能和真实的不一样;
- 粘贴的整块只记「粘贴了 N 行」;
- 密码不记:关了回显时(输密码)整行不记,vim 这类全屏程序里的输入也不记;
- 像密钥的内容打码。
撤销:在那台的「电脑」页,那台卡上「⋯ → 允许远程开终端」写着允许过哪几台,点一下就撤销。撤销马上断开,正在跑的命令跟着停,没跑完的不会接着跑;要再开,得在那台上重新允许。
那台连不上(离线、睡着了)时开不了它的终端,等它连上再试;会话里的进度照常能看。
常见问题
合上笔记本,活还跑吗? 合盖电脑会睡,睡着时这台上的会话暂停,醒了接着做。想合盖也一直跑,把活派到一台一直开着的电脑上(比如家里的 Mac mini)。
两台登同一个 Claude 账号,额度算两份吗? 不算。同一个账号的额度只算一份,用量页里合起来看。
代码会不会在电脑之间乱传? 不会。各台的代码以远端仓库为准,在哪台干就在哪台合。项目只留在一台、让另一台的 Agent 来改时,读写都由项目那台按任务授权去做,.env 这类密钥文件它碰不到。
中继能看到我的代码吗? 看不到。直连和中继都是端到端加密的,中继只转加密后的内容。