快速上手

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

1. 完成初始化

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

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

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

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

2. 创建 Agent 并连接代码库

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

创建 Agent

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

名称：Thor - Developer

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

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

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

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

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

准备代码库

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

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

方式一：连接 Git 仓库

在 Agent 设置里绑定 Git 仓库。之后 Agent 执行任务时，会拉取这个仓库进行工作。仓库访问依赖 Agent 所在机器上的 Git 凭证。

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

方式二：指定已有目录

如果你的代码已经在 Agent 所在机器的某个目录里，也可以不先连接 Git 仓库，而是在 Agent 的任务运行设置中把任务工作目录改为 指定已有目录。

操作步骤：

进入 Agent 的设置页。

找到 任务运行设置。

将 任务工作目录 从“独立临时目录”改为 指定已有目录。

点击修改，选择或填写本机已有代码目录，例如 /Users/me/code/my-app。

确认这个目录在 Agent 所选机器上真实存在，并且机器上的运行时有权限读取和修改。

这种方式适合个人试用、本地已有代码，或超大代码库等不希望每次任务都重新创建代码副本的场景。使用指定已有目录时，任务会在这个目录中按顺序运行，不会为每个任务创建新的 git worktree。

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

3. 创建任务并让 Agent 执行

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

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

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

范围较小，方便 review；

有清楚的验收标准；

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

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

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

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

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

安排给 Agent

任务创建后，把负责人设置为刚创建的 Agent，并把任务状态设为 To do。Agent 就会自动开始执行任务。

查看和 review 结果

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

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

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

启动一个网页端给我验收

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

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

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

熟悉 HiFox 中跟 Agent 的协作之后，你就可以尝试更大的需求，更复杂的任务了。

1. 完成初始化#

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

创建 Agent#

准备代码库#

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

安排给 Agent#