# 支持的 agent

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

Agent HUD 关注的 18 个编程 agent，各自能显示什么，以及各自需要哪些设置。

更新于 2026-10-28

Agent HUD 关注 18 个编程 agent，另外还读取 GLM Coding Plan 的额度，并支持 Qoder 系列的批准请求。安装并登录你想关注的 agent，Agent HUD 会在你的 Mac 上自动发现它们。每个 agent 能显示哪些内容，取决于它自己记录和报告了什么。

## 各 agent 支持什么

| Agent | Token 与会话 | 额度 | 实时状态 | 批准 | 提问 | 回复 | 回到会话 | 轮次与调用 |
| --- | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
| **Claude Code** | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| **Codex** | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| **DeepSeek Harness** | ✓ | 余额 | ✓ | ✓ | ✓ | ✓ |  | ✓ |
| **Antigravity** | ✓ | ✓ |  | ✓ | ✓ | ✓ | ✓ |  |
| **Cursor** | ✓ | ✓ |  |  |  | ✓ |  |  |
| **Grok CLI** | ✓ |  | ✓ |  |  | ✓ |  |  |
| **Grok Bot** | ✓ | ✓ |  |  |  |  | ✓ |  |
| **GitHub Copilot CLI** | ✓ | ✓ | ✓ |  |  | ✓ |  |  |
| **OpenCode** | ✓ | ✓ |  |  |  | ✓ | ✓ |  |
| **Kimi** | ✓ | ✓ | ✓ |  |  | ✓ |  |  |
| **Pi** | ✓ | ✓ | ✓ |  |  | ✓ | ✓ |  |
| **OpenClaw** | ✓ |  |  |  |  |  |  |  |
| **Hermes Agent** | ✓ |  |  |  |  |  |  |  |
| **ZCode** | ✓ |  |  | ✓ | ✓ |  |  |  |
| **CodeBuddy** | ✓ |  |  | ✓ |  | ✓ |  |  |
| **WorkBuddy** | ✓ |  |  | ✓ |  |  |  |  |
| **Qwen Code** | ✓ |  |  | ✓ |  | ✓ |  |  |
| **Devin CLI** | ✓ | ✓ |  | ✓ |  | ✓ |  |  |

另外还读取 **GLM Coding Plan** 的额度，并支持 **Qoder**、**Qoder CN** 与 **QoderWork** 的批准请求。

