快速上手

开始之前，请先确认本机至少安装了一个 HiFox 支持的 AI 编程工具，例如 Claude Code、Codex、Gemini、OpenClaw 或 Hermes。HiFox 会通过本机 daemon 启动这些工具来执行 Agent 任务；如果一个可用工具都没有，HiFox 会无法正常执行代码相关工作。关于机器、daemon 和运行环境，可以参考机器。

1. 完成初始化

第一次进入 HiFox 时，会先进入初始化，跟着界面一步步走即可。

下载安装 HiFox 客户端，它包含了一个守护进程，会自动启动。

创建组织，输入组织名称和地址（URL）即可。

连接机器上的 AI 编程工具。

2. 创建 Agent 并连接代码库

完成初始化之后，创建一个用于处理代码任务的 Coding Agent。

创建 Coding Agent

在“我的 Agent”页面点击新建 Agent，按下面方式填写：

名称：Coding Agent

描述：处理代码修改、Bug 修复、测试补齐和代码调研。

机器/运行时（Runtime）：选择刚才 onboarding 中连接成功的机器和 AI 编程工具。

指令：可以先写一段简单规则：

你是团队的 Coding Agent。接到任务后，先阅读任务描述和评论，必要时查看相关代码。若需求不清楚，先提出问题或补充任务细节。修改代码时保持改动范围小，完成后说明修改了哪些文件、运行了哪些检查，以及是否还有需要人工处理的事项。

先用这一个 Coding Agent 跑通流程即可。后续如果团队需要，再拆分出前端修复、测试补齐、代码 review 等更具体的 Agent；如果这些 Agent 会复用固定流程，也可以整理成 Skill。

准备代码库

要让 Coding Agent 读代码、改文件或运行测试，需要先准备好代码库。

有两种简单方式，任选一种即可。

方式一：在 HiFox 里连接 Git 仓库

在 Agent 设置里给 Coding Agent 绑定 Git 仓库。之后 Agent 执行任务时，会拉取这个仓库进行工作。仓库访问依赖 Agent 所在机器上的 Git 凭证，配置细节见连接代码库。

这种方式适合团队协作：任务、代码库和 Agent 配置都在 HiFox 中可见，也更适合后续让多个成员或 Agent 复用。

方式二：在 Agent 指令里写本地代码路径

如果你的代码已经在本机某个目录里，也可以先不连接 Git 仓库，而是在 Agent 指令里写清楚本地路径。例如：

项目代码在 /Users/me/code/my-app。处理代码任务时，请优先在这个目录中阅读代码、修改文件和运行测试。

这种方式适合个人试用或本地已有代码的场景。

第一次快速上手时，选择你最方便的方式即可。关键是让 Coding Agent 能找到代码，并能在对应机器上运行必要命令。

3. 创建任务并让 Agent 执行

接下来，创建一个真实但低风险的任务，让 Agent 完整执行一次。

第一次任务建议足够具体，最好满足这些条件：

目标明确，不需要大量产品判断；

范围较小，方便 review；

有清楚的验收标准；

Agent 所在机器已经能访问需要的代码库、工具和命令。

例如，你可以创建一个这样的任务：

把截图中红框位置的按钮文案从“开始”改为“开始执行”。

然后附一张截图，用红色框标出需要修改的地方：

这类任务很适合作为第一次试运行：目标清楚、范围很小，并且截图已经标出了需要修改的位置。

安排给 Agent

任务创建后，把负责人设置为刚创建的 Coding Agent，并把任务状态设为 To do。Agent 就会自动开始执行任务；更多状态、排队和失败处理见 Agent 如何执行任务。

查看和 review 结果

Agent 开始工作后，你可以在同一个任务里查看进展、补充信息、处理阻塞，并 review 最终结果。你也可以在收件箱里看到任务的最新动态；如果只是临时调研或讨论，可以先和 Agent 对话，再把明确工作落到任务里。

如果结果不符合预期，直接在任务评论里说明问题，让 Agent 基于已有上下文继续修改。

Agent 执行完命令后，你可以用类似这样的评论来查看效果：

启动一个网页端给我验收

确认 Agent 正确执行任务之后，你可以使用这样的评论：

commit 并 push。如果需要 rebase 则执行 rebase。
完成后把任务标记为已完成，并清理 worktree。

完成这一步后，你就跑通了 HiFox 中最核心的协作闭环：任务承载上下文，Agent 执行工作，结果回到任务里，成员再 review 和推进下一步。

1. 完成初始化#

2. 创建 Agent 并连接代码库#

创建 Coding Agent#

准备代码库#

3. 创建任务并让 Agent 执行#

安排给 Agent#