configure

configure is a command for Claude Code from holyshite/claude-hud-for-api. It costs 14 tokens per session (1,279 once invoked), scanned A, original, MIT.

An interactive setup command for configuring the Claude HUD, a status display that shows information while you work. It adjusts what appears, along with colors and formatting.

In plain words
What is it for?
Use it to control the HUD layout, model name, context progress, token counts, session time, speed, API usage, Git status, colors, and number formatting.
Why use it?
It avoids editing a JSON configuration file by hand. You can change display choices through menus and restore the defaults.

Command for Claude Code

Written for Claude Code: allowed-tools in frontmatter. Also seen: reads .claude/ paths; names the AskUserQuestion tool; mentions Claude Code.

Part of the claude-hud plugin — 2 commands shipped together

Good fit Use it to control the HUD layout, model name, context progress, token counts, session time, speed, API usage, Git status, colors, and number formatting.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/holyshite/claude-hud-for-api/configure
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/holyshite/claude-hud-for-api

Made for: Claude Code.

Or install claude-hud, the plugin that ships this one along with the rest of its 2 commands.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for configure

README.md
[![agentmods](https://agentmods.dev/badge/commands/holyshite/claude-hud-for-api/configure/github.svg)](https://agentmods.dev/commands/holyshite/claude-hud-for-api/configure)
Your own site
<a href="https://agentmods.dev/commands/holyshite/claude-hud-for-api/configure"><img src="https://agentmods.dev/badge/commands/holyshite/claude-hud-for-api/configure/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for configure

Your own site · 80×15
<a href="https://agentmods.dev/commands/holyshite/claude-hud-for-api/configure"><img src="https://agentmods.dev/badge/commands/holyshite/claude-hud-for-api/configure.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 14 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,279 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00014 $0.01279
Opus 5 $0.00007 $0.00639
Sonnet 5 $0.00003 $0.00256
Haiku 4.5 $0.00001 $0.00128

Measured 8d ago against content hash ac6e104cd651, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

configure scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

commands/configure.md · 92 lines

How it starts

The opening of the file, as written. The whole thing — 92 lines — stays where its author put it; the contents beside it link to each section on GitHub.

配置 Claude HUD

交互式配置 HUD 插件,无需手动编辑 JSON。

你的任务

Step 1: 读取当前配置

Read ~/.claude/plugins/claude-hud/config.json。如果文件不存在,说明插件尚未初始化,提醒用户先运行 /claude-hud:setup

Step 2: 展示当前配置和可选菜单

用 AskUserQuestion 让用户选择要配置的模块:

  1. 显示设置 — 布局、显示开关、token 分解等
  2. 颜色主题 — 阈值颜色、模型名称颜色、进度条样式
  3. 格式设置 — 模型名称格式、百分比精度
  4. Git 状态 — 显示分支、脏标记等
  5. 恢复默认 — 删除配置文件,恢复出厂设置

Step 3: 根据选择进行配置

如果选了「显示设置」:

先展示当前 display 配置,然后询问用户想修改哪些项。可配置项及说明:

字段 当前值 说明 可选值
lineLayout 布局模式 compact(紧凑单行)、expanded(多行展开)、detailed(经典详细)
showSeparators 各区块间用 | 分隔 true / false
showModel 显示模型名称 true / false
showContextBar 显示上下文进度条 true / false
contextValue 上下文数值显示模式 percent(百分比)、tokens(绝对数)、both(百分比+绝对数)、remaining(剩余百分比)
showTokenCounts 显示输入/输出/总计 token true / false
showTokenBreakdown 显示 token 分类(in/cache) true / false
compactNumbers 大数字用 k/M 单位 true / false
showDuration 显示会话时长 true / false
showSpeed 显示 token 生成速率 true / false
showUsage 显示 API 速率限制(5h/7d) true / false
usageBarEnabled 速率限制进度条 true / false
usageThreshold 速率限制警告阈值(0-100) 数字
showSessionTokens 显示会话累计 token true / false
showSessionName 显示会话名称 true / false

AskUserQuestion 每次最多 4 个选项,分多次询问或让用户在回答中自由描述想改什么。

用户说明要改的项后,使用 Edit 工具更新 config.json 中对应字段。

如果选了「颜色主题」:

先展示当前 color 配置,然后询问用户想修改的项:

字段 当前值 说明 可选值
safeThreshold 安全阈值(绿色) 0–100
warningThreshold 警告阈值(红色) 0–100
modelColor 模型名称颜色 greenyellowredcyanbluemagentadim
progressStyle 进度条样式 bar(条形 ████)、text(纯文本)、percentage(仅百分比)
如果选了「格式设置」:

先展示当前 format 配置,然后询问用户想修改的项:

字段 当前值 说明 可选值
modelFormat 模型名称格式,支持 {name}(显示名)、{id}(模型 ID) 字符串
percentagePrecision 百分比小数位数 0–3

Read the full file on GitHub · 92 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 92 lines · 14 tokens per session scan A ac6e104cd651

Subscribe to this mod's changes

configure is a command published in the GitHub repository holyshite/claude-hud-for-api (2 stars, last pushed 4mo ago), licensed MIT. It adds 14 tokens to every session and 1,279 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.