十分钟教你使用 HiFox：连接电脑，创建 Agent，派第一条任务

开始用 HiFox 大约需要十分钟：接上一台电脑，创建一个 Agent，派一条小任务。HiFox 是给人和 Agent 用的工作管理系统。它把 Claude Code 和 Codex 这类 AI 编程工具，变成共享任务系统里可以指派的同事，让执行不再消失进私人终端。第一次完整运行是这样：

• 登录，并创建或加入一个有一个活动空间的组织。
• 通过 HiFox 桌面端或 HiFox CLI 连接一台电脑。
• 确认至少有一个运行时显示为可用，例如 Claude Code。
• 用一个窄角色和清楚的指令创建一个 Agent。
• 写一条小的、范围清楚的任务，派给这个 Agent。
• 在任务上审查结果，并用一条后续评论回复。

这篇指南按顺序走每一步，解释背后的四个概念，并说明第一次运行结束时要检查什么。到最后，你会有一条可以长成并行运行、共享技能和迭代的工作循环。

为什么和 HiFox 的前十分钟要紧

多数团队已经在用 AI 编程 Agent。问题是这些工作发生在哪里：在一个人的终端里，别人看不见。有人把一张 Jira 工单贴进聊天窗口，跑一个 Agent，再把 diff 贴回去。变更背后的推理哪里都不住。乘上五个开发者和三种不同的 Agent 工具，你得到结果，却没有记录。

HiFox 从团队这一侧处理这件事。它不是另一个编程 Agent。官方对边界说得很直：HiFox 不替代 Claude Code、Codex 或其他执行工具。它在团队已经在用的工具外面，加上共享任务、上下文、控制和审查。那些工具负责执行。HiFox 管理指派、连接的电脑、任务上下文、进度、阻塞、结果，以及跨它们的人的审查。

所以前十分钟被安排成现在这样。你不是在安装一个新的 AI。你是在把已经有的 AI 接到一套共享的记录系统上，让每次运行的上下文、进度、阻塞、结果和人的审查，从请求到发布都看得见。如果想先看更宽的定位，读「HiFox 是什么」再回来。那篇中文还没发布，这里先不放链接。这篇指南保持动手。

每套 HiFox 设置背后的四个概念

四个名词承载整个模型。把它们弄直，后面就不会混。

任务是 HiFox 里的主要工作单位。它记录目标和描述、状态、优先级、标签、负责人、被指派来执行的 Agent 或小队、评论、附件，以及完整的执行状态和轨迹。

Agent 是一份保存下来的工作配置，不是一句用过即弃的提示词。一个人仔细的设置（指令、绑定的仓库、环境、超时）在 Agent 被共享之后，可以在空间里反复使用。

电脑提供执行主机。一个小的本地服务把它连到 HiFox，识别已安装的 Agent 工具，接收工作，准备任务目录，启动选定的运行时，并把进度流回来。本地服务向外发起连接，所以典型安装不需要入站端口。

这个关注点分离就是设计：Agent 定义工作应该怎么处理，电脑提供主机和本地资源，运行时执行会话，任务仍然是团队的共享记录。你的代码和凭据留在你控制的机器上。

开始之前需要什么

前提清单很短：

• 一个 HiFox 账号和一个组织；
• 至少一个活动空间；
• 一台能跑 HiFox 桌面端或本地服务的电脑；
• 这台机器上已安装并登录的 Claude Code、Codex 或 Gemini CLI；
• 如果第一条任务要碰私有仓库，这台机器上要有 Git 访问。

模型这边有两句。第一，自带订阅：模型用量继续走这些工具里配置的订阅或 API Key，额度取决于团队接上的方案和账号。第二，Agent 跟随运行时的默认模型。它不提供模型选择器。你在运行时自己的配置里换模型，不在 Agent 上换。

没有连接电脑，你仍然可以组织任务。但是 Agent 在一个合格的运行时在线之前，不能执行工作。所以连接一台是第一步，是有原因的。

如果组织还没有活动空间，HiFox 会带你创建一个。选一个工作类别，用来种下合理的任务类型：软件开发从需求、缺陷、任务和用户故事开始。第一个空间默认对组织公开，以后可以收紧访问。

第 1 步：连接一台电脑

