干嘛用？

为了更方便观察 Claude 的运行状态，可以安装claude-hud 插件，实时显示：Context 使用量，Claude 当前模型，执行工具记录，Agent / Todo 状态，本文介绍Mac 上安装和使用方法。

一、安装 Claude Code

首先确保系统已安装Node.js。

检查 Node：

node -v

如果没有安装，可以使用 Homebrew：

brew install node

然后安装 Claude Code：

npm install -g @anthropic-ai/claude-code

安装完成后运行：

claude

成功会看到类似界面：

Claude Code v2.x
Welcome back
>

二、安装 claude-hud 插件

进入 Claude Code 后，在输入框中依次输入以下命令。

1 添加插件市场

/plugin marketplace add jarrodwatts/claude-hud

成功会提示：

Successfully added marketplace: claude-hud

2 安装插件

/plugin install claude-hud

Claude 会自动下载插件。

3 重新加载插件

/reload-plugins

4 初始化 HUD

/claude-hud:setup

初始化过程中会让你选择 HUD 显示内容，例如：

Tools activity
Agents & Todos
Session info

建议全部开启。

三、插件配置文件

安装完成后 Claude 会生成配置：

~/.claude/plugins/claude-hud/config.json

示例配置：

{ "display": { "showTools": true, "showAgents": true, "showTodos": true, "showDuration": true, "showConfigCounts": true }
}

你也可以手动修改这个文件来自定义 HUD 显示。

四、HUD 状态栏说明

安装成功后，在 Claude Code 输入框下方会出现一行状态栏，例如：

[Sonnet 4.6] username
Context 22%
✓ Bash x11 | ✓ Read x1 | ✓ Skill x1

各项含义：

信息

含义

模型

当前使用的 Claude 模型

Context

当前会话上下文占用

Bash

Claude 执行的 shell 命令次数

Read

Claude 读取文件次数

Skill

调用技能或工具次数

五、常用 Claude Code 命令

在 Claude Code 中，系统命令都以/开头。

常用命令：

查看帮助

/help

初始化项目

/init

会生成：

CLAUDE.md

用于项目上下文说明。

查看插件

/plugin list

重新加载插件

/reload-plugins

切换模型

/model

清空上下文

/clear

六、Context 使用量说明

HUD 中的：

Context 22%

表示当前会话使用了22% 的上下文容量。

Claude 在计算时会把以下内容放入上下文：

聊天历史
读取的代码
工具执行结果
AI 思考过程

如果 Context 接近：

90%

建议执行：

/clear

或开启新会话。

七、推荐开发环境（可选）

很多开发者会配合tmux使用 Claude Code：

示例布局：

┌───────────────┬───────────────┐
│ Claude Agent │ Code Editor │
├───────────────┼───────────────┤
│ Logs │ Shell │
└───────────────┴───────────────┘

这样可以同时：

与 Claude 交互
编写代码
查看日志
执行命令

开发效率会更高。

总结

Claude Code + claude-hud 插件可以让 AI 开发体验更加清晰。

安装步骤：

claude
/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/reload-plugins
/claude-hud:setup

安装完成后即可在 Claude Code 中看到实时状态栏。

对于 AI 编程和项目开发非常实用。