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

Отслеживайте использование токенов, устанавливайте лимиты расходов команды и снижайте затраты Claude Code с помощью управления контекстом, выбора модели, настроек расширенного мышления и предварительной обработки hooks.

Claude Code взимает плату в зависимости от потребления API токенов. Для информации о ценах плана подписки (Pro, Max, Team, Enterprise) см. claude.com/pricing. Затраты на разработчика сильно варьируются в зависимости от выбора модели, размера кодовой базы и паттернов использования, таких как запуск нескольких экземпляров или автоматизация.

В масштабах корпоративных развёртываний средняя стоимость составляет около $13 на разработчика в активный день и $150-250 на разработчика в месяц, при этом затраты остаются ниже $30 в активный день для 90% пользователей. Чтобы оценить расходы для вашей команды, начните с небольшой пилотной группы и используйте инструменты отслеживания ниже для установления базовой линии перед более широким развёртыванием.

На этой странице рассматривается, как отслеживать ваши затраты, управлять затратами для вашей организации и снижать использование токенов.

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

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

Блок Session в верхней части /usage показывает подробную статистику использования токенов для вашей текущей сессии. Цифра в долларах — это оценка, вычисленная локально на основе количества токенов и может отличаться от вашего фактического счёта. Для авторитетного выставления счётов см. страницу Usage в Claude Console.

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total duration (wall): 6h 33m 10.2s
Total code changes:    0 lines added, 0 lines removed

На плане Pro, Max, Team или Enterprise команда /usage также показывает разбивку того, что учитывается в пределах вашего плана. Она относит недавнее использование к skills, subagents, plugins и отдельным MCP серверам, каждый из которых показан в процентах от общего объёма. Нажмите d или w для переключения между последними 24 часами и последними 7 днями. Цифры являются приблизительными и вычисляются из локальной истории сессии на этом устройстве, поэтому использование с других устройств или claude.ai не включено.

Когда запрос к пределам вашего плана не удаётся, чаще всего потому, что конечная точка использования имеет ограничение по частоте запросов, /usage показывает последние полосы использования, которые она загрузила на этом устройстве в течение последних 60 минут, вместе с примечанием Showing last-known usage, указывающим, как давно эти данные были получены. Нажмите r для повторной попытки; успешная повторная попытка заменяет последние известные полосы свежими данными. Без снимка из последних 60 минут /usage сообщает, что конечная точка использования имеет ограничение по частоте запросов и предлагает тот же ярлык повторной попытки. До версии v2.1.208 ограниченный по частоте запрос в сессии, которая ещё не загружала использование, всегда показывал ошибку без полос.

В расширении VS Code та же разбивка появляется в диалоговом окне Account & usage с переключателем Day и Week. Требуется Claude Code v2.1.174 или более поздняя версия.

Установка лимита расходов на Pro и Max

На планах Pro и Max команда /usage-credits открывает диалоговое окно в CLI, где вы управляете кредитами использования. Из диалогового окна вы можете:

• Включить кредиты использования для вашего аккаунта
• Купить больше кредитов использования, либо предложенный пакет, либо пользовательскую сумму
• Установить, изменить или удалить ежемесячный лимит расходов
• Настроить автоматическую перезагрузку, которая автоматически покупает больше кредитов использования, когда ваш баланс падает ниже установленного вами порога

На версиях Claude Code до v2.1.207 и на аккаунтах, где диалоговое окно в CLI недоступно, /usage-credits открывает страницу выставления счётов за кредиты использования в вашем браузере. На планах Team и Enterprise члены с доступом к выставлению счётов получают ту же страницу браузера, а члены без доступа к выставлению счётов отправляют запрос из CLI, прося своего администратора включить кредиты использования или увеличить лимит.

Изменение ежемесячного лимита расходов требует доступа к выставлению счётов на аккаунте. Если вы достигнете лимита, пока у вас всё ещё есть доступные кредиты использования, Claude Code предложит вам увеличить или удалить его, чтобы вы могли продолжить без выхода из CLI.

Суммы, которые вы вводите в диалоговое окно, такие как пользовательская сумма покупки, ежемесячный лимит расходов или порог и целевое значение автоматической перезагрузки, должны быть цифрами, опционально за которыми следует точка и одна или две десятичные цифры, например 20 или 20.50. Любой другой ввод, включая запятые, показывает встроенную ошибку и не сохраняется. Версии до v2.1.207 не показывают диалоговое окно и открывают страницу выставления счётов.

Claude Code просит вас ввести yes для подтверждения каждой покупки и каждого изменения автоматической перезагрузки, независимо от суммы, и подтверждение покупки показывает итоговую сумму с налогом, которую вы одобряете. Изменение ежемесячного лимита расходов требует того же введённого подтверждения только выше $1,000 или выше 1,000 единиц валюты выставления счётов, отличной от доллара США. До версии v2.1.208 покупки и изменения автоматической перезагрузки использовали этот же порог, поэтому меньшие суммы проходили через стандартный поток диалогового окна без дополнительного введённого шага yes.

