Правила и документация проверены 5 ноября 2026 года. Все примеры для терминала написаны на Bash и подходят для macOS, Linux и других сред разработки с Bash.
После оформления Max, Ultra или Team подарочные API-кредиты нужно сначала связать с организацией Claude Console. После этого их можно использовать в собственных программах и агентах.
Весь процесс можно пройти в следующем порядке:
Проверить право на получение → связать организацию Console → проверить подарочный баланс → создать API key → отправить небольшой запрос → проверить организацию и записи об использовании → настроить claude -p.
Главное — согласовать аккаунт подписки, организацию Console, API key и фактический путь биллинга запроса. Ответ модели подтверждает лишь успешность запроса. Чтобы установить, какая организация и какой баланс использованы, нужны дополнительные проверки.
1. Проверьте размер кредитов и кто может их получить
Текущая программа ежемесячных API-кредитов предусматривает следующие суммы:
| Тариф или место | Ежемесячные API-кредиты | Куда поступают |
|---|---|---|
| Max | 100 долларов США | Одна связанная организация Console |
| Ultra | 200 долларов США | Одна связанная организация Console |
| Team Standard | 20 долларов США за место | Общий пул команды |
| Team Premium | 100 долларов США за место | Общий пул команды |
| Вся команда Team | Не более 500 долларов США | Один общий баланс организации |
Например, для 3 мест Standard и 2 мест Premium номинальная ежемесячная сумма составит:
3 × 20 + 2 × 100 = 260 долларов СШАДаже для 10 мест Premium действует общий предел команды — 500 долларов США в месяц.
Перед получением необходимо выполнить два условия: подписка должна быть активной и в надлежащем состоянии, а новый подписчик должен пользоваться подходящим тарифом не менее семи дней. Подписки, купленные через iOS или Android, тоже участвуют, но получать кредиты нужно через веб-интерфейс. Предварительно добавлять платёжную карту в Claude Platform не требуется.
Официальные правила ежемесячных кредитов · Получение и применение кредитов на платформе
Кроме того, проверьте права с обеих сторон:
| Где | Необходимая роль |
|---|---|
| В подписке Max / Ultra | Сам подписчик |
| В подписке Team | Primary Owner или Owner |
| В организации Console, получающей кредиты | Owner, Admin или Billing |
Эти семь дней — условие получения API credits. Из него нельзя выводить срок завершения автоматической верификации Ultra.
2. Свяжите организацию Console и получите кредиты через веб-интерфейс
Для Max и Ultra откройте:
Для Team владелец Owner или Primary Owner открывает:
Выполните следующие действия:
- Найдите раздел API credits.
- Нажмите Link organization.
- Выберите организацию Claude Console, которая будет получать кредиты. Если организации ещё нет, создайте её по инструкции на странице.
- Проверьте название организации и для чего она действительно будет использоваться.
- Прочитайте соответствующие условия и подтвердите привязку.
- Откройте страницу Billing в Console и проверьте зачисление кредитов.
Обязательно выберите правильную организацию до подтверждения. По текущим правилам одну подписку можно связать только с одной организацией Console, а одна организация может получать этот бонус только от одной подписки. Самостоятельно изменить связь после этого нельзя: потребуется обратиться в поддержку.
Участникам Team не нужно получать кредиты по отдельности. Уполномоченный руководитель связывает организацию, после чего участники с API key этой организации расходуют общий баланс.
Если раздел получения не отображается, сначала проверьте тариф, длительность подписки, текущий аккаунт и роли с обеих сторон, затем обратитесь в официальную поддержку.
3. Где смотреть баланс и какие показатели записывать
После получения откройте:
Сначала откройте Promotional credits и запишите:
- Сумму текущего подарочного зачисления;
- Отображаемый доступный остаток;
- Дату окончания действия;
- Текущую выбранную организацию Console.
Затем отдельно проверьте купленный баланс и настройки Auto-reload.
Ежемесячные кредиты расходуются раньше купленных. Неиспользованный остаток истекает в конце соответствующего периода и не переносится. При годовой оплате зачисления также происходят ежемесячно. Особое внимание уделите автоматическому пополнению: оно срабатывает по купленному балансу, поэтому пополнение возможно, даже если подарочные кредиты ещё остались.
При сверке держите отдельно три вида показателей:
| Показатель | На какой вопрос отвечает |
|---|---|
| Баланс, подарочные зачисления и срок действия в Billing | Сколько осталось, откуда поступило и когда истекает |
| usage в ответе на запрос | Сколько токенов использовал этот запрос |
| Отчёты Usage / Cost или оценка стоимости CLI | Где возник расход и какова его примерная или фактическая стоимость |
usage нельзя считать долларовым балансом. Значение total_cost_usd в CLI также не доказывает, что стоимость уже списана с подарочных кредитов. Текущие показатели Cost Analytics отражают стоимость до зачёта credits, а отчёты могут обновляться с задержкой.
4. Создайте API key в правильном workspace
Откройте:
Для самостоятельной практики можно действовать так:
- Убедитесь, что в Console выбрана именно организация, получающая подарочные кредиты.
- Нажмите Create key.
- Укажите узнаваемое название, например monthly-credit-demo.
- При необходимости задайте срок действия.
- В Linked account выберите собственный аккаунт, чтобы создать personal key.
- Выберите обычный API workspace, к которому у вас уже есть разрешённый доступ, и создайте ключ, ограниченный этим одним workspace.
- Сохраните ключ, показанный при создании, и запишите организацию, workspace и название ключа.
Полностью ключ показывается только один раз — при создании. Для личной разработки достаточно personal key. Для общего сервиса или production-системы можно выбрать service account в соответствии с требованиями организации.
Есть ещё два важных нюанса прав доступа:
- Право получать кредиты не означает права создавать ключи. Роль Billing в основном отвечает за счета и использование; создание ключа требует соответствующих прав в организации и workspace.
- Создавать workspace может администратор организации. Обычным участникам следует выбирать уже доступный workspace. Если кнопка недоступна, попросите администратора проверить роль и членство.
Не выбирайте специальный workspace Claude Code для ручного создания учебного ключа. Согласно официальной документации, ключами этого workspace управляет процесс входа Claude Code.
Все примеры ниже используют ключ, при создании которого выбран один workspace. Для ключей без такого ограничения текущий API дополнительно требует workspace header. Эти два способа использования нельзя смешивать.
5. Подготовьте временную среду терминала
Для начала лучше открыть отдельный терминал и хранить ключ только в текущем сеансе.
Сначала запустите Bash:
bash --noprofile --norcЗатем выполните:
set +x
umask 077
unset ANTHROPIC_API_KEY
unset ANTHROPIC_AUTH_TOKEN CLAUDE_CODE_OAUTH_TOKEN ANTHROPIC_BASE_URL
unset CLAUDE_CODE_USE_BEDROCK CLAUDE_CODE_USE_VERTEX
unset CLAUDE_CODE_USE_FOUNDRY CLAUDE_CODE_USE_ANTHROPIC_AWS
unset CLAUDE_CODE_EFFORT_LEVEL
mkdir -p "$HOME/claude-api-credit-demo"
cd "$HOME/claude-api-credit-demo"Эти временные настройки помогают явно направить упражнение в собственный API Anthropic. Управляемый организацией Claude Code всё равно может подчиняться политике шлюза или провайдера. Если маршрут не соответствует ожидаемому, попросите администратора проверить его.
Затем отдельно выполните следующую строку, вставьте только что созданный ключ и нажмите Enter. Ввод не будет отображаться:
read -r -s -p 'Вставьте API key связанной организации и нажмите Enter: ' ANTHROPIC_API_KEYПосле ввода выполните:
printf '\n'
export ANTHROPIC_API_KEYНе записывайте настоящий ключ в примеры статьи, исходный код скриптов или историю команд. Для проверки не нужно выводить его через echo.
6. Отправьте первый небольшой запрос через curl
В этом примере проверки соединения фиксированно используется claude-haiku-5-5, ограничен вывод и отключён thinking. Сочетание параметров рассчитано на эту модель. При смене модели заново проверьте, какие параметры она поддерживает.
Сначала создайте файл запроса:
cat > request.json <<'JSON'
{
"model": "claude-haiku-5-5",
"max_tokens": 128,
"thinking": {
"type": "disabled"
},
"output_config": {
"effort": "low"
},
"messages": [
{
"role": "user",
"content": "Ответь только: подключение к API успешно"
}
]
}
JSONЗатем отправьте запрос:
curl --disable --silent --show-error \
--connect-timeout 10 --max-time 60 \
--dump-header response.headers \
--output response.json \
--write-out 'HTTP %{http_code}\n' \
--config - <<EOF
url = "https://api.anthropic.com/v1/messages"
request = "POST"
header = "Authorization: Bearer ${ANTHROPIC_API_KEY}"
header = "anthropic-version: 2026-10-21"
header = "content-type: application/json"
data-binary = "@request.json"
EOFКоманда создаст два файла:
- response.json: тело ответа, включая содержимое, причину остановки и использование токенов;
- response.headers: заголовки ответа для сверки идентификатора запроса, организации, workspace и других данных.
Ключ передаётся curl через стандартный ввод, а не непосредственно в аргументах командной строки. Флаг --disable стоит первым, чтобы существующий .curlrc не изменил поведение этой проверки.
Текущая официальная версия API — 2026-10-21. API key можно передавать через Authorization: Bearer. Для ключа, ограниченного одним workspace, заголовок выбора workspace можно опустить.
Посмотрите тело ответа:
python3 -m json.tool response.jsonПроверьте следующее:
- Получен ли HTTP 200.
- Есть ли текстовое содержимое в content.
- Показывает ли stop_reason нормальное завершение или достижение max_tokens.
- Сколько входных, выходных и кэшированных токенов фактически указано в usage.
Затем извлеките нужные заголовки ответа:
python3 - <<'PY'
from pathlib import Path
wanted = {
"request-id",
"anthropic-organization-id",
"anthropic-workspace-id",
}
for line in Path("response.headers").read_text(
errors="replace"
).splitlines():
name, sep, value = line.partition(":")
if sep and name.lower() in wanted:
print(name.lower() + ":", value.strip())
PYСопоставьте возвращённые идентификаторы организации и workspace с записями Console. Полная цепочка проверки складывается, когда запрос успешен, организация совпадает, а запись об использовании появилась в ожидаемом workspace.
7. Используйте тот же баланс через Python SDK
Для подключения API к собственной программе можно использовать официальный Python SDK. Текущая документация требует Python 3.10 или новее.
Создайте виртуальную среду в каталоге упражнения:
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade anthropicСоздайте call_api.py:
import json
import os
import anthropic
with anthropic.Anthropic(
api_key=os.environ["ANTHROPIC_API_KEY"],
base_url="https://api.anthropic.com",
timeout=30.0,
max_retries=0,
) as client:
raw = client.messages.with_raw_response.create(
model="claude-haiku-5-5",
max_tokens=128,
thinking={"type": "disabled"},
output_config={"effort": "low"},
messages=[
{"role": "user", "content": "Ответь только: подключение к API успешно"}
],
)
message = raw.parse()
for name in (
"request-id",
"anthropic-organization-id",
"anthropic-workspace-id",
):
print(name + ":", raw.headers.get(name, "(не возвращено)"))
print("model:", message.model)
print("stop_reason:", message.stop_reason)
for block in message.content:
if block.type == "text":
print(block.text)
print(json.dumps(message.usage.model_dump(), ensure_ascii=False))Запустите:
python call_api.pyraw.parse() разбирает уже полученный ответ и не отправляет второй запрос модели. В примере автоматические повторы отключены, чтобы при первой проверке одному запуску соответствовал один запрос. Для production-системы стратегию повторов можно разработать позже с учётом требований приложения.
8. Настройте claude -p для использования этих кредитов
Официальная документация явно указывает важное условие покрытия:
Если вы самостоятельно запускаете claude -p или Agent SDK с API key связанной организации Console, можно использовать эти ежемесячные кредиты.
Если же используется вход по подписке Claude, расход по-прежнему относится к лимитам подписки. Запуски через Claude Code GitHub Action, расширение IDE или приложение Claude для компьютера не подпадают под указанное условие, даже с флагом -p.
Поэтому этот раздел выполняйте в отдельном системном терминале, который открыли сами, используя API key, настроенный ранее.
Сначала проверьте версию:
claude --versionВ статье используется полный ID модели Haiku 5.5. Официальное требование — Claude Code v2.1.293 или новее. Если CLI не установлен или устарел, следуйте официальной инструкции установки и обновления для вашего способа установки.
Установка и обновление Claude Code · Настройка моделей Claude Code
Сначала можно проверить источник аутентификации:
claude auth statusПоле authMethod в текущем JSON помогает определить источник входа: например, api_key, claude.ai или third_party.
Однако api_key означает лишь обнаруженный источник аутентификации. Само по себе это не доказывает, что ключ действителен, принадлежит нужной организации или что подарочные кредиты зачислены.
Затем запустите минимальную задачу:
claude --bare -p 'Ответь только: подключение к API успешно' \
--model claude-haiku-5-5 \
--effort low \
--tools '' \
--max-turns 1 \
--max-budget-usd 0.10 \
--output-format json \
--no-session-persistence > claude-result.jsonЧто контролирует каждый параметр:
| Параметр | Роль в этом упражнении |
|---|---|
| --bare | Не читает OAuth / системную keychain, пропускает автоматическое обнаружение hooks, skills, плагинов, MCP и другого |
| -p | Неинтерактивный запуск с выходом после результата |
| --model | Явно задаёт модель вместо выбора из повседневного сеанса |
| --effort low | Запрашивает меньшие затраты на рассуждение |
| --tools '' | Отключает встроенные инструменты для начальной проверки только текстового вызова |
| --max-turns 1 | Ограничивает число агентных ходов |
| --max-budget-usd 0.10 | Задаёт порог клиентской оценки стоимости |
| --output-format json | Сохраняет структурированный результат для проверки |
| --no-session-persistence | Не сохраняет сеанс для последующего возобновления |
Режим --bare всё ещё поддерживает явно заданные настройки и учётные данные облачных платформ, поэтому предварительная проверка окружения остаётся важной. Здесь не передаются дополнительные MCP, плагины или каталоги.
Кроме того, --max-budget-usd опирается на клиентскую оценку стоимости. Это не жёсткий предел, который счёт гарантированно не превысит. --max-turns также не равен лимиту токенов. До расширения задачи настройте контроль расходов в Console.
Посмотрите результат:
python3 - <<'PY'
import json
from pathlib import Path
data = json.loads(Path("claude-result.json").read_text())
print("is_error:", data.get("is_error"))
print("result:", data.get("result"))
print("estimated_cost_usd:", data.get("total_cost_usd"))
print("usage:", data.get("usage"))
PYЕсли поле отсутствует, оставляйте значение неизвестным, не подставляйте автоматически ноль. При неуспешном выходе команды проверьте stderr и файл результата. Отсутствие вывода на этапе разбора не означает, что запрос не отправлялся.
9. Как проверить правильность пути списания
После небольшого теста проверьте по порядку:
- Принадлежность ключа: он создан в организации Console, получающей подарочные кредиты.
- Workspace: при создании ключа выбран нужный workspace; идентификаторы, предоставленные ответом API, тоже совпадают.
- Способ вызова: собственный API Anthropic или самостоятельно запущенный claude -p, отвечающий официальным условиям.
- Записи об использовании: в нужном workspace Console появилась запись этого вызова.
- Записи баланса: сверены Promotional credits, купленный остаток, зачисления и даты истечения.
Если у организации есть и подарочный, и купленный баланс, платформа сначала расходует подарочный в соответствии с правилами. Отдельный параметр «использовать подарочные кредиты» для каждого запроса не требуется.
Отчёты могут обновляться с задержкой, а стоимость маленького запроса может быть очень низкой. Если интерфейс пока не показывает заметного изменения, не запускайте запросы подряд только ради того, чтобы увидеть сдвиг.
10. Как разбирать распространённые проблемы
| Симптом | Что проверить в первую очередь |
|---|---|
| Не видно раздела API credits | Тариф, семидневное условие, текущий аккаунт и роли с обеих сторон |
| Кредиты можно получить, но Create key недоступна | Роль в Console, членство в workspace и права создания |
| HTTP 401 | Правильность и действительность ключа, его экспорт в текущий shell |
| HTTP 403 | Права ключа, доступа к workspace, модели или ресурсу |
| HTTP 400 | Конкретный тип ошибки, параметры запроса, версию, workspace и соответствующие ограничения расходов |
| HTTP 402 / billing_error | Состояние биллинга организации, баланс и платежи |
| HTTP 404 | Доступность ID модели, endpoint и ресурса |
| HTTP 429 | Отличайте лимиты запросов / токенов от ограничений расходов; изучите конкретную ошибку и данные ответа |
| stop_reason равен max_tokens | Достигнут предел вывода: запрос мог выполниться успешно, но содержимое не завершено |
| curl работает, а CLI — нет | Версию CLI, переменную API key, маршрут провайдера / шлюза и политику организации |
| CLI работает, но подарочный баланс заметно не уменьшается | Условия покрытия, правильную организацию, задержку отчётов и точность отображения |
Не объясняйте любую ошибку недостатком средств. И наоборот, наличие остатка не означает, что сняты ограничения расходов организации, бюджет workspace или rate limits.
Руководителям Team также стоит назначать проектам подходящие workspace, выдавать участникам нужные права и настраивать уведомления о расходах. В Default Workspace сейчас нельзя задать отдельный лимит расходов workspace. Для бюджета на уровне проекта администратору следует создать подходящий обычный API workspace.
Завершив упражнение, удалите ключ из текущего сеанса и выйдите из временного Bash:
unset ANTHROPIC_API_KEY
exitВременные настройки дочернего shell на этом закончат действовать, а исходное окружение родительского терминала сохранится.
Полные примеры можно скачать ниже, чтобы проверить и использовать в собственном учебном каталоге. Код прошёл синтаксическую и офлайн-проверку процесса; реальные запросы моделей от аккаунтов читателей не выполнялись.