К основному содержанию
скилл CX Codex

cost-session — скилл для Claude Code: что делает и как установить

Скилл cost-session для Claude Code детализирует затраты на каждое сообщение внутри сессии, показывая дорогие запросы.

MIT 249 установок ★ 82 234 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add ruvnet/ruflo --skill cost-session -a claude-code
Открыть на GitHub

Что делает cost-session

Скилл запускает [scripts/session.mjs](../../scripts/session.mjs), чтобы разобрать JSONL-файл сессии и найти самые дорогие сообщения по числу токенов, кэшу и эскалации моделей. Он вычисляет медианные значения p50, p90 и p99, а также выделяет аномальные сообщения, превышающие p99 в два раза.

Инструмент требует разрешенный инструмент Bash для работы со скриптами. Если сессия не найдена в директориях проектов, выполнение завершается с ошибкой и кодом 2.

Для работы скилла нужен Node.js и установленная среда Claude Code.

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

  • детализировать стоимость сообщений сессии
  • найти дорогие запросы по токенам и кэшу
  • вычислить медианные перцентили стоимости p50 и p99
  • отфильтровать сессию по времени с флагом --since

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

  • Разбери сессию --session-id <id> по сообщениям
  • Покажи топ 10 дорогих сообщений сессии
  • Выведи стоимость сообщений с --since 2026-06-16T13:00:00Z

Как установить cost-session

1Через Skills CLI (Vercel)

npx skills add ruvnet/ruflo --skill cost-session -a claude-code

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

~/.claude/skills/cost-session/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/cost-session/

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

Вопросы о cost-session

Как установить cost-session в Claude Code?

Выполните команду npx skills add ruvnet/ruflo --skill cost-session -a claude-code, затем проверьте файл ~/.claude/skills/cost-session/SKILL.md.

Что делает cost-session?

Разбирает сессию по сообщениям, рассчитывает стоимость по токенам и кэшу, выводит перцентили стоимости и находит аномально дорогие запросы.

Что нужно для работы cost-session?

Для работы скилла необходим разрешенный инструмент Bash, Node.js и сохраненные JSONL-файлы сессий в ~/.claude/projects/*/.

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

SKILL.md · MIT
---
name: cost-session
description: Per-message cost breakdown within a single session. The drill-down companion to cost-anomaly — when an outlier session is flagged, this surfaces the specific expensive messages so operators can see whether the cost came from output tokens, cache writes, or model escalations.
argument-hint: "[--session-id <id>] [--top 20] [--since <iso-ts>] [--format table|json]"
allowed-tools: Bash
disable-model-invocation: true
---

When cost-anomaly flags a session as a >3.5σ outlier, the next question
is "which MESSAGES were expensive?". cost-session answers that.

| Question | Skill |
|---|---|
| "Which sessions cost the most?" | `cost-conversation` |
| "Which sessions are outliers?" | `cost-anomaly` |
| **"Which messages in THIS session were expensive?"** | **`cost-session`** ← this |

## Algorithm

Implementation: [`scripts/session.mjs`](../../scripts/session.mjs).

1. Resolve session jsonl: `--session-id <id>` (scans `~/.claude/projects/*/`)
   or `--latest` (default; picks most-recently-modified jsonl).
2. Parse all assistant messages with `usage` blocks.
3. Cost each message via shared PRICING (`_prices.mjs`).
4. Sort descending by `cost_usd`, surface top-N (default 20).
5. Compute p50/p90/p99 of message costs for in-session percentile context.
6. Flag the top message if it's >2× the p99 — that's an in-session outlier.

## Why this matters: cache writes are the silent cost

Example real session, top message:
```
| # | Model    | In | Out | Cache W | Cache R | Cost      |
| 1 | opus-4-7 | 6  | 569 | 881898  | 0       | $16.58    |
```

Without the **Cache W** column it looks like "569 output tokens cost
$16" — that's wrong by 380×. The actual cost is ephemeral 1h cache
write at opus pricing: 881,898 tokens × $18.75/1M = $16.54.

Operators reading the table see immediately: "the model wrote 881K
tokens to ephemeral cache". From there the question becomes "why did
we cache 881K tokens of context for a 6-input request?" — that's a
real engineering signal.

## Drill-down workflow

```bash
# Step 1: find outliers across all sessions
cost anomaly --alert-on-outliers 1 || cost anomaly  # see which session-ids

