项目协作

多电脑协同与邀请分享

连接自己的其他电脑,或通过邀请参与同组织成员的 Code 工作,管理执行位置与分享权限。

需要跨电脑工作或分享 Code 环境的桌面端用户约 9 分钟阅读
操作入口
左侧「协同」;执行电脑 → 设置 → 远程控制
完成结果
在明确的执行电脑和会话中完成任务,能识别连接状态、管理邀请并撤销分享。
本篇目录

1. 确认两端与权限已经就绪

协同是桌面端左侧的独立入口。本机开发继续使用「Code / 智能编码」;进入「协同」后选择另一台电脑,文件、会话和任务操作会送到所选电脑执行。先请管理员确认当前账号所属租户已开通协同模块,并让两端使用支持协同的客户端。邀请分享还需要配套服务端支持。

  1. 同账号使用时,在两台电脑登录同一码哥账号,并核对服务器、品牌和组织归属。
  2. 在执行电脑打开「设置 → 远程控制」,开启「允许远程控制本机」。
  3. 查看实际状态,等待「已连接协同服务」,再到控制电脑点击「查找其他电脑」或「刷新电脑列表」。
  4. 保持执行电脑在线。系统支持时可开启「远程会话期间保持唤醒」;此开关只防止空闲休眠,合上笔记本盖子仍可能休眠。

2. 选择执行电脑并继续 Code 任务

协同沿用执行电脑的文件、工具与运行环境,不会把任务在控制电脑重新执行。模型同步针对同一远程 Code 会话,不会把所有电脑的独立会话或智能对话统一改为同一个模型。

  1. 进入左侧「协同」,打开「选择执行电脑」,核对电脑名称、所有者和状态,选择可连接的目标。
  2. 在目标电脑的项目列表中打开工作区和会话,核对实际目录。先请求读取一个已知文件,确认内容来自目标电脑。
  3. 在该会话发送任务,查看思考、工具审批、命令进度和结果;停止操作前再次核对目标电脑与会话。
  4. 同一远程 Code 会话切换模型后,两端会同步该会话的模型选择。等待保存与同步完成,再继续发送任务;已经运行的任务保留启动时的模型配置,新的选择影响后续任务。
  5. 切换电脑、会话或返回本机 Code 后,原任务继续在原执行电脑运行;需要跟进时返回原电脑和会话。

3. 分享自己的 Code 环境

邀请仅限同一品牌、同一组织中的另一位用户,每个邀请码限一个账号接受。分享范围是整台电脑的 Code 控制权限:对方可读取和修改全部 Code 工作区文件与会话,运行任务、Git、终端及工具。操作使用所有者的账号、凭据、执行环境,模型费用可能由所有者承担。

  1. 在协同入口点击「分享协同」,选择自己的可分享电脑。电脑需在线、远程访问已连接,并已上报分享能力。
  2. 选择有效期:1 小时、24 小时、3 天或 7 天。阅读权限说明,勾选确认后点击「生成邀请」。
  3. 复制邀请码交给指定协同人;关闭弹窗后不会再次展示原邀请码。
  4. 接收方登录对应品牌与组织,点击「加入协同」,粘贴邀请码并选择「接受协同邀请」。
  5. 加入成功后,在电脑列表选择标为「他人分享」的电脑,核对所有者再开始任务。

4. 管理分享与电脑名称

取消或到期会阻止后续访问及受邀方的终端输入,但不等于自动停止已经发出的任务或结束已启动的 shell。需要终止执行时,由所有者核对原电脑上的任务和终端,再执行相应停止操作。

  1. 点击「管理分享」,分别查看「我分享的」与「他人分享给我」,核对电脑、用户、有效期及等待接受、协同中、已过期或已取消状态。
  2. 所有者选择「取消协同」,接收方选择「退出协同」,阅读确认内容后完成操作。取消后权限立即失效,对方后续操作与实时连接会被拒绝。
  3. 需要修改自己的其他电脑显示名称时,在电脑列表点击该电脑旁的重命名按钮,填写名称并保存;此入口仅支持自己的非本机远程电脑。
  4. 名称为空、含换行或超过 40 个字符时按提示修改;他人分享的电脑不能由接收方重命名。

5. 查看功能限制并排查连接

远程 Code 的文件传输、交互式终端、MCP 配置、浏览器预览等以执行电脑实际上报能力为准。协同不提供通用操作系统桌面控制,也不意味着 IDE 插件、智能对话或其他应用的历史会话自动迁移到云端。

5. 查看功能限制并排查连接参考表
现象处理方式
没有协同入口确认租户模块权限、品牌开放范围与客户端版本;本机 Code 权限和协同权限分别控制。
已开启,尚未连接到执行电脑刷新状态或重试连接,检查登录与网络;服务连接错误由管理员核对协同服务及 WebSocket 转发。
离线、需要升级或连接中让目标电脑上线、更新客户端,或等待能力上报后刷新。离线电脑不能实时读取或执行新操作。
部分功能可用展开「查看此电脑的功能限制」,按具体原因处理,不支持的操作不会转到本机执行。
邀请失败或已过期核对品牌和组织、邀请码、有效期与是否已被其他账号接受,必要时由所有者重新生成。
远端已结束,当前仍在同步恢复连接后核对原会话状态与结果,记录两端版本、时间及错误;不要依据暂时的显示延迟反复提交。