快速上手
开始使用 HiFox 时，可以先完成组织、空间和任务设置；要让 Agent 真正执行代码相关工作，则需要为它选择一台电脑上的可用 Runtime，例如 Claude Code、Codex、Gemini、OpenClaw 或 Hermes。电脑显示在线只表示本地服务正在发送心跳，不代表 Runtime 已经满足执行条件。
开始使用清单
侧边栏中的清单和设置里的「开始使用」引导页，会帮助你完成第一个 Agent 任务的闭环：
- 连接一台电脑；
- 创建第一个 Agent；
- 添加 Git 仓库，或为任务设置指定已有的工作目录；
- 创建第一个任务；
- 将任务指派给 Agent；
- 将已指派给 Agent 的任务标记为完成。
第三步满足任意一种代码准备方式即可。最后一步以已指派给 Agent 的任务被标记为完成为准。
1. 完成初始化
第一次进入 HiFox 时，会先进入初始化，跟着界面一步步走即可。
- 下载安装 HiFox 客户端，它包含本地服务，会自动启动。
- 注册 HiFox。可以用邮箱或微信扫码登录。
- 创建组织，输入组织名称和地址（URL）即可。
- 连接这台电脑上的 AI 编程工具。
如果暂时还没有可用 Runtime，仍可以先创建组织、空间和任务；但在 Runtime 可用前，Agent 无法执行任务。
2. 创建第一个空间
完成初始化后，HiFox 会引导你创建第一个空间。先选择工作类型，再由 HiFox 为这个空间准备起始任务类型：
- 软件开发：可选择需求、Bug、任务和用户故事，适合需要区分产品需求与缺陷的研发团队；
- 其他工作类型：以通用的「任务」类型开始，适合先快速建立日常协作流程。
首个空间默认对组织公开，之后可以在空间设置中按团队需要调整任务类型、工作流和访问范围。更多设置方式见 空间 和 任务类型。
3. 创建 Agent 并连接代码库
完成初始化之后，创建一个用于处理代码任务的 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 能找到代码，并能在对应电脑上运行必要命令。
4. 创建任务并让 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 的协作之后，你就可以尝试更大的需求，更复杂的任务了。