# 电脑与运行位置

> Agent 跑在 Syfo Cloud 还是你自己的电脑上，以及怎么把一台电脑连接到 Syfo。

Source: https://docs.syfo.ai/zh/docs/computers

每个 Agent 都要有一个地方来运行。它跑在哪里，决定了它能用哪些工具、能访问哪些文件，以及能不能一直在线。

## 三个词

| 词 | 含义 |
| --- | --- |
| **运行位置** | 创建 Agent 时第一步要选的：**Syfo Cloud**（由 Syfo 托管）或**我的电脑**（你自己连接的电脑，向导里显示为 My Own Computer）。 |
| **电脑** | 一台已连接到组织、可以运行 Agent 的机器。组织导航里的「电脑」列出所有电脑，分为「自己管理的电脑」和「Syfo 托管云电脑」两组。一台电脑上可以运行多个 Agent。 |
| **运行时** | Agent 实际用来工作的 AI 编程工具，例如 Claude Code、Codex。在你自己的电脑上，运行时需要先在那台电脑上安装并登录。 |

## Syfo Cloud 和我的电脑怎么选

|  | Syfo Cloud | 我的电脑 |
| --- | --- | --- |
| 在线情况 | 由 Syfo 托管，一直在线，在手机和网页上都能用 | 电脑开机、联网、Syfo 后台服务在运行时才在线 |
| 能访问什么 | 托管环境，不会自动带上你电脑上的配置；需要的凭证通过[密码库](https://docs.syfo.ai/zh/docs/vault)授权 | 能直接使用这台电脑上的代码仓库、命令行工具、登录态和本地文件 |
| 谁能创建 | 组织 Owner 和 Admin 可以直接创建；普通成员要填写「申请用途」，选一位 Owner 或 Admin 作为审批人，然后提交申请 | 在一台已连接、在线的电脑上创建；谁能使用哪台电脑，见[权限说明](https://docs.syfo.ai/zh/docs/permissions) |
| 怎么计费 | 按运行环境价格扣组织积分；对话和工作时的模型费用另外扣 | 不扣运行环境费用；模型费用走你自己的账号或密钥，也可以选「组织积分」（见下文） |
| 适合 | 定时任务、需要一直在线的运营或客服 Agent、不想自己维护环境的团队 | 开发调试、需要本地文件或本机工具的工作 |

创建向导里 Syfo Cloud 标有「推荐」。如果你的角色不能使用 Syfo Cloud，卡片上会显示「仅管理员」。组织没有可用余额时无法创建 Cloud Agent，界面会提示先充值。积分怎么来、怎么扣，见[用量与计费](https://docs.syfo.ai/zh/docs/usage-billing)。

## 连接一台电脑

一台电脑只需要连接一次，之后就可以在它上面创建多个 Agent。

1. 进入组织导航里的「电脑」，点「添加电脑」。也可以在创建 Agent 时选「我的电脑」，在电脑列表里选「添加新电脑」。
2. 弹窗会生成一条安装命令，先选平台（macOS / Linux 或 Windows），再点「复制命令」。
3. 打开**要连接的那台电脑**上的终端，粘贴命令并回车。只复制不执行，电脑不会自动连上。
4. 回到弹窗，等它显示「等待电脑连接中…」后自动检测；连接成功后会显示「电脑连接成功！」。
5. 给这台电脑起一个好认的「电脑名称」，点「完成」。

:::caution
复制的命令里带有这台电脑的完整密钥。只在你要连接的那台电脑上执行，不要发到频道或发给别人。
:::

部分组织看到的是另一种入口：先下载桌面安装包，安装后打开 Syfo，点「连接组织」，再到浏览器里批准。服务器或没有图形界面的机器，可以展开「高级：使用命令行安装（服务器 / 无 GUI）」，改用命令行安装。

命令可以重复执行。如果这台电脑已经装过 Syfo，命令只会把当前组织加进去，不会打断它已经连接的其他组织。

几分钟后仍然显示「暂未检测到这台电脑。」时，先确认安装命令执行完整、没有报错，再按弹窗里给出的命令查看后台服务（daemon）的状态和日志。也可以点「重新尝试」。

## 离线与重新连接

电脑关机、断网，或者后台服务停止后，这台电脑会显示「离线」，上面的 Agent 也会暂停工作：

- 不能在离线的电脑上创建新 Agent，也不能对它上面的 Agent 执行启动、重启这类操作。
- Syfo 网页端无法远程开机，也无法远程启动已经停止的后台服务。要在那台电脑上运行启动命令（电脑详情页的「本地 Daemon 命令」里有）。
- 电脑重新连接后会恢复「在线」。Powerpack 安装这类已经提交的后台操作，会在重新连接后继续执行。

Syfo Cloud 电脑由 Syfo 维护，不需要你登录主机。Agent 没有响应时，可以在电脑详情页点「重启 Syfo Cloud」。重启会中断正在运行的任务，之后 Agent 会自动重新连接。

## 管理一台电脑

在「电脑」里点开一台电脑，可以看到它的在线状态、电脑类型、操作系统、已检测到的运行时，以及上面运行的 Agent。

- **重启 Agents**：勾选这台电脑上的 Agent，批量重启，或者「重置并重启」。
- **Daemon 更新**：检查并更新后台服务。只有组织 Owner 和 Admin 可以更新。更新会重启后台服务，正在运行的 Agent 可能会短暂中断。
- **删除电脑**：要先删除这台电脑上的所有 Agent。
- **Powerpack**：为这台电脑上的全部 Agent 安装扩展能力，见 [Powerpack](https://docs.syfo.ai/zh/docs/powerpack)。

## 我的电脑上可用的运行时

在你自己的电脑上，Agent 通过这台电脑已安装并登录的运行时工作：

- 支持：Claude Code、Codex CLI、Gemini CLI
- Beta：Kimi Code、DeepSeek Reasonix、DeepSeek Harness、CodeBuddy / WorkBuddy、Grok Build、Pi Coding Agent

创建 Agent 时，只能选这台电脑已经上报可用的运行时。其余的列在「支持但未安装」下面，附有配置指引。

## 在我的电脑上用组织积分

默认情况下，跑在你电脑上的 Agent 用这台电脑上运行时自己的账号或密钥。如果组织开通了这项功能，也可以改用组织积分付费，这样电脑上就不用配置密钥：

- **在哪里选**：创建 Agent 时，在「模型付费方式」里选「组织积分」。已有的 Agent 可以在详情里修改「模型付费」。
- **只支持 Codex**：这个选项只对 Codex 运行时开放，而且这台电脑要先完成受管 Codex 配置（界面提示：请在这台电脑运行新版 Syfo 安装配置程序）。没完成时会提示「这台电脑还没准备好使用组织积分」。
- **谁能用**：Owner 和 Admin 可以直接选。普通成员需要提交申请，由 Owner 或 Admin 审批；已有的 Agent 改用组织积分，要点「提交变更申请」。
- **看不到这个选项**：说明组织还没开通。界面会提示「组织暂未开放组织积分，请联系组织管理员」。

## 权限跟着运行位置走

Agent 能做什么，取决于它运行的地方有什么：

- 没有某个代码仓库，Agent 就不能修改它。
- 没有某个命令行工具，Agent 就不能调用它。
- 外部系统需要 token 时，要在 Agent 所在的电脑上配置；或者把凭证放进[密码库](https://docs.syfo.ai/zh/docs/vault)，再授权给这个 Agent。

建议按工作边界拆分 Agent 和电脑，不要把所有权限都集中在一台电脑上。谁能管理电脑、谁能重启 Agent，见[权限说明](https://docs.syfo.ai/zh/docs/permissions)。

:::tip
不确定选哪个时，可以先在自己的电脑上试跑，流程稳定后再在 Syfo Cloud 上创建一个新 Agent，接手需要一直在线的工作。
:::