Интеграции

Kumo Usage CLI Bar

Панель расхода и остатка под промптом Claude Code и Codex — ставится одной командой, находит ваш ключ сама и показывает, сколько осталось: пакет, баланс или ваш лимит.

Открыть как Markdown

Что это

Строка под промптом вашего CLI-агента. В шапке — имя панели и две цены: Session Cost — сколько стоила эта сессия, и Tree Cost — сколько стоила рабочая ветка целиком, по всем сессиям, которые на ней работали. Слева — папка, ветка, ключ, который платит, и модель с уровнем рассуждения. По центру — расход токенов по минутам, итог Σ и тонкая линия остатка. Справа — занятый контекст.

———— Kumo Router Usage ————          Session Cost $1.84   Tree Cost $12.4
my-project (main)                 │ ▂▃█▇▆▅▆▆██▇▆▃▃▃  Σ 12.9M │   session ctx
key Example Key  Opus (1M) High │ ━━━━── package 18.4M left cache 95%  46%

Tree Cost считается по паре «рабочее дерево + ветка»: панель держит в ~/.claude/statusline-state/ реестр последних известных сумм каждой сессии этой ветки и показывает их итог. Переключились на другую ветку — цена другая; вернулись — прежняя. Это ответ на вопрос «во что мне обошлась эта задача», а не «во что обошёлся этот чат».

Работает на Claude Code (панель под промптом) и на Codex (встроенная строка в подвале). Зависимостей нет — нужны только python3 (3.8+) и curl.

Установка

Одна строка в терминале:

curl -fsSL https://kumorouter.com/tools/kumo-usage/install.sh | bash

Установщик ничего не спрашивает. Он сам находит ваш ключ Kumo — в переменных окружения (KUMO_API_KEY, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY, OPENAI_API_KEY), затем в ~/.claude/settings.json, ~/.codex/config.toml и .env текущей папки, — спрашивает у аккаунта имя ключа и то, из чего он тратит, и заполняет конфиг. Секрет никуда не записывается: в файл попадает только имя переменной окружения.

Если ставить должен агент, отдайте ему готовый промпт: он лежит рядом, по адресу https://kumorouter.com/tools/kumo-usage/prompt.md, и его же копирует кнопка в кабинете.

Заметка

Настройки читаются при старте. Перезапустите Claude Code (или выполните /statusline) и Codex — до перезапуска панель не появится.

Что появляется на машине

~/.claude/kumo-usage/рендерер: `cc_statusline.py`, `providers.py`

~/.claude/statusline.jsonконфиг: `title`, `key_name`, `limit`, `kumo`

~/.claude/settings.jsonключ `statusLine`; прежний файл остаётся рядом как `.bak`

~/.codex/config.toml`[tui] status_line`; прежний файл остаётся рядом как `.bak`

Снимается тем же скриптом: curl -fsSL https://kumorouter.com/tools/kumo-usage/install.sh | bash -s -- --uninstall. Конфиг остаётся — удалите его руками, если он больше не нужен.

Четыре вида остатка

Kumo продаёт токены и деньги, поэтому линия под графиком считает одно из четырёх. Что именно — задаётся блоком limit в ~/.claude/statusline.json; при установке он заполняется сам по тому, из чего тратит ключ.

packageостаток купленного пакета, `cap` в токенах

moneyденьги на балансе (Pay As You Go), `cap` в долларах

keyваш потолок на этот ключ — в токенах или в долларах

projectпотолок на проект — в токенах или в долларах

{
  "title": "Kumo Router Usage",
  "key_name": "Example Key",
  "limit": { "kind": "package", "cap": 25000000, "unit": "auto" },
  "kumo": { "enabled": true, "key_env": "KUMO_API_KEY" }
}

unit — auto (пакет в токенах, остальное в долларах), tokens или usd. Линия зелёная, при остатке ≤ 30 % жёлтая, ≤ 10 % красная.

Откуда берётся число

По порядку, и порядок здесь — главное:

1. аккаунт Kumo, прочитанный тем же ключом, которым ходит агент. Только аккаунт знает пакет, баланс и то, что роутер действительно списал; 2. значение, вписанное в limit.remaining руками, — для машины, которой до аккаунта не дотянуться; 3. балансовый эндпоинт из блока router — для панели, направленной не на Kumo; 4. последним и с пометкой ≈ — cap минус расход, измеренный по транскриптам этой машины. Это оценка одного клиента, а не аккаунта, и панель об этом говорит.

Ключ уходит по сети ровно на один адрес — тот, что записан в kumo.url, — и читается в фоне: промпт сети не ждёт.

Диагностика

python3 ~/.claude/kumo-usage/cc_statusline.py --demo      # превью на фейковых данных
python3 ~/.claude/kumo-usage/cc_statusline.py --doctor    # конфиг, режим оплаты, ширина, аккаунт

Панель никогда не роняет промпт: при любой внутренней ошибке она печатает одну строку <модель> statusline error: …. Если панели нет вовсе — перезапустите агента; если --doctor пишет, что ключ не найден, положите его в переменную окружения, названную в kumo.key_env.

Полное описание и снимки экрана лежат рядом с установщиком: https://kumorouter.com/tools/kumo-usage/README.md.

SDK

Chat Completions