打开设置，然后是电脑，选择连接电脑。两条路径覆盖几乎所有人：

• 支持的个人电脑用 HiFox 桌面端。装上，登录，它会替你注册这台机器并启动本地服务。
• 远程主机或 Linux 用 HiFox CLI 加本地服务。在连接对话框里生成一次性安装令牌，然后在目标机器上运行生成的命令：

hifox computer register --install-token hit_9f2ka7x1mrq8

安装令牌是短命的，而且只用一次。不要把它放进可复用的镜像、脚本、任务或评论。它也只有一件窄工作：安装令牌注册电脑，不建立人的 CLI 登录。个人访问令牌（以 hfx_ 开头）单独处理那件事。

等到电脑显示已连接，再看它的详情页。每个被识别的运行时会报告能力状态：可用、需要配置、未安装或不支持。这个区分能省掉最常见的早期困惑。电脑在线只说明本地服务在发心跳。它不说明你选定的运行时就能执行任务。如果后来运行不开始，先查运行时的能力状态，再去排查连接。

也可以从终端验证：

hifox computer list
hifox computer show cmp_4c81d2
hifox computer ping cmp_4c81d2 rt_claude_code

诊断、自定义运行时、可见性和清理设置，写在 电脑文档里。

第 2 步：创建第一个 Agent

打开 Agent，选择新建 Agent。忍住不要做一个什么都能干的助手。从一个窄角色开始。聚焦的描述告诉人该派什么。指令告诉 Agent 怎么工作。

一份好的第一次配置像这样：

• 名称：代码阅读者
• 描述：阅读仓库，解释当前实现，报告风险，不改文件。
• 可见性：个人，或这个 Agent 将被使用的空间
• 电脑和运行时：你在第 1 步验证过的那条连接

指令可以几乎原样用快速开始里的例子：

行动前读完整条任务和相关评论。范围停在请求之内。第一条任务不要改文件。报告你检查了什么、每个结论的证据，以及仍然不确定的地方。

注意指令覆盖了什么：范围、行动前怎么检查、汇报格式。这个高度是对的。稳定行为放进 Agent 指令。只属于这条任务的要求放进任务描述。几个 Agent 共享的可复用步骤放进技能。把这三层分开，Agent 才能复用，而不是变脆。技能那篇中文还没发布，这里先不放链接。

第 3 步：加上仓库或工作目录

如果 Agent 要读代码，它需要有代码可读。两个选择：

• 把 Git 仓库绑到 Agent（或依靠这条任务所在空间配置的仓库）。带仓库的运行可以为每条任务准备一份新的 git worktree。这就是以后安全并行的原因。
• 在本地电脑上配置一个指定的本地目录。运行复用已经在那里的代码、依赖、缓存和工具，而不是准备一份新副本。

决定规则：大多数仓库工作，以及几条任务可能同时改同一套代码时，用临时的、带 worktree 的目录。当一次运行需要一个重建很贵的环境时，用指定目录，并记住一个指定目录一次只服务一次运行。worktree 怎么让并行 Agent 不踩到彼此，有一篇完整说明：用 git worktree 跑 AI 编程 Agent。

第 4 步：写一条 Agent 能执行的任务

在同一个空间里创建一条任务。快速开始的例子故意无聊，这就是重点：

标题：审查认证错误路径

描述：阅读当前的认证实现，找出三个用户能看见的失败情况。不要改文件。每个情况都引用相关文件或组件，并说明预期行为。最后写下实现之前必须回答的问题。

这条任务有每条好的第一条任务都需要的三个性质。它有清楚的边界（读，不改）。它产出可审查的结果（三个带证据的情况）。而且风险低，所以你可以评估 Agent 的判断，而不拿代码库冒险。如果仓库里没有认证代码，把题目换成任何存在的小区域，例如配置加载或空状态组件。

用这种方式派工作，感觉和提示不一样，也应该不一样。提示词是一段对话。任务是一份有可审查结果的约定。这条循环走通之后，同样的形状可以放大到真工单。把 Jira 工单派给 Agent 的那篇是生产版本。那篇中文还没发布，这里先不放链接。

第 5 步：派任务，并看着运行

打开任务的处理人，选择你的 Agent。人、Agent 和小队都可以是处理人。选中一个 Agent，就让它成为执行处理人。

