准备运行环境
Hagency 文档提供 Linux 和 macOS 本地安装路径。主要运行时需要 Node.js 22 或更高版本、tmux、git，以及已配置的编程 CLI。模型访问通过该运行时支持的认证方式提供；填写资源标签本身并不代表模型已经可用。
先检查，再安装
克隆仓库，先运行对应平台的预检查。macOS 安装器使用 launchd，Linux 完整安装器使用 systemd。正式安装前，请检查依赖、生成的服务以及已有 tmux 会话。
终端
git clone https://github.com/hagency-org/hagency.git
cd hagency
# macOS: review the installation
./install/install-macos.sh --dry-run
# Linux: review the installation
./install-full.sh --dry-run配置资源并验证
在 9 月 8 日开发版控制台中，从资源开始：选择受支持的框架与模型设置，定义可承担合格角色的命名 Agent。发布只公开预期的目录信息。项目请求获批后，才创建或复用 Agent。
检查实际观察到的启动与连接状态。已配置资源、已发布角色、已批准请求和可用 Agent 是不同状态。请依据项目提供的具体错误进行处理，不要将配置完成当作执行成功。