API-ключ Anthropic (2026): как получить, типы ключей, настройка Claude Code и ошибки

API-ключ Anthropic (2026): как получить, типы ключей, настройка Claude Code и ошибки

Чтобы получить API-ключ Anthropic, войдите в Claude Console, откройте API keys, нажмите Create key, укажите имя, срок действия и связанный аккаунт (вы или сервисный аккаунт), а затем скопируйте ключ, начинающийся с sk-ant-: Console показывает его только один раз. Перед вызовом API добавьте способ оплаты или пополните баланс: использование тарифицируется за токены, а новые аккаунты получают лишь небольшой бесплатный тестовый кредит, согласно странице цен Anthropic на 22 октября 2026 года. Один и тот же ключ работает со всеми моделями Claude; отдельного «ключа Claude API» или «ключа Sonnet» не существует.

Это руководство для разработчиков, которым нужен ключ для скриптов, агентов для программирования вроде Claude Code или продакшен-сервиса. В нём описаны типы ключей 2026 года (личный, сервисного аккаунта и устаревший ключ рабочего пространства), правила срока действия, заголовок anthropic-workspace-id, из-за которого падают многие первые запросы, рабочий код, типичные ошибки 401/400/429 и случаи, когда удобнее один ключ для нескольких провайдеров.

API-ключ Anthropic за 60 секунд

Шаг	Где	Что важно знать (проверено 22.10.2026)
1. Вход	platform.claude.com	API-ключи находятся в Claude Console, а не в чат-приложении claude.ai
2. Открыть API keys	Settings → API keys	Если кнопка Create key неактивна, ваша роль не позволяет создавать ключи
3. Создать ключ	Имя, срок действия, связанный аккаунт, рабочее пространство (необязательно)	Варианты срока: 3 часа, 1 день, 7 дней, 30 дней, свой срок или Never
4. Скопировать один раз	Показывается только при создании	Начинается с sk-ant-; потерянный ключ повторно посмотреть нельзя
5. Настроить оплату	Settings → Billing	Оплата по факту в долларах США; у каждого уровня есть месячный лимит расходов
6. Проверить	POST https://api.anthropic.com/v1/messages	Передайте ключ как Authorization: Bearer (или устаревший x-api-key)

Источник: документация Anthropic Get your Claude API key и Authentication, проверено 22 октября 2026 года.

Пошагово: создаём API-ключ Anthropic

1. Зарегистрируйтесь или войдите в Console на platform.claude.com. Подписка на чат Claude и API оплачиваются отдельно, хотя тарифы Max включают ежемесячный кредит на API (подробности ниже и в нашем руководстве по ценам API Anthropic).
2. Откройте страницу API keys. Если в вашей организации несколько рабочих пространств, можно сразу выбрать одно и ограничить ключ им.
3. Нажмите Create key и заполните три поля: понятное имя (например, ci-staging-claude), срок действия и Linked account. Привязка к себе создаёт личный ключ; привязка к сервисному аккаунту создаёт ключ для общих рабочих нагрузок.
4. Сразу скопируйте ключ. В документации Anthropic сказано, что полный ключ показывается только один раз. Храните его в менеджере паролей или секретов, но никогда в Git-репозитории.
5. Пополните баланс или привяжите карту на странице Billing. Без средств первый запрос завершится ошибкой даже с действительным ключом.
6. Экспортируйте его в переменную окружения, чтобы SDK подхватывали его автоматически:

export ANTHROPIC_API_KEY="sk-ant-api03-..."   # macOS/Linux, current shell only
# Windows PowerShell:
# setx ANTHROPIC_API_KEY "sk-ant-api03-..."

Какой тип ключа выбрать?

В 2026 году Anthropic различает три типа ключей. Неверный выбор — самая частая причина того, что ключ «внезапно перестаёт работать», когда кто-то уходит из команды.

