# 在 Mac 上安装

[Agent HUD 文档](https://agenthud.app/docs/zh/)

下载 Agent HUD，放进「应用程序」，打开客户端回调以接收请求与回复，并保持更新。

更新于 2026-10-28

Agent HUD 的 Mac 版从 [agenthud.app/mac](https://agenthud.app/mac) 下载，经过签名并由 Apple 公证。把它装进「应用程序」文件夹，它会自己找到你 Mac 上的 agent。

## 系统要求

| | |
| --- | --- |
| **macOS** | 14 或更高版本 |
| **Mac** | Apple 芯片或 Intel，各有各的下载 |
| **Agent** | 安装并登录你想关注的 agent。[支持的 agent](https://agenthud.app/docs/zh/agents/supported/) 列出了它们。 |
| **iPhone 与 Apple Watch** | 可选，从 App Store 获取。见 [iPhone](https://agenthud.app/docs/zh/phone/iphone/)。 |

GitHub 上的部分发行页面还附有 Windows 与 Linux 的未签名测试版，它们尚未在真机上测试，也不会自动更新。

## 安装

### 下载

打开 [agenthud.app/mac](https://agenthud.app/mac)，它会跳到 GitHub 上的最新发行版。Apple 芯片的 Mac 下载 `arm64` 的 DMG，Intel 的 Mac 下载 `x86_64` 的 DMG。

### 移到「应用程序」

打开 DMG，把 **Agent HUD** 拖到 **Applications** 上。

{/* figure: the DMG window, Agent HUD beside the Applications folder */}

### 打开

从「应用程序」文件夹打开 Agent HUD。

> **放在「应用程序」里**
>
> 只有位于 `/Applications/Agent HUD.app` 的 Agent HUD 才能给 agent 添加客户端回调与 HUD 工具。从其他位置打开时，这些开关不可用。

## 首次启动

- **每块屏幕上出现 HUD**：有刘海的屏幕用**刘海**形态，其他屏幕用**动态**形态。见[形态](https://agenthud.app/docs/zh/hud/modes/)。
- **菜单栏出现图标**，里面有各个 agent 的读数，以及**隐藏灵动岛光晕**、**统计…**、**刷新数据**、**设置…**和**退出**。
- **Agent HUD 把自己加入登录项**，登录 Mac 后自动启动。可以在**设置 → 通用 → 登录时启动**关闭。
- **它会找到你的 agent**，开始读取它们在你 Mac 上的记录，以及厂商报告的额度。

只有打开设置或统计窗口时，Agent HUD 才在程序坞里显示图标。Agent HUD 运行时，再从「应用程序」打开它，会打开设置。

## 打开客户端回调

请求以及大多数 agent 的回复，经由各 agent 自己设置里的小段回调来到 HUD。客户端回调默认关闭，由你打开。

打开**设置 → 通用**。

在**客户端**下，打开**客户端回调**。

需要的话，修改**等待回答**：请求在 HUD 上等多久，到时交还 agent。默认 10 分钟。

![设置 → 通用的「客户端」一节：客户端回调已打开，等待回答为 10 分钟](https://agenthud.app/docs/images/settings/general-clients.zh.webp)

Codex 要等你在 Codex 中审阅并信任新的回调后才会运行它。在那之前，Codex 的请求留在 Codex 里。

关闭客户端回调会移除 Agent HUD 的回调，你自己的回调保持原样。每个 agent 里写了什么，见[客户端回调](https://agenthud.app/docs/zh/agents/hooks/)；在 HUD 上能回应什么，见[请求](https://agenthud.app/docs/zh/hud/requests/)。

## 更新

Agent HUD 每天检查一次新版本。有新版本时，菜单栏菜单里出现**发现新版本…**，面板底部出现一个箭头，两者都会打开**设置 → 更新**。

{/* figure: Settings → Updates with a new version downloaded and Install update */}

| 设置 | 作用 | 默认 |
| --- | --- | --- |
| **自动检查更新** | 每天检查一次新版本 | 开 |
| **自动下载更新** | 下载新版本并验证签名，安装仍需你确认 | 关 |
| **接收测试版** | 改用测试版更新源，切换时清除已下载的待更新版本 | 关 |

同一页里有**检查更新**；有新版本时，还有**下载更新**、**安装更新**、**立即重启**和**跳过此版本**。在你选择**安装更新**之前，不会安装任何东西。

新版本会写明它需要的 iPhone 应用版本（**需要 iPhone 版本**）。如果你在用 iPhone 应用，请先更新它。

## 退出或卸载

退出：打开菜单栏图标，选择**退出**（⌘Q）。

卸载：先移除 Agent HUD 加进 agent 设置里的内容。在**设置 → 通用**关闭**客户端回调**，其余各项按[全部移除](https://agenthud.app/docs/zh/agents/hooks/)里列出的步骤移除。然后退出 Agent HUD，把它从「应用程序」移到废纸篓。

> 只删除应用，回调仍会留在 agent 的设置里，指向一个已经不存在的应用。

---

English: https://agenthud.app/docs/en/getting-started/install/