# Step 2: drill into the flagged session
cost session --session-id <flagged-id> --top 10

# Step 3: open that jsonl at the timestamp the top message reports,
# inspect the prompt + tool calls
```

## Percentile context

Top of output:
```
| p50 (median) message | $0.85 |
| p90 message          | $1.45 |
| p99 message          | $1.74 |
```

Lets operators ask "is this top message a 2× outlier or a 380× one?"
without having to compute it themselves. The "top is >2× p99" footer
fires when the answer is "yes, this is an in-session outlier worth
investigating".

## --since filter

Useful for drilling into a specific time range within a long session:

```bash
cost session --since 2026-06-16T13:00:00Z --top 5
```

Only messages with `timestamp >= --since` are considered.

## Edge cases

- No costed assistant messages → "_No costed assistant messages_" + exit 0.
- `--session-id` not found in any project's jsonls → exit 2 with error.
- `--top` must be a positive integer → exit 2.

© ruvnet · MIT · ruvnet/ruflo

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
cost-breakdown hoangsonww Скилл cost-breakdown разбирает расходы на модели и сессии, показывает дневную динамику и использование токенов. Пригодится, чтобы сравнить стоимость моделей или спланировать бюджет. CX Codex +1 ★ 1 198звёзд репо session-metrics centminmod Скилл session-metrics считает расход токенов и примерную стоимость сессии Claude по её JSONL-журналу: по ходам, с накопленным итогом. CX Codex +1 ★ 2 744звёзд репо codeburn-claude-cost-dashboard reason-machines Скилл codeburn-claude-cost-dashboard запускает терминальный дашборд CodeBurn для подсчёта токенов и расходов в Claude Code. Читает локальные логи сессий без внешних прокси и ключей API. CX Codex +1 554установок session-report официальный Anthropic Скилл session-report для Claude Code и других платформ создаёт HTML-отчёт о расходе токенов, кэше, субагентах и дорогих промптах по логам Claude Code. Отчёт отмечает аномалии расхода токенов. CX Codex +1 3 676установок cost getagentseal Скилл cost для Claude Code и Codex показывает расходы на AI-кодинг за сегодня. Он разбирает траты по моделям и проектам и отмечает необычные значения. CX Codex +1 ★ 11 881звёзд репо claude-session-manager sugarforever Скилл claude-session-manager превращает локальные JSONL-логи Claude Code в читаемые Markdown-файлы с разговором, дайджестом и вызовами инструментов. CX Codex +1 207установок

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

Весь набор →
gaia-submission Скилл gaia-submission ведёт запуск бенчмарка GAIA от проверки ключей до сборки пакета для лидерборда HAL. Пригодится при замере качества агента и подготовке результатов к отправке. CX Codex +1 436установок gaia-debugging Скилл gaia-debugging разбирает, почему задача из бенчмарка GAIA провалилась: достаёт трейс, классифицирует ошибку и предлагает исправление. Запускается, когда gaia-bench run вернул failed или неверный ответ для task_id. CX Codex +1 436установок gaia-architecture-comparison Скилл gaia-architecture-comparison для Claude Code, Codex, Cursor, Copilot и Gemini CLI, который сравнивает harness ruflo с эталонной реализацией HAL от Princeton по девяти параметрам — от покрытия вопросов до исполнения кода. CX Codex +1 433установок nested-subagents Скилл nested-subagents для Claude Code строит дерево субагентов, где каждый ребёнок может породить своих детей. Разносит промежуточное состояние, не помещающееся в контекст одного агента. CX Codex +1 317установок cost-projection Скилл cost-projection для Claude Code прогнозирует расходы по недавним сессиям. Показывает темп трат, суммы на заданные периоды и срок до достижения лимита. CX Codex +1 249установок cost-health Скилл cost-health гоняет четыре проверки расходов параллельно и отдаёт один статус: бюджет, ускорение трат, аномалии сессий и прогноз исчерпания. CX Codex +1 249установок cost-counterfactual Скилл cost-counterfactual сравнивает реальные траты на сессии с гипотетическими сценариями always-haiku, always-sonnet и always-opus. Помогает понять, окупается ли роутер моделей. CX Codex +1 249установок cost-diff Скилл cost-diff для Claude Code сравнивает два JSON-снимка расходов. Запускается, чтобы проверить, увеличила ли PR-ветка затраты относительно базового снимка. CX Codex +1 248установок

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

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