Эффективное управление затратами

​

Отслеживание ваших затрат

​

Использование команды /usage

Total cost:            $0.55
Total duration (API):  6m 20s
Total duration (wall): 6h 33m 10s
Total code changes:    0 lines added, 0 lines removed
Usage by model:
   claude-sonnet-4-6:  1.2k input, 5.3k output, 940.0k cache read, 50.0k cache write ($0.55)

​

Статистика кэша подсказок

Prompt cache (main):   14 requests · 91% of input tokens from cache · 2 misses (last 6m 10s ago, 310.2k tokens re-cached) · 1 expected rebuild (compaction or tool-result clearing) · warm (1h TTL, last activity 40s ago)

• Misses: запросы, которые повторно обработали содержимое, которое кэш уже содержал, с временем последнего промаха и количеством токенов, которые эти запросы записали обратно в кэш. Claude Code считает запрос промахом, когда запрос повторно обработал более 5% и по крайней мере 2000 токенов того, что он мог бы прочитать из кэша. Действия, которые инвалидируют кэш, перечисляют обычные причины. Когда Claude Code может определить вероятную причину последнего промаха, строка её называет, например likely cause: tool definitions changed. Текст вероятной причины требует Claude Code v2.1.260 или более поздней версии.
• Expected rebuilds: когда Claude Code сам только что переписал разговор, путём компактирования или путём очистки старых результатов инструментов из контекста, он считает тот же вид промаха как ожидаемое перестроение вместо этого. Эта часть появляется только после того, как произошло по крайней мере одно ожидаемое перестроение.
• Warm or cold: находится ли кэшированный префикс всё ещё в пределах своего времени жизни кэша, с действующим TTL. Когда кэш холодный, строка показывает, как долго сессия была неактивна. Когда ни один ответ не сообщил о токенах кэша, строка заканчивается no prompt caching reported by the API вместо этого.

​

Разбивка использования плана

• Attribution: недавнее использование, отнесённое к skills, subagents, plugins и отдельным MCP серверам, каждый показан в процентах от общего объёма. Доля MCP сервера учитывает только запросы, которые потребили один из результатов его инструментов. До версии v2.1.222 после одного вызова MCP сервера Claude Code относил каждый последующий запрос к этому серверу, завышая его долю.
• Behavior flags: поведения, такие как длинный контекст или промахи кэша, отмеченные, когда один из них составляет 10% или более недавнего использования.
• Loops: строка для каждой из самых тяжёлых /loop или других запланированных задач, которые недавно выполнялись, упорядоченные по общему количеству токенов, с подсчётом остальных. Claude Code сообщает, как часто каждая задача срабатывает, сколько раз она выполнялась, её общее и среднее количество токенов, и когда она в последний раз выполнялась. Claude Code ключает строку по подсказке задачи, поэтому цикл, который вы остановили и пересоздали, остаётся одной строкой. Требуется Claude Code v2.1.242 или более поздняя версия.

​

Проверка расходов кредитов использования

• Pro and Max: ваши расходы за текущий месяц, измеренные в сравнении с вашим ежемесячным лимитом расходов, когда вы установили один. Когда вы не установили лимит, строка показывает Unlimited и никакую цифру расходов.
• Team and Enterprise: ваши собственные расходы за текущий месяц, измеренные в сравнении с любым лимитом, установленным вашей организацией, который к вам применяется. Лимит, который охватывает всю организацию, не появляется в строке. Когда у вас нет собственного лимита, строка показывает ваши расходы без лимита рядом с ним. Пока кредиты использования отключены для вас, /usage не показывает строку кредитов использования.

​

Когда запрос использования не удаётся

​

Анализ ваших моделей использования

​

Добавление кредитов использования к вашей подписке

​

Управление затратами для вашей организации

​

Отчётность о расходах по вашим договорным ставкам

​

Claude for Teams и Enterprise

• Просмотр расходов: отчёт о расходах в аналитике организации показывает предполагаемые расходы по пользователям и по моделям с экспортом CSV, обновляется ежедневно. Отчёт охватывает расходы кредитов использования и появляется после включения кредитов использования. Использование в пределах лимита на одного пользователя не учитывается в долларах.
• Просмотр внедрения: панель аналитики показывает ежедневно активных пользователей, сеансы и метрики вклада с экспортом CSV данных о вкладе. См. отслеживание использования команды с помощью аналитики.
• Ограничение расходов: лимит на одного пользователя является потолком по умолчанию. Чтобы позволить членам продолжить работу после его достижения, включите кредиты использования и установите лимиты расходов на уровне организации, группы или отдельного члена команды.
• Получение данных по пользователям: на плане Enterprise Enterprise Analytics API возвращает отчёты об использовании и затратах по пользователям на всех поверхностях Claude, включая Claude Code. Основной владелец создаёт ключ с областью read:analytics на claude.ai/analytics/api-keys. На плане Teams экспортируйте CSV отчёт о расходах, который содержит использование токенов и предполагаемые расходы по пользователям и по моделям.

​

Claude Console

​