Поля сумм открываются с предложенным значением, и первая цифра, которую вы вводите, заменяет предложение вместо добавления к нему. Экран, который включает кредиты использования, открывается с выбранной опцией Cancel, поэтому их включение требует намеренного выбора, а не случайного нажатия Enter. Оба требуют Claude Code v2.1.208 или более поздней версии.

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

Какие элементы управления у вас есть, зависит от того, как ваша организация получает доступ к Claude Code: через план Claude for Teams или Enterprise, Claude Console или облачного провайдера. На планах Teams и Enterprise использование берётся из лимита каждого члена команды. На Console и у облачных провайдеров использование оплачивается за токен вашей организацией. Если ваша организация использует смешанные методы входа, каждый разработчик учитывается в соответствии с тем, с помощью которого он прошёл аутентификацию.

В таблице указано, где вы видите расходы, где их ограничиваете и как получить данные по пользователям для каждой конфигурации.

Экспорт OpenTelemetry работает на каждой конфигурации и является единственным вариантом, который передаёт метрики токенов и затрат по пользователям в ваш собственный стек наблюдаемости практически в реальном времени.

Claude for Teams и Enterprise

На планах Claude for Teams и Enterprise использование Claude Code каждого члена команды берётся из лимита на одного пользователя, который сбрасывается в скользящем пятичасовом окне и еженедельном окне. Лимит совместно используется с Claude chat и Cowork, а его размер зависит от уровня места (Standard или Premium). Ваши элементы управления находятся в консоли администратора claude.ai, а не в Claude Console.

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

Руководство по потреблению Claude Enterprise является справочником по планированию для администраторов. Оно объясняет, как потребление отличается на Claude chat, Claude Code и Cowork, и даёт начальные точки в долларах на пользователя для бюджетирования. Выделите больше средств на место для кодирования, чем на место для чата: каждый ход Claude Code содержит содержимое файлов, вызовы инструментов и многошаговое рассуждение, поэтому один сеанс отладки может потребить больше, чем день чата.

Claude Console

Организации API управляют расходами Claude Code через рабочие пространства. Вы можете установить лимиты расходов рабочего пространства на общие расходы Claude Code и просмотреть отчёты о затратах и использовании в Console.

Для отчётности по пользователям панель управления Console показывает расходы и принятые строки на члена команды, а Claude Code Analytics API возвращает те же ежедневные метрики по пользователям программно с помощью Admin API ключа. См. аналитика для клиентов API.

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

При настройке Claude Code для команд учитывайте эти рекомендации по Token Per Minute (TPM) и Request Per Minute (RPM) на пользователя в зависимости от размера вашей организации:

Например, если у вас есть 200 пользователей, вы можете запросить 20k TPM для каждого пользователя, или 4 миллиона общего TPM (200*20,000 = 4 миллиона).

TPM на пользователя уменьшается по мере роста размера команды, потому что в более крупных организациях меньше пользователей, как правило, используют Claude Code одновременно. Эти ограничения скорости применяются на уровне организации, а не для отдельного пользователя, что означает, что отдельные пользователи могут временно потреблять больше, чем их рассчитанная доля, когда другие не активно используют сервис.

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

На Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry Claude Code оплачивается за токен на ваш облачный счёт, и элементы управления расходами находятся в консоли биллинга вашего облачного провайдера. Claude Code не отправляет метрики из вашего облака обратно в Anthropic, поэтому панели аналитики и Claude Code Analytics API не охватывают это использование.

Для атрибуции затрат по пользователям у вас есть три варианта:

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

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

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

• "Вы достигли лимита сеанса" или "Вы достигли еженедельного лимита": ограничение использования на основе места в окне подписки. Эти окна совместно используются на всех моделях, поэтому переключение моделей с помощью /model не восстанавливает доступ, хотя это позволяет разработчику продолжить работу после сообщения "Вы достигли лимита Opus". Сообщение показывает, когда окно сбросится, и разработчик может запустить /usage-credits, чтобы запросить использование сверх лимита, если у вас включены кредиты использования. См. ошибки лимита использования.
• Предупреждение о контексте или auto-compact: не является лимитом использования. Разговор вырос близко к максимальному размеру входа модели, и Claude Code суммирует более старую историю, чтобы освободить место. Направьте разработчика на снижение использования токенов.
• Неожиданно высокие расходы на плане API или облачного провайдера: обычно восходит к длительным сеансам, которые никогда не были очищены, или к Opus, оставленному в качестве модели по умолчанию. Наиболее эффективные привычки для совместного использования — это очистка между несвязанными задачами и соответствие модели работе, оба охватываются в снижение использования токенов.

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

Команды агентов запускают несколько экземпляров Claude Code, каждый со своим собственным контекстным окном. Использование токенов масштабируется в зависимости от количества активных товарищей по команде и того, как долго каждый из них работает.

Чтобы сохранить затраты команды агентов управляемыми:

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

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

Затраты на токены масштабируются с размером контекста: чем больше контекста обрабатывает Claude, тем больше токенов вы используете. Claude Code автоматически оптимизирует затраты через prompt caching, что снижает затраты на повторяющееся содержимое, такое как системные prompts, и auto-compact, что суммирует историю разговора при приближении к лимитам контекста.

