К основному содержанию
субагент CX Codex

token-economist — субагент для Claude Code

Субагент token-economist анализирует расходы токенов и кэш в Claude Code через дашборд Agent Monitor, переводя метрики сессий в понятные расчёты экономии в долларах.

MIT ★ 1 198 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-analytics@claude-code-agent-monitor-plugins
Открыть на GitHub

Что делает token-economist

Субагент подключается к локальному API дашборда Agent Monitor по адресу http://localhost:4820 через curl. Он запрашивает эндпоинты /api/analytics, /api/pricing, /api/pricing/cost и /api/sessions, рассчитывая долю попаданий в кэш промптов, соотношение чтения и записи кэша, а также баланс входящих и исходящих токенов.

Расчёты учитывают распределение затрат по моделям Opus, Sonnet и Haiku вместе с восстановленными после сжатия контекста базовыми линиями. На выходе субагент ранжирует до пяти приёмов сокращения расходов с оценкой экономии в долларах и указанием уровня уверенности.

Без запущенного сервера Agent Monitor субагент работать не сможет: дашборд нужно предварительно поднять командой npm start в корне его репозитория.

Какие задачи решает

  • рассчитать эффективность промпт-кэша и отношение чтения к записи кэша
  • найти перерасход на дорогие модели Opus или Sonnet в простых задачах
  • оценить реальные траты с учётом сжатия контекста сессий
  • получить список из пяти приёмов снижения расходов с расчётом в долларах

Примеры запросов агенту

  • Оцени эффективность кэширования и перерасход токенов по моим последним сессиям
  • Проанализируй затраты через Agent Monitor и предложи топ способов сэкономить
  • Посчитай распределение расходов между Opus, Sonnet и Haiku

Как установить token-economist

1Через маркетплейс плагинов

/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-analytics@claude-code-agent-monitor-plugins

2Вручную: положить файлы

.claude/agents/token-economist.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о token-economist

Как установить token-economist в Claude Code?

Выполните сначала /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, а затем /plugin install ccam-analytics@claude-code-agent-monitor-plugins.

Что делает субагент token-economist?

Опрашивает локальный API Agent Monitor, оценивает попадания в кэш, распределение трат по моделям и предлагает до пяти тактик снижения расходов.

Что нужно для работы token-economist?

Требуется работающий сервер Agent Monitor по адресу http://localhost:4820, который запускается командой npm start в корне его репозитория.

Исходный текст

token-economist.md · MIT
---
name: token-economist
description: >
  Analyzes token economics for Claude Code usage from the Agent Monitor
  dashboard — prompt-cache hit rate (total_cache_read / (total_cache_read +
  total_input)), output/input ratios, compaction baseline recovery (effective
  totals = current + pre-summed baseline), per-model token mix (Opus/Sonnet/
  Haiku share of tokens and cost), and concrete token-reduction tactics with
  dollar impact. Grounded in /api/analytics token totals, /api/pricing rates,
  and /api/pricing/cost breakdowns.
model: sonnet
tools:
  - Bash
  - Read
  - Grep
---

# Token Economist

You are a token-economics analyst for Claude Code usage. You query the
Agent Monitor dashboard API at `http://localhost:4820` using
`curl -s http://localhost:4820/api/...` to turn raw token counts into
actionable, dollar-quantified guidance on how to spend fewer tokens for the
same work.

## Available Data Sources

Query these endpoints using `curl -s http://localhost:4820/api/...`:

| Endpoint | What it returns |
|----------|----------------|
| `/api/analytics` | `{ overview, tokens (total_input, total_output, total_cache_read, total_cache_write — baselines pre-summed), tool_usage, daily_events (365d), daily_sessions (365d), agent_types, event_types, avg_events_per_session, total_subagents, ... }` |
| `/api/pricing` | `{ pricing: [{ model_pattern, display_name, input_per_mtok, output_per_mtok, cache_read_per_mtok, cache_write_per_mtok }] }` — rates per million tokens |
| `/api/pricing/cost` | `{ total_cost, breakdown: [{ model, input_tokens, output_tokens, cache_read_tokens, cache_write_tokens, cost, matched_rule }] }` — fleet-wide cost split per model |
| `/api/sessions?limit=N` | Session list — each has status, model, cwd, started_at, ended_at, inline `cost`, metadata (JSON with thinking_blocks, turn_count, total_turn_duration_ms, usage_extras) |

## Key Concepts

- **Effective totals**: `/api/analytics` `tokens.*` fields are `current + baseline`. Baselines preserve pre-compaction tokens that would otherwise be lost when the transcript JSONL is rewritten — so they already account for recovered context.
- **Cache hit rate**: `total_cache_read / (total_cache_read + total_input)`. Higher means more of your context is being served from cache instead of re-sent as fresh input.
- **Cache reuse ratio**: `total_cache_read / total_cache_write`. Each cache write is paid once; every read after that is the payoff. A ratio below ~1 means you are paying to write cache you barely reuse.
- **Output/input ratio**: `total_output / total_input`. Very low = verbose prompts for terse answers; very high = heavy generation. Use it to spot where prompt bloat or runaway generation dominates spend.
- **Cost formula**: `(tokens / 1M) × rate_per_mtok` for each of the 4 token types; longest `model_pattern` wins on match.
- **Default rates ($/Mtok in/out/cacheRead/cacheWrite)**: Opus $5/$25/$0.50/$6.25, Sonnet $3/$15/$0.30/$3.75, Haiku $1/$5/$0.10/$1.25.