- **Token 与会话**：每个会话的 Token、模型与估算费用。见 [Token 与费用](https://agenthud.app/docs/zh/agents/tokens/)。
- **额度**：厂商报告的额度窗口或余额。见 [额度与余额](https://agenthud.app/docs/zh/agents/quotas/)。
- **实时状态**：HUD 显示这个 agent 正在工作、等你处理还是已经完成。
- **批准**与**提问**：在 HUD 上回应。见[请求](https://agenthud.app/docs/zh/hud/requests/)。
- **回复**：一轮结束时，HUD 上出现**有新回复**提醒。
- **回到会话**：在 agent 自己的应用或终端窗格里打开这个会话。
- **轮次与调用**：会话页面按轮次、按调用拆开显示。

## 需要哪些设置

| 想要 | 需要 |
| --- | --- |
| 任何 agent 的批准与提问 | 在**设置 → 通用**中打开**客户端回调**。见[客户端回调](https://agenthud.app/docs/zh/agents/hooks/)。 |
| Antigravity、Cursor、GitHub Copilot CLI、CodeBuddy、Qwen Code、Devin CLI、OpenCode 与 Pi 的回复；Pi 的实时状态 | 打开**客户端回调** |
| Cursor 的 Token | Cursor 3.27 或更新版本，并打开**客户端回调** |
| Codex CLI 的批准 | 在 Codex 中信任 Agent HUD 的回调（`/hooks`） |
| DeepSeek Harness 的批准与提问 | 在**设置 → 智能体插件**中安装 Agent HUD 插件 |
| GitHub Copilot CLI 的额度 | 在**设置 → 智能体 → GitHub Copilot** 中打开**读取 GitHub Copilot 额度** |
| Antigravity CLI 的账户 | 在**设置 → 智能体 → Antigravity** 中填写 **Antigravity CLI 账户** |

**设置 → 智能体**里，每个 agent 还有**实时状态**和**完成提醒**两个开关。关闭实时状态后，这个 agent 的会话不显示状态与最后一条消息，也不再有提醒；它的 Token 与历史照常统计。

## 各 agent 说明

### Claude Code

Agent HUD 读取 Claude Code 保存在项目目录里的会话记录。套餐额度则直接问本机安装的 Claude Code，在关闭回调的情况下读取当前登录账户的用量，不向模型发送任何消息。账户显示邮箱与套餐，Max 套餐会写明是 5× 还是 20×。用 API key 或第三方平台登录时没有套餐额度，额度分组会写明这一点。「回到会话」在 Claude 桌面版里打开这个会话，或者在它不在 tmux 中运行时打开所在的 iTerm 窗格。Claude 在桌面版里提的问题，经由 Agent HUD 的 Claude Code 插件回答，这个插件在**设置 → 智能体插件**中安装。

### Codex

包括 Codex 桌面版与 CLI。Agent HUD 读取 Codex 的会话日志、归档会话与会话索引。额度则通过 Codex 自己的 app server 向本机安装的 Codex 读取，不创建线程，也不开始新的一轮。桌面版与 CLI 用同一个登录时，只显示一组窗口。CLI 的批准请求只在一轮明确交给你审核时才来到 HUD；Codex 自动审核的仍留在 Codex。「回到会话」在 Codex 桌面版里打开那个线程，或者打开 CLI 会话不在 tmux 中运行时所在的 iTerm 窗格。要关注更多 Codex 账户，见[额度与余额](https://agenthud.app/docs/zh/agents/quotas/)。

### DeepSeek Harness

DeepSeek 按余额扣费，所以 Agent HUD 显示余额、每天的花费，以及余额预计用完的日期，而不是额度窗口。它用 Harness 已配置的密钥读取余额，这个密钥只发给 DeepSeek 官方的余额服务。配置的是自定义 API 地址时，没有官方余额可读：Agent HUD 不发请求，并会注明原因。提问与批准请求经由 Agent HUD 的 Harness 插件来到 HUD；在 HUD 和 Harness 里，先回答的那个算数。

### Antigravity

额度来自这台 Mac 上正在运行的 Antigravity 桌面版，以及已连接的 Antigravity CLI。你在 CLI 里原有的状态栏照常保留。每个邮箱算一个账户；超过 5 分钟的读数会标为过期，直到新的读数送来。Agent HUD 只回应桌面版已经在问的批准请求与提问。一轮进行中时，HUD 不显示 Antigravity 正在工作。「回到会话」在运行中的桌面版里打开这段对话，从不替你启动桌面版。

### Cursor

会话来自 Cursor 在这台 Mac 上的数据库，Token 来自 Cursor 的完成回调：从 Cursor 3.27 起，它会报告每次生成的 Token。额度来自你 Cursor 账户的用量汇总：账户报出的套餐各部分，重置时间以 Cursor 给出的为准。批准与提问仍在 Cursor 里处理。

### Grok CLI 与 Grok Bot

两者是各自独立的来源。**Grok CLI**：会话与 Token 来自 `~/.grok`，或 `GROK_HOME` 指定的文件夹；不读取它的额度，也不读取任何 Grok 凭据。**Grok Bot**：额度来自 Grok Bot 桌面版保存在你 Mac 上的缓存，它的登录文件从不打开。它的 Bot 运行在 Cursor 的服务器上，所以每个 Bot 每天的 Token 用这台 Mac 上 Cursor 的登录从那里读取。已合并到 SuperGrok 的账户不报告 Token，只显示会话。

### GitHub Copilot CLI

Token 与会话来自 Copilot CLI 自己的目录。只有你打开**读取 GitHub Copilot 额度**之后，Agent HUD 才借用 GitHub CLI 现有的登录读取额度。它不会启动 `gh` 或 Copilot，也从不刷新令牌。你的套餐里不限量的额度不单列一行。

### OpenCode、Kimi 与 Pi

- **OpenCode**：OpenCode Go 套餐的额度，用 OpenCode 已有的密钥读取。OpenCode 里存着 Kimi Code 套餐或 GLM Coding Plan 的密钥时，这些套餐的额度也会显示。回复来自 Agent HUD 的 OpenCode 插件。OpenCode 在 iTerm 中且不在 tmux 里运行时，可以「回到会话」。
- **Kimi**：你的 Kimi Code 套餐的额度，用 Kimi Code 现有的登录或 `KIMI_CODE_API_KEY` 里的密钥读取。
- **Pi**：没有自己的额度，你看到的是为它的请求付费的那个套餐。在 Pi 里用 ChatGPT 登录，显示为 Codex 的额度，和 Codex 只算一次；Pi 里的 GLM Coding Plan 密钥显示为 GLM 的额度。实时状态与回复来自 Agent HUD 加进 Pi 的一个小扩展。iTerm2 中且不在 tmux 里运行的会话可以「回到会话」。

### OpenClaw 与 Hermes Agent

只有 Token 与会话，从它们各自保存的文件读取：OpenClaw 的状态文件夹（`~/.openclaw` 或 `OPENCLAW_STATE_DIR`），以及 Hermes 的状态数据库（`~/.hermes` 或 `HERMES_HOME`），所有配置都包括在内。Agent HUD 不读取 Hermes 的对话内容，不读取两者的任何凭据，也不改动它们的设置。OpenClaw 通过 Claude Code 运行的一轮只算一次，算在 Claude Code 名下。

### ZCode、CodeBuddy、WorkBuddy、Qwen Code 与 Devin CLI

它们的工具批准请求来到 HUD，带有**拒绝**和**批准一次**；提问与计划审批仍留在 agent 里，只有 ZCode 的提问也会来到 HUD。

- **ZCode** 只在它自己的回调设置打开时运行回调。这项设置缺失时，Agent HUD 写入回调的同时把它打开；如果是你自己关掉的，Agent HUD 保持关闭。
- **CodeBuddy** 与 **WorkBuddy** 的记录方式相同，但算作两个 agent，会话从不混在一起。WorkBuddy 记下某个模型达到套餐上限时，这项上限显示为已用尽，直到 WorkBuddy 给出的重置时间。
- **Qwen Code**：从旧会话开出的新会话会复制旧的历史，Agent HUD 只把这段历史算一次。
- **Devin CLI**：每日与每周额度来自 CLI 缓存在你 Mac 上的账户状态，和 CLI 自己最近一次检查一样新；Agent HUD 自己不发任何请求。

## 在 iPhone 与 Apple Watch 上

每个 agent 的 Token、会话与额度都会来到 iPhone 与 Apple Watch：iPhone 和 Mac 在同一网络时免费使用，有 Agent HUD Remote 时在任何网络下都能看到。Remote 还会把 HUD 收到的批准、提问与计划带到手机上。见 [iPhone](https://agenthud.app/docs/zh/phone/iphone/) 与 [Agent HUD Remote](https://agenthud.app/docs/zh/phone/remote/)。

---

English: https://agenthud.app/docs/en/agents/supported/