Следующие стратегии помогают вам сохранять контекст небольшим и снижать затраты на сообщение.

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

Используйте /usage для проверки текущего использования токенов или настройте вашу строку состояния для непрерывного отображения.

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

Вы также можете настроить поведение компактирования в вашем CLAUDE.md файле в корне вашего проекта:

# Compact instructions

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

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

Sonnet хорошо справляется с большинством задач кодирования и стоит дешевле, чем Opus. Зарезервируйте Opus для сложных архитектурных решений или многошаговых рассуждений. Используйте /model для переключения моделей в середине сессии или установите значение по умолчанию в /config. Для простых задач subagent укажите model: haiku в вашей конфигурации subagent.

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

Определения инструментов MCP отложены по умолчанию, поэтому только имена инструментов входят в контекст до тех пор, пока Claude не использует конкретный инструмент. Запустите /context для просмотра того, что потребляет пространство.

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

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

Плагины code intelligence дают Claude точную навигацию по символам вместо поиска на основе текста, снижая ненужные чтения файлов при изучении незнакомого кода. Один вызов "go to definition" заменяет то, что в противном случае могло бы быть grep, за которым следует чтение нескольких файлов-кандидатов. Установленные языковые серверы также автоматически сообщают об ошибках типов после редактирования, поэтому Claude ловит ошибки без запуска компилятора.

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

Пользовательские hooks могут предварительно обрабатывать данные перед тем, как Claude их увидит. Вместо того, чтобы Claude читал файл логов из 10,000 строк для поиска ошибок, hook может выполнить grep для ERROR и вернуть только совпадающие строки, снижая контекст с десятков тысяч токенов до сотен.

Skill может дать Claude знание предметной области, чтобы ему не пришлось исследовать. Например, skill "codebase-overview" может описать архитектуру вашего проекта, ключевые директории и соглашения об именовании. Когда Claude вызывает skill, он получает этот контекст немедленно вместо того, чтобы тратить токены на чтение нескольких файлов для понимания структуры.

Например, этот hook PreToolUse фильтрует вывод тестов для отображения только сбоев:

{
"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 "{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"allow\",\"updatedInput\":{\"command\":\"$filtered_cmd\"}}}"
else
echo "{}"
fi

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

Ваш файл CLAUDE.md загружается в контекст при запуске сессии. Если он содержит подробные инструкции для конкретных рабочих процессов (такие как PR reviews или миграции баз данных), эти токены присутствуют даже когда вы выполняете несвязанную работу. Skills загружаются по требованию только при вызове, поэтому перемещение специализированных инструкций в skills сохраняет ваш базовый контекст меньшим. Стремитесь сохранять CLAUDE.md под 200 строк, включая только необходимое.

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

Расширенное мышление включено по умолчанию, потому что оно значительно улучшает производительность на сложных задачах планирования и рассуждения. Токены мышления выставляются как выходные токены, и бюджет по умолчанию может быть десятки тысяч токенов на запрос в зависимости от модели. Для более простых задач, где глубокое рассуждение не требуется, вы можете снизить затраты, понизив уровень усилий с помощью /effort или в /model, отключив мышление в /config, или, на моделях с фиксированным бюджетом мышления, понизив бюджет путём установки переменной окружения MAX_THINKING_TOKENS environment variable, например MAX_THINKING_TOKENS=8000. Модели адаптивного рассуждения игнорируют ненулевые бюджеты, поэтому используйте вместо этого уровни усилий. Отключение мышления недоступно на Fable 5, которая всегда использует расширенное мышление.

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

Запуск тестов, получение документации или обработка файлов логов может потребить значительный контекст. Делегируйте эти subagents, чтобы многословный вывод оставался в контексте subagent, в то время как только резюме возвращается в вашу основную беседу.

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

Команды агентов используют примерно в 7 раз больше токенов, чем стандартные сессии, когда товарищи по команде работают в plan mode, потому что каждый товарищ по команде поддерживает своё собственное контекстное окно и работает как отдельный экземпляр Claude. Держите задачи команды небольшими и самостоятельными, чтобы ограничить использование токенов на товарища по команде. См. команды агентов для деталей.

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

Расплывчатые запросы, такие как "улучшить эту кодовую базу", запускают широкое сканирование. Конкретные запросы, такие как "добавить проверку входных данных в функцию входа в auth.ts", позволяют Claude работать эффективно с минимальными чтениями файлов.

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

Для более длительной или сложной работы эти привычки помогают избежать потраченных впустую токенов от неправильного направления:

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

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

Claude Code использует токены для некоторой фоновой функциональности даже когда неактивен:

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

Эти фоновые процессы потребляют небольшое количество токенов (обычно менее $0.04 за сессию) даже без активного взаимодействия.

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

Claude Code регулярно получает обновления, которые могут изменить способ работы функций, включая отчётность о затратах. Запустите claude --version для проверки вашей текущей версии. Для конкретных вопросов выставления счётов свяжитесь с поддержкой Anthropic через вашу учётную запись Console.