有一条状态规则决定执行何时开始。派给 Agent 的任务如果还在待办里，不会开始运行。待办是准备工作的停车场。把任务移到可以开工的状态（未开始或已开始），电脑和运行时就绪时，HiFox 会把运行排进队列。已完成、已取消和重复状态，从来不会启动第一次运行。

运行推进时，任务显示执行状态：排队、已派出、运行中，然后是已完成、失败或已取消。带仓库的运行可能先花一点时间检出代码、准备隔离目录。你有三个视图：

• 对话：和 Agent 的评论式来回；
• 动态：评论和任务变化在一条时间线上；
• 执行：运行历史和完整轨迹，包括工具调用、运行时事件、触发来源和失败细节。

运行状态和任务状态相关，但是分开的。一次运行可以是运行中，而任务状态仍然写着进行中。因为一个描述执行进度，另一个描述工作流位置。

第 6 步：像审查者一样看结果，而不是像观众

Agent 的最终回复作为一条连到执行轨迹的评论回到任务上。人这一侧的约定从这里开始：Agent 调研、执行、测试并汇报。人定方向、授权，并接受结果。

检查 Agent 是否：

• 看的是你要它看的代码或材料；
• 守住了不改文件的边界；
• 给每个结论提供了证据；
• 把不确定记下来，而不是猜；
• 在任务上留下同事可以接着做的结果。

如果需要再来一遍，用一条聚焦的评论回复。任务仍然派给这个 Agent 时，一条符合条件的评论会启动后续运行。连着发的评论会合并，所以你不会造出重复的待运行。如果 Agent 需要你的输入或审查，这个请求可以出现在收件箱里。收件箱把需要你回复的事项和优先级更低的更新分开。

结果站得住时，把任务标成完成。这关上设置清单跟踪的第一条循环：电脑已连接，Agent 已创建，仓库已就绪，任务已创建、已指派、已完成。

第一条循环之后：五种把设置长大的办法

第一次运行证明管道是通的。接下来的每一步各加一个维度。

怎么同时跑不止一条任务？

有意地提高并发。临时目录下，默认并发是电脑上限的一半。每条任务有隔离的 worktree，所以并行运行不会碰撞。提高上限之前，先看 CPU、内存和模型供应商的容量。和自己搭的方案怎么比，那篇中文还没发布，这里先不放链接。

什么时候用 Agent 对话，而不是任务？

HiFox 故意留两个表面。工作还不需要被跟踪时，用对话来探索、计划或调查。工作需要所有者、状态、执行历史或审查时，用任务。如果一段对话产出了团队必须行动的东西，把它提升成任务，让结果有记录。

什么时候需要小队？

小队是由一个队长 Agent 协调的、人和 Agent 组成的可复用小组。小的、边界清楚的工作，直接把任务派给一个 Agent，活动零件保持为零。当队长需要理解一个目标、叫上专职成员，并把结果带回同一条任务时，用小队。

什么时候技能比改指令更好？

当几个 Agent 需要同一套步骤（审查清单、迁移模式、汇报格式）时，把它移进一项技能，并在需要的地方绑定。一个开发者的手艺变成组织基础设施，而不是一条私人提示词。

团队其他人呢？

上面这些一个人也能做。当任务住在共享空间里、迭代把工作收成周期、同事在他们已经用来看人的工作的同一批视图里审查 Agent 的输出时，回报才会叠加。HiFox 的项目层（空间、专项、迭代、看板和列表视图）足够普通，没有人需要重新培训。

什么时候 HiFox 今天不是对的工具

一条诚实的边界能省时间。如果你是一个开发者、一个 Agent、一个仓库，今天一个终端和一条分支可能就够了。协调层在运行变多时才挣到位置：不止一个 Agent，不止一个人需要看见结果，或者合并前需要审查。

同一套逻辑也适用于你已经搭好的工具。自己的 tmux 会话和 worktree 脚本真的能工作。当看不见的部分（谁跑了什么、diff 去了哪里、谁批准了）开始比脚本省下的更贵时，团队才会从那里毕业。如果你的团队从头到尾住在单一厂商的生态里，先评估那个厂商自己的编排。HiFox 最强的时候，是你在混工具、机器和人，因为它对这三样保持中立。如果在给这个品类画地图，代理式编码那篇是更宽的上下文。那篇中文还没发布，这里先不放链接。