Рекомендации по ограничению скорости

​

Облачные провайдеры

• OpenTelemetry: экспортируйте метрики с машины каждого разработчика в ваш собственный стек наблюдаемости. Это даёт вам подсчёты токенов по пользователям, затраты и активность инструментов независимо от провайдера.
• Шлюз Claude apps: самостоятельно размещённый Claude apps gateway обеспечивает атрибуцию использования по пользователям, метрики OTLP с подсчётом токенов и лимиты расходов по пользователям на этих провайдерах.
• LLM gateway: маршрутизируйте весь трафик Claude Code через прокси, который отслеживает расходы по ключу. Несколько крупных предприятий сообщили об использовании LiteLLM, инструмента с открытым исходным кодом, который отслеживает расходы по ключу. Этот проект не связан с Anthropic и не был проверен на безопасность.

​

Когда разработчик спрашивает об ограничении

• “Вы достигли лимита сеанса” или “Вы достигли еженедельного лимита”: ограничение использования на основе места в окне подписки, совместно используемое на всех моделях, поэтому разработчик не может восстановить доступ, переключив модели с помощью /model. Сообщение показывает, когда окно сбросится. После сообщения “Вы достигли лимита Opus” или “Вы достигли лимита Sonnet”, переключение на модель вне этого семейства с помощью /model позволяет разработчику продолжить работу. См. ошибки лимита использования. Что разработчик может сделать в то же время:
  • Запустите /usage-credits, чтобы запросить использование сверх лимита, если у вас включены кредиты использования.
  • На Claude Code v2.1.234 или позже, ждите и продолжайте прерванную задачу автоматически после сброса лимита использования; этот раздел указывает, когда Claude Code начинает ожидание самостоятельно и когда разработчик выбирает его из /rate-limit-options. Чтобы контролировать для вашего парка, начинает ли Claude Code это ожидание самостоятельно, установите autoContinueAtUsageLimit в управляемых параметрах.
• “Вы достигли индивидуального лимита расходов”, “лимита ежемесячных расходов организации” или “общего бюджета команды”: запрос разработчика будет выставлен в счёт кредитам использования, и эти кредиты достигли лимита расходов, который вы установили. Чтобы позволить разработчику продолжить, перейдите в Параметры администратора > Использование и увеличьте лимит, который называет сообщение. Когда сообщение также называет время сброса плана, разработчик может вместо этого дождаться этого момента. См. справочник по ошибкам для каждого варианта.
• Сообщение об ограничении расходов от Claude apps gateway: разработчик превысил лимит расходов, который вы установили на своём самостоятельно размещённом шлюзе, и шлюз блокирует его запросы до сброса периода или повышения лимита. См. лимиты расходов шлюза для лимитов, расписания сброса и сообщения, которое видит разработчик.
• Предупреждение о контексте или auto-compact: не является лимитом использования. Разговор вырос близко к окну auto-compact сеанса, пороговому значению, где Claude Code суммирует более старую историю, чтобы освободить место. Направьте разработчика на снижение использования токенов.
• Неожиданно высокие расходы на плане API или облачного провайдера: обычно восходит к длительным сеансам, которые никогда не были очищены, или к Opus, оставленному в качестве модели по умолчанию. Наиболее эффективные привычки для совместного использования — это очистка между несвязанными задачами и соответствие модели работе, оба охватываются в снижение использования токенов.

​

Затраты на токены команды агентов

• Используйте Sonnet для товарищей по команде. Он обеспечивает баланс между возможностями и стоимостью для задач координации.
• Держите команды небольшими. Каждый товарищ по команде запускает своё собственное контекстное окно, поэтому использование токенов примерно пропорционально размеру команды.
• Держите spawn prompts сфокусированными. Товарищи по команде автоматически загружают CLAUDE.md, MCP servers и skills, но всё в spawn prompt добавляется к их контексту с самого начала.
• Очищайте команды после завершения работы. Активные товарищи по команде продолжают потреблять токены до тех пор, пока они не выйдут или сеанс не завершится.
• Команды агентов отключены по умолчанию. Установите CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 в вашем settings.json или переменной окружения, чтобы включить их. См. включение команд агентов.

​

Снижение использования токенов

​

Управление контекстом проактивно

• Очищайте между задачами: Используйте /clear для начала с чистого листа при переходе на несвязанную работу. Устаревший контекст тратит токены на каждое последующее сообщение. Используйте /rename перед очисткой, чтобы вы могли легко найти сессию позже, затем /resume для возврата к ней.
• Добавляйте пользовательские инструкции компактирования: /compact Focus on code samples and API usage говорит Claude, что сохранять во время суммирования. В новой сессии /compact выводит Not enough messages to compact., потому что еще нет истории разговора для суммирования.

# Compact instructions

When you are using compact, please focus on test output and code changes

​

Выберите правильную модель

​

Снижение накладных расходов MCP server

