headroom — MCP-сервер для Claude Code: лимиты подписок
Показывает, сколько осталось в 5-часовом и недельном окне подписки Claude и Codex и когда сброс, а агенты спрашивают это сами до старта работы.
claude mcp add headroom -- npx -y headroomdЧто делает headroom
headroom читает данные о лимитах, которые отдают подписки Claude и Codex, и отвечает на вопрос, можно ли начинать: идти, подождать или переключиться на другой маршрут. Статус отдаётся через CLI или MCP.
Для Claude данные берутся из статуслайна: в ~/.claude/settings.json прописывается headroom statusline, а сам headroom дополнительно обращается к встроенной /usage не чаще раза в 10 минут, чтобы добрать показатели, которых в статуслайне нет. Правок в ваши настройки Claude он не вносит.
Понадобится Node 22.13 или новее и пакет headroomd, который ставит команду headroom, после чего headroom setup находит логины и проводит диагностику. Для Codex, например, MCP не нужен — агенты дёргают CLI напрямую, поэтому в CLAUDE.md или AGENTS.md придётся вставить инструкцию про headroom can и headroom run, иначе агент не будет проверять лимиты до запуска задачи.
Какие задачи решает
- узнать, когда закончится 5-часовое окно подписки
- не запускать сборку, если в лимите нет запаса
- переключить агента на другой маршрут при исчерпанной квоте
- зарезервировать часть окна под конкретную задачу
- проверить остаток по недельному лимиту перед работой
Примеры запросов агенту
- Проверь лимиты через headroom и скажи, можно ли начинать сборку
- Запусти задачу через
headroom run --meter 5h --need 5h:10 --owner my-agent -- npm test - Если лимита нет, дождись сброса и перепроверь через
headroom can
Как установить headroom
Командой платформы
claude mcp add headroom -- npx -y headroomdКомандой платформы
codex mcp add headroom -- npx -y headroomdФайл настроек
{
"mcpServers": {
"headroom": {
"command": "npx",
"args": [
"-y",
"headroomd"
]
}
}
}Файл настроек
{
"servers": {
"headroom": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"headroomd"
]
}
}
}Командой платформы
gemini mcp add headroom npx -y headroomdПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о headroom
Как установить headroom в Claude Code?
Сначала поставьте CLI: npm install -g headroomd или brew install apertur3/tap/headroom, затем выполните headroom setup. Потом добавьте MCP-сервер командой claude mcp add headroom -- npx -y headroomd.
Что делает headroom?
Читает данные о лимитах подписок Claude и Codex и отдаёт статус по 5-часовому и недельному окну — сколько израсходовано и когда сброс. Агент может спросить это до начала работы.
Чем headroom отличается от проекта headroomlabs-ai/headroom?
Это разные проекты: headroomlabs-ai/headroom занимается сжатием контекста, а этот показывает лимиты подписок. Авторы прямо указывают, что связи между ними нет.