Тип ключа	Действует от имени	Перестаёт работать, когда	Для чего
Личный ключ	Вас, с вашими ролями	Вы покидаете организацию или ключ одного рабочего пространства теряет к нему доступ	Локальная разработка, ваши скрипты, ваш Claude Code
Ключ сервисного аккаунта	Сервисного аккаунта	Сервисный аккаунт архивирован или удалён из рабочего пространства	CI-пайплайны, продакшен-сервисы, общие агенты
Ключ рабочего пространства (устаревший)	Никого (принадлежит рабочему пространству)	Истекает срок, ключ отключён/удалён или пространство архивировано	Только существующие интеграции; стоит мигрировать

Данные со страницы Authentication Anthropic, 22 октября 2026 года. Anthropic рекомендует личные ключи или ключи сервисных аккаунтов: они привязаны к идентичности и не могут пережить человека или нагрузку, которым принадлежат. Для продакшена на AWS, Google Cloud, Azure, GitHub Actions или Kubernetes та же страница рекомендует Workload Identity Federation, которая заменяет статические ключи короткоживущими токенами.

Правила срока действия, которые стоит знать

• Срок действия задаётся при создании и позже не меняется.
• Для ключей сроком от 14 дней Anthropic присылает создателю письмо за 7 дней до истечения, для ключей сроком от 7 дней — за 1 день; более короткие ключи истекают без предупреждения.
• После истечения запросы возвращают 401 authentication_error, а истёкший ключ нельзя активировать снова — только удалить.
• Disable обратимо; Delete необратимо.

Практичная схема: ключи на 30 дней для ноутбуков и агентов для программирования и ключи сервисных аккаунтов в менеджере секретов (с ротацией) для серверов. Подробнее — в наших руководствах по безопасному управлению API-ключами в AI-продуктах и ротации ключей за шлюзом.

Проверка ключа: первый запрос на curl, Python и Node.js

Идентификатор модели ниже, claude-sonnet-5-5, — текущая модель Sonnet в обзоре моделей Anthropic на 22 октября 2026 года.

curl https://api.anthropic.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Reply with the word ok if this key works."}]
  }'

# pip install anthropic
import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Reply with the word ok if this key works."}],
)
print(next(b.text for b in msg.content if b.type == "text"))
print("tokens:", msg.usage.input_tokens, "in /", msg.usage.output_tokens, "out")

// npm install @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY
const msg = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 256,
  messages: [{ role: "user", content: "Reply with the word ok if this key works." }],
});
console.log(msg.content.find((b) => b.type === "text")?.text);

Такой тест стоит доли цента: по официальной цене Sonnet 5.5 — $2 за миллион входных и $10 за миллион выходных токенов (цены Anthropic, 22 октября 2026 года) — 30 входных и 5 выходных токенов обходятся примерно в $0,0001.

Заголовок рабочего пространства, ломающий первые запросы

Если ваш ключ не привязан к рабочему пространству, каждый запрос должен содержать anthropic-workspace-id, иначе API вернёт 400 invalid_request_error с сообщением «This API key is not scoped to a workspace...». ID можно найти на странице Workspaces в Console. Исправление на Python:

client = anthropic.Anthropic(
    default_headers={"anthropic-workspace-id": "wrkspc_..."}  # only for keys not scoped to a workspace
)

Ключам, созданным для одного рабочего пространства, заголовок не нужен, поэтому Anthropic советует ограничивать ключи при создании (документация Authentication).

Используем API-ключ Anthropic в Claude Code

Claude Code может аутентифицироваться через подписку claude.ai, вход в Console, облачного провайдера или API-ключ. Согласно документации по аутентификации Claude Code, проверенной 22 октября 2026 года:

• Если задана ANTHROPIC_API_KEY, Claude Code при первом запуске спрашивает, использовать ли её, и после подтверждения пропускает вход через браузер.
• ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN и настройка apiKeyHelper действуют для CLI, расширения VS Code, Agent SDK и GitHub Actions, но не для Claude Desktop и облачных сессий.
• apiKeyHelper запускает скрипт, возвращающий ключ, — это удобно, чтобы получать короткоживущий ключ из хранилища секретов. Если скрипт трижды завершится ошибкой, запросы перестанут проходить.
• Пользователи Console теперь могут входить без создания API-ключа (Claude Code v2.1.242 или новее): сохраняется OAuth-профиль, а не статический ключ. Перед этим удалите ANTHROPIC_API_KEY.