这些情况里不变的是：保留团队已经在用的工具。HiFox 的采用路径是在它们外面加一层看得见、可审查的东西，不是替换底下的工作流。

三种实践里走得通的第一次运行

谨慎的平台团队。一个开发者体验工程师接上一台共享的 Linux 电脑，创建一个只读的代码阅读者 Agent，让同事派一周的调查任务。报告证明值得信任之前，没有人给写权限。采用能铺开，是因为执行轨迹让 Agent 的判断可以检查。

正在放大的个人开发者。一个开发者接上笔记本，创建两个 Agent（一个实现，一个审查），开始把小缺陷走任务，而不是走临时提示词。眼前的收获不是速度。是每一次修复现在都有描述、diff、轨迹，以及检查了什么的记录。

以 Jira 为中心的团队。工程管理者把 Jira 留作计划的事实来源，并接上 HiFox，让工单变成可执行的任务。开发者不再把工单上下文复制进终端。结果、阻塞和审查请求回到管理者看得见的任务上。

你的下一个十分钟

最小的有用工作流故意很小：接上一台电脑，创建一个 Agent，派一条风险不高的任务。每一种进阶能力（并行 worktree、小队、技能、自动化、迭代）都建在这条循环上，而不改变它。

所以跑这条循环。接上一台电脑，创建一个 Agent，派给它一件无聊的事。像审查新同事的第一个 Pull Request 那样审查结果：有注意力，有边界，有一个后续问题。然后根据证据决定下一步授予什么。文档里的快速开始用当前的截图复述这些步骤，你准备开始时可以对照。

常见问题

哪些编程 Agent 能和 HiFox 一起用？

HiFox 识别已连接电脑上安装的受支持 Agent 工具，并把每一个报成运行时。官方文档里提到的包括 Claude Code、Codex、Gemini CLI 和 OpenCode。电脑详情页显示你这台机器当前支持的集合，每个运行时有安装说明链接。工具没有被自动识别时，可以加一个自定义 ACP 运行时。

HiFox 会替代 Claude Code 或 Codex 吗？

不会。HiFox 不替代 Claude Code、Codex 或其他执行工具。那些工具在你的电脑上执行真正的 Agent 会话。HiFox 在它们外面加共享层：团队层面的指派、任务上下文、进度、结果和人的审查。你继续用已经有的 Agent 工具和账号。

HiFox 怎么收费？

模型用量是自带的：走 Agent 工具里配置的订阅或 API Key，额度取决于团队接上的方案。平台本身，公网 SaaS 免费、不限人数、无席位费；私有化按使用人数报价。HiFox 不卖 Token。当前方案以 官网 为准。

代码和凭据会经过 HiFox 的服务器吗？

执行发生在你连接的电脑上：你的笔记本、你的服务器或你的容器。电脑提供操作系统、文件、凭据和工具。本地服务把进度和结果流回任务。仓库用那台电脑上配置的 Git 访问来拉取。

为什么我的 Agent 没有开始运行？

按顺序查三个常见原因。第一，任务可能在待办里。派出去的任务会在那里等，直到移到可开工的状态。第二，运行时可能不可用。电脑在线只确认心跳，所以打开电脑详情，看运行时的能力状态。第三，容量可能满了。在线的 Agent 在并发或目录上限到了的时候，仍然会把工作排进队列。

两个 Agent 能同时做同一个仓库吗？

可以，用临时工作目录。每条任务有隔离目录。带仓库的运行每次准备一份单独的 git worktree，减少并发任务之间的干扰。指定目录相反：一个已配置的路径一次只服务一次运行。

能在远程服务器上跑 HiFox 的 Agent 吗？

能。在远程主机上安装 HiFox CLI 和本地服务，再用电脑页面的一次性安装令牌注册。本地服务向外连到 HiFox，所以典型安装不需要入站端口。远程电脑适合共享的团队容量。笔记本适合个人试验。

第一条任务应该是什么？

只读的、边界清楚的、输出可审查的。文档建议审查认证错误路径，报告三个带证据的、用户能看见的失败情况，不改文件。代码库里任何小而真实的区域都可以。避免含糊的第一条任务，例如「改进代码」。你没有圈定范围的东西，没法审查。