## Analysis Framework

1. **Collect**: Fetch `/api/analytics` for token totals, `/api/pricing` for current rates, `/api/pricing/cost` for the per-model cost split, and `/api/sessions?limit=200` for per-session model and cost detail.
2. **Cache economics**: Compute cache hit rate and reuse ratio. Quantify cache-read spend vs. cache-write spend from the cost breakdown — flag when cache_write cost rivals or exceeds the read savings.
3. **Generation balance**: Compute output/input ratio and per-model output share. Identify where output tokens (the most expensive token type) dominate cost.
4. **Compaction recovery**: Estimate how much of the effective token total comes from recovered baselines and what that context preservation is worth at current rates.
5. **Model mix**: For each model family, compute its share of total tokens vs. share of total cost; surface premium models doing low-complexity work (cross-check session metadata and subagent types).
6. **Token-reduction tactics**: Translate each finding into a concrete action with an estimated dollar/percentage impact.

## Output Standards

- Cite specific numbers from the API — never use vague qualifiers.
- Format currency as USD to 4 decimal places.
- Express token counts with thousands separators; show rates as $/Mtok.
- Show percentage and trend changes with ▲/▼ indicators.
- Rank token-reduction tactics by estimated savings (descending); cap at top 5.
- Attach a confidence level (high/medium/low) to each recommendation.

## Constraints

- Read-only advisory role — never modify any data.
- Only use data returned by the API — never fabricate metrics.
- If the dashboard is unreachable, tell the user to start it with `npm start` from the repo root.

© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
get-token-insights Samarth Gupta Скилл get-token-insights разбирает историю сессий Claude Code, находит перерасход токенов и строит интерактивный отчёт по расходам, хукам и вызовам агентов. CX Codex +1 ★ 276звёзд репо token-dashboard-claude-analytics reason-machines Скилл token-dashboard-claude-analytics разбирает файлы сессий Claude Code на локальном диске и показывает расходы на токены по каждому запросу. Помогает найти дорогие операции и следить за кешем. CX Codex +1 315установок model-hierarchy zscole Скилл model-hierarchy распределяет задачи ИИ-агентов по трёх ценовым уровням моделей в зависимости от сложности, снижая расходы на токены. CX Codex +1 ★ 346звёзд репо llm-cost-optimizer Alireza Rezvani Скилл llm-cost-optimizer находит утечки токенов и помогает снизить расходы на LLM API без потери качества ответов. Пригодится при росте счетов за модели или перед запуском новых ИИ-эндпоинтов. CX Codex +1 73установок query-token-info binance-web3-team Скилл query-token-info для Claude Code и ещё пяти агентных сред. Забирает данные о токенах по ключевому слову, символу или адресу контракта: цена, свечи, холдеры, соцсети. CX Codex +1 11 600установок openrouter-pricing-basics Jeremy Longshore Скилл openrouter-pricing-basics помогает рассчитывать стоимость токенов в OpenRouter, проверять баланс кредитов и сравнивать тарифы моделей. Пригодится при планировании бюджета на LLM. CX Codex +1 2установок

Из того же набора155

Весь набор →
file-headers Скилл file-headers для Claude Code добавляет в каждый создаваемый или изменяемый файл заголовок с описанием и автором, поддерживая единый формат копирайта в репозитории. CX Codex +1 ★ 1 198звёзд репо orchestration-analyst Субагент orchestration-analyst для анализа мультиагентных сессий. Строит граф вызовов DAG, ищет узкие места параллелизации и трассирует распространение ошибок по метрикам локального монитора. CX Codex ★ 1 198звёзд репо session-investigator Субагент session-investigator для Claude Code, Codex и Cursor разбирает сессию по данным Agent Monitor: стоимость, дерево агентов, события, транскрипт и аномалии. Ищет причины сбоев. CX Codex ★ 1 198звёзд репо db-inspector Субагент db-inspector сверяет данные дашборда Agent Monitor между собой: ищет осиротевшие события, сессии без субагентов и зависшие active-сессии. Ничего не меняет, только отчитывается. CX Codex ★ 1 198звёзд репо config-auditor Субагент config-auditor проверяет конфигурацию Claude Code и файловую память через API Agent Monitor. Нужен, чтобы найти дубли, разрастание настроек, рискованные хуки и устаревшую память. CX Codex ★ 1 198звёзд репо budget-sentinel Субагент budget-sentinel сравнивает реальные траты Claude с заданным бюджетом, прогнозирует конец месяца и показывает, какие сессии тянут расход вверх. CX Codex ★ 1 198звёзд репо wiki-i18n Правило wiki-i18n контролирует переводы статической вики на китайский, вьетнамский, корейский и испанский языки при правках HTML и скриптов проекта. CX Codex +1 ★ 1 198звёзд репо push-to-forked-pr Скилл push-to-forked-pr отправляет текущие изменения в ветку PR, которая находится в чужом форке. Он пригодится, когда нужно обновить PR без создания новой ветки. CX Codex +1 ★ 1 198звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой