关于 AI 编程 Agent 的讨论,最后都会碰到同一个实际问题,而且通常来得比该来的更晚:代码到底在哪里跑?不是哪个模型,而是哪台机器拿着你的仓库、凭据、缓存,以及 Agent 正在往里打字的那个 shell。
HiFox 把这个答案做成一个一等概念,叫电脑。电脑为 Agent 的工作提供执行主机。它可以是一台本地电脑、一台远程服务器、一个容器,或一台支持的云主机。你的笔记本算。机柜里的 Linux 也算。主机由你选、由你控制。HiFox 把工作协调到它上面,而不是把代码跑在一个你看不见的地方。
HiFox 不替代 Claude Code、Codex 或其他执行工具。它在团队已经在用的工具外面,加上共享任务、电脑、上下文、控制和审查。那些工具仍然装在你们的机器上。模型用量继续走它们里面配置的订阅或 API Key。
先说结论
电脑是 HiFox 里 Agent 工作的执行主机:一台你控制的本地电脑、远程服务器、容器或支持的云主机。一个小的本地服务把电脑连到 HiFox,识别可用的运行时(装在那里的具体 Agent 工具,例如 Claude Code 或 Codex),接收排队的运行,准备任务目录,启动选定的运行时,并把进度流回任务。个人机器用 HiFox 桌面端连接。远程主机用 HiFox CLI 和一次性安装令牌。模型用量走工具里已经配置的订阅和 API Key。并发上限决定一台主机能扛多少并行工作。
电脑是什么,不是什么
HiFox 把执行拆成四个角色,每个正好做一件事:
- Agent 定义工作应该怎么处理:指令、技能、仓库、运行设置。
- 电脑提供主机和本地资源:操作系统、文件、凭据、网络、工具。
- 运行时执行真正的 Agent 会话:这台电脑上识别到的编程工具。
- 任务仍然是共享记录:目标、讨论、执行状态、轨迹、结果。
这个拆分解释了后面的大部分事情。Agent 不是执行主机。同一份 Agent 配置,可以在不同时间指向不同的电脑。电脑不是 Agent。它装着一个或多个运行时,工作派到它身上之前什么都不做。一台电脑可以同时服务多个 Agent,上限是它的并发。