export ANTHROPIC_API_KEY="sk-ant-api03-..."
claude        # approve the key when prompted
# inside Claude Code, /status shows which credential is active

Если Claude Code сообщает об ошибках токена или входа, смотрите наше руководство по ошибкам токена аутентификации Claude Code. Чтобы направить Claude Code через роутер, а не напрямую в Anthropic, читайте настройку API-роутера для Claude Code.

API-ключ Anthropic бесплатный?

Создать ключ бесплатно, а пользоваться им — нет. В FAQ по ценам Anthropic сказано, что новые пользователи получают «небольшое количество бесплатных кредитов для тестирования API»; после этого каждый запрос оплачивается за токены. Есть одно исключение: на claude.com/pricing, по данным на 22 октября 2026 года, тариф Max 5x ($100 в месяц) включает $100 в месяц, а Max 20x — $200 в месяц в виде кредитов на API для Claude Platform; Pro ($20 в месяц при помесячной оплате) их не включает. Текущие прайсовые цены за миллион токенов на странице цен Anthropic, 22 октября 2026 года:

Модель	ID модели	Вход	Выход	Чтение кэша
Claude Fable 5.1	claude-fable-5-1	$10.00	$50.00	$0.25
Claude Opus 5.5	claude-opus-5-5	$4.00	$20.00	$0.20
Claude Sonnet 5.5	claude-sonnet-5-5	$2.00	$10.00	$0.10
Claude Haiku 5.5 (промпты до 100K)	claude-haiku-5-5	$0.10	$0.50	$0.01

Batch API вдвое снижает цены на вход и выход, а инференс только в США (inference_geo: "us") добавляет множитель 1,1x. Расчёты для рабочих нагрузок — в нашем полном руководстве по ценам API Anthropic. Если для прототипа нужна действительно бесплатная модель, в нашем сравнении бесплатных LLM API собраны варианты с реальными лимитами.

Вместе с ключом действуют лимиты расходов и скорости

Уровень использования вашей организации определяет и лимиты скорости, и месячный потолок расходов. По данным страницы лимитов Anthropic на 22 октября 2026 года, потолки составляют $500 (Start), $1 000 (Build) и $200 000 (Scale) в месяц; новые организации могут начинать с более низкого уровня Evaluation. При достижении потолка API возвращает HTTP 429 до 00:00 UTC первого числа следующего месяца, если вы не запросите более высокий уровень. На странице Billing можно задать и собственный, более низкий лимит — хорошая привычка для любого ключа, которым пользуется автономный агент.

Частые ошибки API-ключа Anthropic и их решения

Ошибка	Вероятная причина	Решение
401 authentication_error	Опечатка, ключ отозван, отключён или истёк	Создайте новый ключ; истёкшие ключи не реактивируются
400 invalid_request_error с упоминанием workspace	Ключ не привязан к рабочему пространству, заголовок не передан	Добавьте anthropic-workspace-id или создайте ключ для конкретного пространства
404 not_found_error «Workspace ... not found»	Неверный ID пространства или у идентичности ключа нет доступа	Проверьте ID на странице Workspaces
429 «reached your API usage limits»	Достигнут месячный потолок расходов уровня	Запросите повышение уровня или дождитесь ежемесячного сброса
429 с retry-after	Превышены запросы или токены в минуту	Подождите и повторите; см. лимиты скорости LLM простыми словами
529 overloaded_error	Нехватка мощностей у Anthropic, ключ ни при чём	Повторите с backoff или переключитесь; см. ошибку API 529
Кнопка Create key неактивна	Ваша роль в Console не позволяет создавать ключи	Попросите администратора сменить роль или выдать ключ сервисного аккаунта

Источники: документация Anthropic по Authentication, лимитам скорости и ошибкам, проверено 22 октября 2026 года.

Как защитить ключ