• Предпочитайте CLI инструменты, когда доступны: Инструменты, такие как gh, aws, gcloud и sentry-cli, более эффективны по контексту, чем MCP servers, потому что они не добавляют никакой список инструментов. Claude может запускать CLI команды напрямую.
• Отключайте неиспользуемые servers: Запустите /mcp для просмотра настроенных servers и отключите любые, которые вы не активно используете.

​

Установите плагины code intelligence для типизированных языков

​

Делегируйте обработку hooks и skills

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/filter-test-output.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
input=$(cat)
cmd=$(echo "$input" | jq -r '.tool_input.command')

# If running tests, filter to show only failures
if [[ "$cmd" =~ ^(npm test|pytest|go test) ]]; then
  filtered_cmd="$cmd 2>&1 | grep -A 5 -E '(FAIL|ERROR|error:)' | head -100"
  echo "$input" | jq --arg filtered "$filtered_cmd" \
    '{hookSpecificOutput: {hookEventName: "PreToolUse", permissionDecision: "allow", updatedInput: (.tool_input + {command: $filtered})}}'
else
  echo "{}"
fi

​

Переместите инструкции из CLAUDE.md в skills

​

Отрегулируйте расширенное мышление

​

Делегируйте многословные операции subagents

​

Управление затратами команды агентов

​

Пишите конкретные prompts

​

Работайте эффективно над сложными задачами

• Используйте plan mode для сложных задач: Нажмите Shift+Tab для входа в plan mode перед реализацией. Claude исследует кодовую базу и предлагает подход для вашего одобрения, предотвращая дорогостоящую переделку, когда первоначальное направление неправильно.
• Корректируйте курс рано: Если Claude начинает идти в неправильном направлении, нажмите Escape для немедленной остановки. Используйте /rewind или двойное нажатие Escape для восстановления разговора и кода к предыдущей контрольной точке.
• Дайте цели проверки: Включите тестовые случаи, вставьте скриншоты или определите ожидаемый вывод в вашем prompt. Когда Claude может проверить свою собственную работу, он ловит проблемы перед тем, как вам нужно запросить исправления.
• Тестируйте постепенно: Напишите один файл, протестируйте его, затем продолжайте. Это ловит проблемы рано, когда они дешевы в исправлении.

​

Использование токенов в фоновом режиме

• Суммирование разговора: Фоновые задания, которые суммируют предыдущие разговоры для функции claude --resume
• Обработка команд: Некоторые команды, такие как /usage, могут генерировать запросы для проверки статуса

​

Почему использование растёт в длительной сессии

• Длинный контекст: Claude Code отправляет вашу полную беседу с каждым запросом, и каждый раз, когда Claude использует инструменты, он отправляет ещё один запрос с этой партией результатов инструментов. С prompt caching Claude Code перечитывает эту историю по кэшированному тарифу токенов, поэтому однострочный вопрос в сессии, которая была открыта весь день, всё равно потребляет использование для всей беседы. См. Управляйте контекстом проактивно для способов сохранения вашего контекста в малом размере
• Промахи кэша: ваше первое сообщение после перерыва, превышающего время жизни кэша, промахивает кэш и переобрабатывает ваш полный контекст. Время жизни составляет один час на подписке и снижается до пяти минут, когда вы используете кредиты использования; на API ключе или облачном провайдере это пять минут по умолчанию. Чтобы сохранить время жизни в один час при использовании кредитов использования, выберите TTL самостоятельно. На планах Pro и Max, когда вы возобновляете большую сессию после длительного перерыва, Claude Code предлагает возобновить с резюме, чтобы более поздние запросы не несли полную историю
• Запланированные задачи: запланированная задача срабатывает по своему интервалу даже во время простоя сессии, отправляя ваш полный контекст каждый раз
• Сообщения между сессиями: Claude Code доставляет сообщение из другой вашей сессии как новый ход, когда эта сессия находится в режиме ожидания, отправляя ваш полный контекст каждый раз. Чтобы удерживать входящие сообщения вместо их доставки, установите crossSessionInbound на hold
• Проверки целей: пока фоновая работа держит активную цель в ожидании, Claude Code просит Claude проверить эту работу даже когда сессия находится в режиме ожидания, начиная новый ход, который отправляет ваш полный контекст. Claude Code начинает максимум три проверки в режиме ожидания на цель между вашими подсказками. До версии v2.1.246 проверки в режиме ожидания были неограниченными. Чтобы отключить проверки, установите CLAUDE_CODE_GOAL_CHECKIN_MINUTES на 0. Проверки в режиме ожидания требуют Claude Code v2.1.236 или позже
• Товарищи-агенты: каждый активный товарищ продолжает потреблять токены до выхода
• Компактность: /compact читает беседу, которую он суммирует, поэтому компактирование большого контекста само по себе является большим запросом. Когда вы хотите свежее начало вместо непрерывности, /clear ничего не стоит

​

Понимание изменений в поведении Claude Code

• Планы подписки (Pro, Max, Team, Enterprise): войдите на claude.ai, нажмите на ваши инициалы в нижнем левом углу и выберите Get help
• Выставление счетов Console (API): войдите на platform.claude.com, нажмите на ваши инициалы и выберите Get help