这也解释了这套做法的立场。托管平台把模型、运行器和基础设施捆成一个产品,意味着代码在你不运营的基础设施上执行。HiFox 站在另一边:执行主机是你的,它加在上面的是指派、排队和审查。如果这个模型你还生疏,「HiFox 是什么」那篇讲的是全貌。那篇中文还没发布,这里先不放链接。
本地服务:真正干活的那一块
每台电脑由一个小的本地服务连到 HiFox。它注册电脑、识别已安装的运行时、发送心跳、接收排队的运行、准备任务目录、启动选定的 Agent 工具,并把进度和结果报回去。
有一个设计细节,运维上的分量很重:本地服务主动向服务器发起连接,所以典型安装不需要入站端口。家里路由器后面的笔记本、公司防火墙后面的工作站、私有子网里的服务器,因此都可以同样成为电脑。
心跳是 HiFox 知道电脑还活着的方式:服务器收得到就是在线,停了就是离线。能省下排查时间的边界是:在线只说明心跳到了。它不说明选定的运行时就能执行任务。
运行时:这台电脑实际上能跑什么
运行时是一台电脑上识别到的、受支持的 Agent 执行能力。本地服务扫描受支持的 Agent 工具,并把每一个可用的报上来。所以一台装了 Claude Code 和 Codex 的电脑,会把两者都暴露成 Agent 可以选的运行时。
电脑详情页会给每个运行时一个能力状态:
- 可用:运行时已连接,可以执行 Agent 的工作。
- 需要配置:工具被识别到了,但缺必要配置。
- 未安装:本地服务看不到这个工具。装上它,或另选一个运行时。
- 不支持:运行时或环境在支持的能力集合之外。
安装按设计仍然是你的责任。你用和平时直接使用一样的方式安装并登录每个工具。电脑详情页会链到官方安装说明,重新扫描可以确认本地服务看得见它。如果你依赖的能力没有被识别到,可以加一个自定义 ACP 运行时,填名称和启动命令,再测试连接。
由此有两个后果。自带订阅是字面意思:模型额度取决于团队接上的 AI 编程工具、方案和 API 账号。额度错误指向工具里配置的账号,不是 HiFox 的某项设置。模型选择也留在工具那边:Agent 跟随运行时的默认模型。Agent 怎么配置,是另一篇的内容。那篇中文还没发布,这里先不放链接。
连接第一台电脑
第一台电脑通常就是你正坐着的这台。打开设置,进入电脑,选择连接电脑,按操作系统选安装路径。个人电脑的推荐路径是安装 HiFox 桌面端。它带上本地服务,并带你走完注册。入门那篇大约十分钟走完这一段。那篇中文还没发布,这里先不放链接。
连上之后,确认至少有一个运行时显示为可用。这是人们会跳过的检查点:一台已连接、但没有可用运行时的电脑,不能执行 Agent 的工作。
笔记本上有两项只有桌面端才有的设置要紧。防止休眠让机器保持醒着,长任务不会被打断。合盖继续运行是 macOS 上单独的一项。两者都只出现在本机上,不会出现在远程电脑上。
加上一台远程服务器
笔记本是很好的第一台电脑,却是很差的永久电脑。它会睡、会出门,还会和你的 IDE 抢内存。自然的第二步,是一台一直开着的远程主机。直接在上面安装 HiFox CLI 和本地服务:
curl -fsSL https://file-assets.hifox.com/download/install.sh | bash
hifox version然后在电脑页面生成一次性安装令牌,在目标主机上运行它给你的注册命令:
hifox computer register --install-token hit_...注册会把这台电脑记到你的组织里,启动本地服务,并开始识别运行时。安装令牌 30 分钟后过期,而且只用一次。文档把卫生规则写得很直:不要把它放进可复用的镜像、脚本、任务或评论。
凭据在这里是故意分开的。个人访问令牌不能注册电脑。安装令牌也不能建立人的 CLI 登录。前缀 hfx_ 的个人访问令牌,用来认证 hifox task list 这类资源命令。前缀 hit_ 的安装令牌,用来建立本地服务使用的会话。更完整的命令面是 CLI 和 API 那篇。那篇中文还没发布,这里先不放链接。
注册之后,同一套 CLI 也是你的诊断包:hifox computer status 和 hifox computer logs 读主机上的本地状态。hifox computer list、show、usage 和 ping 可以从任何地方查看已注册的电脑。远程主机需要和笔记本一样的东西:Agent 工具已安装并登录,私有仓库有 Git 访问。
本地、远程,还是容器:一次诚实的比较
没有唯一正确的主机。文档把它们都当成电脑。取舍就是普通的基础设施取舍。
| 主机 | 适合 | 长处 | 要注意 |
|---|---|---|---|
| 本地电脑(HiFox 桌面端) | 第一次安装、一个人干活、要复用已有检出和缓存的指定目录运行 | 没有额外基础设施;就是你的环境和凭据;指定工作目录只在本地电脑上可用 | 休眠和关机打断可用性;运行会和你自己的工作抢 CPU 和内存 |
| 远程服务器(CLI + 本地服务) | 团队负载、一直在线的容量、更高并发 | 保持在线;把 Agent 负载和任何人的笔记本隔开;一台主机可以服务多个 Agent | 运行时和 Git 访问要自己安装并登录;容量规划在你这边 |
| 容器或支持的云主机 | 可复现、用完即弃的执行环境 | 环境干净、可以重建;注册流程同样用安装令牌 | 一次性令牌必须每次注册单独生成,不能烤进可复用镜像 |
最要紧的一对决定是:想让 Agent 在你已经信任的环境里工作,用本地电脑;想让笔记本合上之后任务还在流,用远程的。很多团队最后两样都有,因为把工作改派到另一台主机是配置变化,不是工作流变化。
一次运行里发生什么
派给 Agent 的任务变为可以开工时,HiFox 会把一次运行排进队列,并派到选定的电脑。运行时启动之前,本地服务可能要等并发容量、准备目录、拉取仓库,并投射允许的环境变量。
目录准备走两种模式之一。临时目录模式下,每条任务有自己的隔离目录,带仓库的运行可以从缓存的仓库数据准备一份新的 Git worktree。大多数仓库工作,以及多条任务可能同时改同一套代码时,用它。多个 Agent 并行为什么不会互相覆盖,是另一篇的内容。那篇中文还没发布,这里先不放链接。指定目录模式下,运行复用本地电脑上一个已配置的绝对目录,连同里面已有的依赖和缓存。一个指定目录一次只服务一次运行。
运行时工作的时候,进度会流回来。运行状态经过排队、已派出、等待本地目录、运行中,然后是已完成、失败或已取消。轨迹事件、工具调用和最终回复都回到任务上。电脑是执行实际发生的地方。任务是接受发生的地方。
并发:一台电脑该扛多少
每台电脑有任务并发上限,每个 Agent 也有自己的并行运行任务上限。默认故意保守:使用临时目录的 Agent,默认是电脑上限的 50%。使用指定目录的,默认是已配置的目录数。手动把值调到这个数量以上,产品会警告写入可能碰撞。相信这个警告。
文档的指导就是该跟着走的那条:更高的并发会吃掉更多 CPU、内存、磁盘、供应商容量和仓库带宽。所以只有当前设置已经能稳定处理现有负载之后,再往上加。供应商容量是人们会忘的天花板:同一个模型账号上的十次并行,会把速率限制快十倍用完。怎么并行跑多个 Claude Code,那篇中文还没发布,这里先不放链接。
一个在线的 Agent 仍然可能有排队的工作,只是因为并发或目录容量满了。排队是健康状态,不是卡住。
共享、所有权,以及让主机保持干净
一旦电脑开始承担团队职责,有三项控制要紧。可见性决定谁能看见和使用它:个人、组织或空间。所有权是分开的:所有者可以转移这台电脑,而且只有所有者能删除它。对一台本地的个人电脑,所有者控制哪些组织可以使用它。所以加入一个新组织,不会悄悄把你的笔记本志愿出去。
Agent 的运行会留下工作目录、缓存和产物,所以清理是内建的。默认大约 7 天之后,已完成或已取消的运行才有资格被清理。它可以执行最低剩余空间阈值。它从不碰正在运行或排队的工作、被钉住的运行,以及仍在调查中的失败运行。想马上看一眼,hifox daemon disk-usage 报告用量,hifox daemon cleanup 预览会回收什么。
从你已有的机器开始
电脑这个概念回答的,是托管平台宁愿你别问的问题:Agent 在谁的基础设施上?这里的答案是你的,从一台笔记本到一支共享服务器。第一天不需要那支舰队。接上一台电脑,确认一个运行时显示为可用,创建一个 Agent,派给它一件无聊的事。笔记本的极限露出来时,再在旁边注册一台服务器。每一项设置的更深说明在 电脑文档里。
常见问题
HiFox 里的电脑是什么?
电脑是 Agent 工作的执行主机:一台已连接的设备、服务器或容器,提供 Agent 需要的操作系统、文件、凭据、网络和工具。一个小的本地服务把它连到 HiFox,识别运行时,接收运行,并把进度流回任务。
HiFox 会在它自己的云上跑我的代码吗?
不会。Agent 的工作在你连接的电脑上执行,那些是你控制的机器。HiFox 围绕这些主机协调指派、排队、进度和审查。模型用量也仍然是你的:它走每台电脑上已安装编程工具里配置的订阅或 API Key。
怎么把远程服务器连成电脑?
在主机上安装 HiFox CLI,从电脑页面生成一次性安装令牌,然后在那台机器上运行 hifox computer register --install-token hit_...。令牌 30 分钟过期,而且只用一次,所以不要烤进镜像或脚本。然后安装并登录你要用的 Agent 工具,确认每个运行时显示为可用。
为什么电脑显示在线,运行却不开始?
在线只说明本地服务在发心跳,不说明选定的运行时就能执行工作。打开电脑详情,看运行时的能力状态:需要配置和未安装都会挡住运行。hifox computer ping 用来确认某个具体运行时是否能完成一次往返。



