在 macOS 安装 Herdr GPUI：后台程序、客户端与首次验证

Herdr GPUI 是 Herdr 的独立桌面客户端。完成配置需要区分后台程序、桌面应用，以及你实际使用的编程 Agent。三个部分分别安装、分别验证，才能在出错时找到需要检查的组件。

返回 Herdr GPUI 概览与步骤生成器

检查系统环境

客户端仓库说明 macOS 包支持 Apple Silicon 与 Intel，并要求 macOS 14.2 或更新版本。下列方法假设已经安装 Homebrew。使用新版本时，请先核对客户端安装说明。

在普通终端中检查 Homebrew：

brew --version

如果找不到命令，先按 Homebrew 安装说明完成配置。本指南不会自动安装开发工具链或修改系统设置。

安装 Herdr 后台程序

后台程序负责终端进程与会话状态：

brew install herdr
command -v herdr

第二条命令应输出可执行文件的位置。没有输出时，先解决安装或 PATH 问题，再排查图形界面。其他安装方式见 Herdr 安装文档。

安装并打开原生客户端

桌面应用需要单独安装：

brew install penso/tap/herdr-gpui
open -a Herdr

应用可以在需要时启动已经安装的本地 Herdr 服务器，但不会替你安装或升级后台程序。若应用启动后才安装后台程序，客户端文档提供 Terminal > Reconnect 操作。发现机制以客户端范围与配置说明为准。

提示 Herdr 缺失时，回到可执行文件检查。重新安装 Agent 无法解决后台程序发现失败。

验证一个本地项目

选择熟悉的仓库和一个小任务，并先完成 Agent 自身的安装与认证。普通终端中的以下检查可以确认命令是否存在：

command -v claude
command -v codex

只需要安装准备使用的 Agent，未选择的工具缺失不代表配置失败。

打开目标工作区后核对目录，先让 Agent 解释一个小模块，再允许编辑。检查输出与实际文件修改，并保留终端以处理审批请求。状态标记方便导航，但不能代替结果检查。

分别更新两个组件

记录每个组件由哪个安装器管理。通过 Homebrew 安装的后台程序应使用 Homebrew 更新，不要套用直接安装版本的更新流程。客户端仓库说明了 Homebrew 所有权识别与更新行为。

使用短名称管理客户端前，可先添加对应 tap：

brew tap penso/tap
brew upgrade --cask herdr-gpui

长任务更新前阅读发布说明。分离客户端、软件更新和服务器重启是不同事件。会话状态文档说明哪些进程能继续运行，哪些恢复行为依赖 Agent 集成。

后续操作

单任务可用后，参考独立 Git 工作树的并行任务规划。连接异常时，使用客户端与后台程序排障清单，不要直接修改无关设置。

本指南依据上游文档整理，不表示已经在你的电脑上安装或测试软件。