• Никогда не вставляйте ключ во фронтенд-код, мобильные приложения или публичные ноутбуки. Для приложений iOS и macOS, которым нужно обращаться к Claude напрямую, Anthropic предлагает App Attest: он выдаёт токены устройства со сроком жизни 1 час.
• Используйте отдельный ключ для каждого окружения и агента, чтобы отозвать один, не ломая остальные.
• Задавайте срок действия, пусть даже длинный, чтобы у утёкшего ключа был «срок годности».
• Включите сканирование секретов в CI; в нашем руководстве по сканированию секретов AI API показана настройка.
• Следите за использованием в Console и установите лимит расходов ниже потолка вашего уровня.

Когда проще один ключ для многих моделей

Ключ Anthropic открывает доступ только к Claude. Если ваш продукт или агент для программирования также вызывает GPT, Gemini, DeepSeek, Qwen или Kimi, вам приходится управлять пятью ключами, пятью балансами и пятью наборами лимитов. Единый API вроде Flatkey выдаёт один ключ на всё. 22 октября 2026 года на страницах моделей Flatkey Claude Sonnet 5.5 стоил $1,60 за вход / $8,00 за выход за миллион токенов, а Claude Opus 5.5 — $3,20 / $16,00, тогда как прайсовые цены Anthropic — $2 / $10 и $4 / $20. Anthropic SDK работает после смены base URL, как описано в руководстве по Anthropic SDK от Flatkey:

import anthropic

client = anthropic.Anthropic(api_key="YOUR_FLATKEY_KEY", base_url="https://router.flatkey.ai")
msg = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Summarize this changelog in 3 bullets."}],
)
print(next(b.text for b in msg.content if b.type == "text"))

Оставайтесь на прямом ключе Anthropic, если вам нужны эксклюзивные функции Anthropic в день релиза, Workload Identity Federation, контроль резидентности данных или корпоративный контракт. Более широкое сравнение — в статьях Flatkey или прямые аккаунты у провайдеров и один API-ключ для нескольких AI-моделей.

FAQ

Как получить API-ключ Anthropic?

Войдите в Claude Console на platform.claude.com, перейдите в Settings → API keys, нажмите Create key, задайте имя, срок действия и связанный аккаунт и скопируйте ключ sk-ant-, который показывается один раз. Перед запросами пополните баланс на странице Billing.

API-ключи Anthropic бесплатные?

Создать ключ бесплатно, и новые аккаунты получают небольшой тестовый кредит, но дальше использование API оплачивается за токены. На 22 октября 2026 года постоянного бесплатного уровня для Claude API нет.

Ключ Claude API и API-ключ Anthropic — это одно и то же?

Да. В документации Anthropic сказано, что ключи Claude API также называются API-ключами Anthropic. Один ключ работает со всеми моделями Claude, доступными вашей организации.

Где найти существующий API-ключ Anthropic?

На platform.claude.com/settings/keys видны имя, подсказка и срок действия каждого ключа, но не сам секрет целиком. Если ключ потерян, создайте новый и удалите старый.

Включает ли подписка Claude Pro или Max кредиты на API?

Pro — нет. По данным claude.com/pricing на 22 октября 2026 года, тарифы Max включают ежемесячные кредиты на API ($100 в месяц на Max 5x, $200 в месяц на Max 20x). Сверх них использование API через ключ Console оплачивается за токены отдельно от подписки на чат.

Почему мой API-ключ Anthropic возвращает 401?

Ключ введён с ошибкой, отключён, удалён или истёк. Истёкшие ключи нельзя реактивировать — создайте новый. Если в ошибке упоминается рабочее пространство, это на самом деле ошибка 400 из-за отсутствующего заголовка anthropic-workspace-id.

Как использовать API-ключ Anthropic в Claude Code?

Задайте ANTHROPIC_API_KEY в оболочке, запустите claude и подтвердите ключ по запросу. Команда /status внутри Claude Code покажет, какие учётные данные активны.

Источники

• Anthropic: Get your Claude API key, Authentication, Pricing, Rate limits, Models overview, проверено 22 октября 2026 года
• Claude Code: Authentication and IAM, проверено 22 октября 2026 года
• Flatkey: каталог моделей и руководство по Anthropic SDK, проверено 22 октября 2026 года