快速上手
跟着这篇做完，你会有一个能接任务的 Agent：在 HiFox 里建一个很小的任务并指派给它，它在你的电脑上改完代码，过程和结果都回到这个任务里。
想先了解 HiFox 解决什么问题，看 欢迎使用 HiFox。这篇只讲第一次怎么跑通。
先分清三件事
后面的每一步对应其中一件。
- 任务是这一次要做什么，比如把一个按钮的文案改掉。
- Agent是谁来做、按什么规矩做。它记住职责和指令，可以反复派活。
- 电脑是它干活的地方。Claude Code、Codex 这些 AI 编程工具装在这台电脑上，代码、登录状态和命令也都在这里。HiFox 不另起一套工具，就是用这台电脑上已有的。
一次执行就是：任务派给 Agent，Agent 到这台电脑上改代码、跑命令，结果写回任务。更完整的说明见 Agent。
1. 登录，建好组织和空间
打开 HiFox，用邮箱验证码或微信扫码登录。没有账号也直接登录，第一次会自动创建。
网页端会先建议你下载桌面版。桌面版能检测本机已经安装的 AI 编程工具，并顺手把这台电脑注册进来，后面少走一步，建议用它。想先在浏览器里看完界面，选继续使用网页端，电脑可以之后再接。
接着创建组织，填组织名称和组织 URL。组织是团队和 Agent 一起工作的地方。
进入组织后会弹出初始化默认空间，问这个空间主要做什么工作。做研发就选软件开发，任务类型保持默认（需求和缺陷已勾选）直接保存。HiFox 会建一个叫「默认空间」的空间，名称不用自己填，任务类型和功能模块以后都能在空间设置里改。其他工作类型、以及之后再建空间怎么设置，见 空间。
2. 把一台电脑接进来
Agent 要用电脑上的 AI 编程工具来改代码。本地电脑、云服务器、虚拟机都可以。
- 桌面版会在设置过程中检测并引导你注册这台电脑。
- 网页端在「开始使用」里点连接电脑，把页面给出的命令复制到那台电脑的终端执行。
接好后打开这台电脑的详情看一眼。显示在线只说明连上了；上面的编程工具没装好、没登录，或者没出现在本地服务的 PATH 里，Agent 还是跑不了任务。页面提示未检测到或未登录时，按它给的命令在这台电脑上处理，重启本地服务后再刷新。详见 电脑。
这一步没完成时，创建 Agent 会被拦住，弹窗标题是「没有可用的电脑」。按弹窗里的说明接好再回来即可。
3. 创建一个职责单一的 Agent
到全部 Agent，点创建 Agent。先让它只负责一件事，你才知道该把什么任务交给它。
第一次建议这样配：
- 类型选代码开发。在软件开发空间里，这是默认项。
- 工作方式选Agent 自动拉取 Git 代码仓库，并把仓库加进去。每个任务使用独立的 worktree，几个任务一起跑也不会互相改乱目录。仓库能不能拉下来，取决于这台电脑上的 Git 凭证。
- 名称自己起，比如
Thor。 - 电脑选刚才接好的那一台。
- 指令先写短的：接到任务后先读描述和评论；需求不清楚先提问，不要猜；改动尽量小；做完说明改了哪些文件、跑了什么检查。
代码已经在这台电脑的某个目录里、暂时不想配 Git，把工作方式改成手动指定代码所在目录。只是临时生成一段代码、不碰现有项目，选不需要代码库。两种方式见 连接代码库 和 Agent 工作目录。
可见性先用个人。等这个 Agent 确实好用，再共享给空间里的其他人。
4. 交给它一个小任务
在「默认空间」的任务页点新建任务。第一次不用自己想题目。用下面这个：它不碰现有项目，做完双击 HTML 就能验收。
标题：
示例任务：制作一个年会抽奖程序
描述：
创建后打开任务，在属性里把处理人选成刚才的 Agent。新建任务的默认状态是待开始，处理人一设好，Agent 就会开始，不用再改状态。
之后看这一个任务就够了：对话记录里是它正在做什么，评论里是它的结论和卡住的地方，需要你处理的事项会进收件箱。
不满意就在评论里直接说，它会带着已有上下文接着改。比如：
停止时没有撒花，补上。
确认没问题后，按任务里的要求收尾：
把 HTML 文件上传到这条任务的评论里，并把任务状态改为已完成。
完成对应的状态叫已完成。改不改由你判断，它不在「开始使用」清单里。
到这里闭环就通了：任务带着上下文，Agent 负责执行，你负责验收。
接下来
侧边栏的「新手指引」会勾掉已经完成的步骤，剩下的不用一次做完。比较值得接着做的三件事：
- 把同事请进组织，见 成员；
- 任务本来在 Jira、TAPD 或禅道里，就接进来继续用，不用把任务搬一遍，见 Jira、TAPD、禅道；
- 接上飞书、钉钉或企业微信，让通知留在团队已经在用的地方，见 飞书、钉钉、企业微信。
同一个 Agent 能稳定接住一类任务之后，再拆出更专的 Agent，或把固定流程做成技能。