Приходит десяток клиентских заявок, и из каждой нужно перенести в таблицу услугу, срок и недостающие сведения. Claude API позволяет передавать такие задания из программы и получать ответ для дальнейшей обработки. Разберём, как получить ключ, посчитать цену первого запроса и проверить результат, прежде чем подключать рабочую систему.
Что даёт Claude API и когда достаточно чата
API — способ, которым одна программа обращается к другой по установленным правилам. Вместо ручной вставки заявки в чат ваша программа отправляет текст и инструкцию модели Claude, затем забирает ответ. Само подключение не даёт модели доступ к CRM, почте или файлам: необходимые данные и разрешённые действия организует разработчик.
Для разового письма обычно достаточно чата. API полезен, когда одинаковое действие нужно повторять в приложении: например, каждый раз извлекать из заявки три поля и передавать их на проверку оператору. Если задача ещё не проверена вручную, начните с нескольких примеров, а интеграцию отложите.
| Способ работы | Что делает человек | Когда подходит |
|---|---|---|
| Чат Claude | Вставляет данные, уточняет ответ, переносит результат | Разовые задачи и поиск подходящей инструкции |
| Playground в Console | Проверяет запрос и настройки через браузер | Первое знакомство с API без собственного приложения |
| Вызов API | Настраивает передачу данных, обработку ошибок и проверку | Повторяемая операция с понятным входом и выходом |
Модель создаёт ответ, а чат, playground и ваша программа задают способ работы с ней. История переписки в приложении не становится автоматически контекстом запроса API. Официальная документация Messages API описывает передачу нужных сообщений в самом запросе. Файлы, инструменты и скиллы тоже требуют отдельной настройки; обычный вызов ниже их не подключает.
Где получить Claude API key и проверить доступ
Начните с официального списка поддерживаемых регионов API. При проверке 11 ноября 2026 года России в нём нет. Наличие оплаченного чата или чужого примера подключения само по себе не подтверждает допустимость доступа для вашей компании. Если условия не выполняются, остановитесь на изучении примера и выборе разрешённого способа работы.
При доступном официальном сервисе порядок такой:
- Откройте Claude Console и проверьте организацию, от имени которой работаете.
- Посмотрите Billing: баланс, условия оплаты и ограничения расходов.
- Для пробы через браузер откройте playground.
- Для вызова с компьютера создайте ключ на странице API keys. Сохраните его в разрешённом вашей компанией хранилище секретов.
Если Console открыта впервые, создайте организацию при регистрации либо попросите администратора пригласить вас в существующую. Личная проба возможна в собственной организации при соблюдении условий доступа; для рабочих материалов используйте согласованный компанией аккаунт.
Ключ — секрет, с которым программа обращается к вашему API-аккаунту. Не вставляйте его в статью, чат, скриншот, общий документ или код страницы сайта. Если ключ раскрыт, отзовите его в Console, создайте новый и проверьте использование за затронутый период. Закрытие файла с ключом не отменяет утечку.
Передавайте для первого опыта вымышленную заявку. Даже стандартный срок хранения данных не означает, что разрешено загружать клиентскую переписку: сначала проверьте договор, внутренние правила и состав сведений.
Сколько стоит Claude API и чем оплата отличается от подписки
Подписка на чат и Claude Console — отдельные продукты. По актуальному разъяснению Anthropic, некоторые планы Max, Ultra и Team включают месячные API-кредиты после привязки организации Console. Поэтому проверьте условия своего плана: подписка не означает безлимитные вызовы API, а наличие кредитов не отменяет учёт использования.
Токен — единица, на которую модель разбивает текст; это не обязательно слово или буква. Во вход входят инструкция и переданный контекст, на выходе оплачивается сгенерированный ответ. Длинная история и повторные попытки увеличивают расходы.
Для прозрачного расчёта возьмём Sonnet 4.6. На 11 ноября 2026 года в официальной таблице базовый тариф составляет $3 за миллион входных токенов и $15 за миллион выходных. Это пример модели, а не утверждение о самой новой версии. Для пробы выбирайте доступную модель, которая даёт достаточное качество на ваших примерах; затем сравнивайте стоимость и ошибки при одинаковой инструкции.
Если условный запрос содержит 2000 входных и 500 выходных токенов:
Вход: 2000 / 1 000 000 × $3 = $0,006
Выход: 500 / 1 000 000 × $15 = $0,0075
Один вызов: $0,0135
Три одинаковых по объёму вызова: $0,0405
Это арифметический пример, не измерение реального запуска. Кеширование, дополнительные инструменты и специальные режимы могут изменить расчёт. В ответе смотрите usage.input_tokens и usage.output_tokens, а окончательные списания сверяйте с Console. Для инструкции извлечения данных сначала проверьте точность полей, затем сравнивайте цену моделей на одних и тех же заявках.
Стоимость вызовов и первоначальный платёж — разные суммы. $0,0405 не означает, что Console позволит купить кредиты ровно на эту сумму. В Billing → Buy credits сначала посмотрите допустимую сумму покупки и итог оплаты; универсальный минимум здесь не обещаем. Если он превышает ваш бюджет, не подтверждайте покупку. Сначала проверьте уже доступные кредиты и согласуйте лимит с владельцем аккаунта.
Для включённых в подписку кредитов проверьте раздел API credits в настройках оплаты Claude: у подходящего личного плана это Settings → Billing, у владельца Team — Organization settings → Billing. Пункт Link organization связывает план с выбранной организацией Console. После привязки проверьте сумму и срок действия кредитов в Billing Console; условия и требования к ролям изложены в справке о месячных кредитах.
Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
Используйте эти модели
в Agent ROI.
Подписку можно оплатить в рублях.
Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
Используйте эти модели
в Agent ROI.
Подписку можно оплатить в рублях.
300 ₽ на первые запросы
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Начислим при регистрации в Agent ROI.

Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
при регистрации
Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
Используйте эти модели
в Agent ROI.
Подписку можно оплатить в рублях.
Оплачивайте подписку
в рублях
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Карту для старта
привязывать не нужно.
при регистрации
На первые запросы
к моделям в Agent ROI
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Карту для старта
привязывать не нужно.
Оплачивайте подписку
в рублях
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Попробуйте Grok, ChatGPT,
Gemini, Claude и Perplexity
Эти модели доступны по одной подписке
в Agent ROI.
Начните с бонуса при регистрации.

Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
Используйте эти модели
в Agent ROI.
Подписку можно оплатить в рублях.
Оплачивайте подписку
в рублях
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Используйте эти модели в Agent ROI.
Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
300 ₽ при регистрации
Карту привязывать не нужно.
Используйте эти модели в Agent ROI.
На первые запросы
к моделям в Agent ROI
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Бонус начислим при регистрации.
Карту привязывать не нужно.
300 ₽ на первые запросы
Бонус при регистрации
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Используйте эти модели в Agent ROI.

Оплачивайте подписку
в рублях
Grok, ChatGPT, Gemini, Claude
и Perplexity доступны по одной подписке.
Карту привязывать не нужно
Grok, ChatGPT, Gemini, Claude
и Perplexity — по одной подписке
Используйте эти модели
в Agent ROI.
Подписку можно оплатить в рублях.
Попробуйте Grok, ChatGPT,
Gemini, Claude и Perplexity
Эти модели доступны по одной подписке
в Agent ROI.
Бонус начислим при регистрации.
Карту привязывать не нужно.
при регистрации
Как ограничить пробу до запуска
Для первого опыта задайте число запросов заранее: например, три заявки и одна ручная проверка каждой. Не запускайте цикл с автоматическими повторами. В Console проверьте лимит расходов организации; при необходимости администратор может настроить отдельное рабочее пространство с меньшими ограничениями. По документации лимитов, на пространстве по умолчанию собственный spend limit не задаётся.
Откройте Billing и найдите действующий spend limit: запишите сумму, период и организацию, к которой он относится. Если не видите настройку или не можете установить подходящий предел, сначала попросите администратора ограничить пилот; до этого не подключайте автоматические вызовы. Уведомление о расходах не заменяет настроенный предел.
У лимитов разные назначения:
max_tokensограничивает длину генерируемого ответа, но не входные токены и не число вызовов.- Spend limit ограничивает расходы в пределах настроенного периода и области действия.
- Rate limit ограничивает скорость обращений, а не общую стоимость месяца.
- Уведомление помогает заметить расходы, но само по себе не является остановкой.
Для предоплатного аккаунта отдельно проверьте auto-reload: он автоматически покупает дополнительные кредиты при достижении заданного порога. Правила оплаты также предупреждают: обрыв соединения или таймаут клиента не обязательно отменяет оплату уже выполнявшегося запроса. Не повторяйте его вслепую.

Для пилота достаточно одной ограниченной операции: подключение к рабочей системе начинается после проверки данных и расходов.
Один запрос: извлечь поля из заявки
Для первого опыта удобнее браузер. По инструкции playground, откройте нужное рабочее пространство, выберите модель и выполните следующие действия:
- В поле системной инструкции вставьте текст ниже. В отличие от обычного сообщения он задаёт правила обработки.
- В область пользовательского сообщения вставьте вымышленную заявку.
- В настройках модели установите максимум выходных токенов 300.
- Нажмите Run один раз. Прочитайте ответ и показанные для запроса токены; при необходимости откройте представление исходного ответа, где есть
usageиstop_reason.
Системная инструкция:
Извлекай только сведения из заявки. Не додумывай.
Верни JSON: service — услуга, deadline — дата доставки,
missing — массив недостающих обязательных полей.
Обязательны только service и deadline.
Если значение отсутствует, поставь null и добавь имя поля в missing.
Пользовательское сообщение:
Заявка: нужна доставка 12 коробок из Казани в Самару.
Дату доставки пока не согласовали.
Это платное использование Console, а не гарантия бесплатной демонстрации. Условия баланса проверяйте до нажатия Run.
Для PowerShell 7 ниже приведён пример одного обращения к Messages API. Он не подключает CRM и не записывает ответ в рабочие системы. Код сверён с контрактом запроса; платный вызов редакцией не выполнялся.
PowerShell — дополнительный путь для читателя, знакомого с запуском команд. В открытом окне выполните $PSVersionTable.PSVersion: значение Major должно быть 7. Если такого окна у вас нет, оставайтесь в playground. В PowerShell 7 вставьте весь блок; когда появится приглашение Claude API key, введите ключ в скрытом поле, без вставки в команду или сохранения в исходнике:
$apiSecret = Read-Host 'Claude API key' -AsSecureString
$apiCredential = [System.Net.NetworkCredential]::new('', $apiSecret)
$apiHeaders = @{
Authorization = 'Bearer ' + $apiCredential.Password
'anthropic-version' = '2026-10-21'
}
$requestBody = @{
model = 'claude-sonnet-4-6'
max_tokens = 300
system = 'Извлекай только сведения из заявки. Не додумывай. Верни JSON: service — услуга, deadline — дата доставки, missing — массив недостающих обязательных полей. Обязательны только service и deadline. Нет значения — null, а имя поля добавь в missing.'
messages = @(@{
role = 'user'
content = 'Заявка: нужна доставка 12 коробок из Казани в Самару. Дату доставки пока не согласовали.'
})
} | ConvertTo-Json -Depth 6
try {
$countRequest = $requestBody | ConvertFrom-Json -AsHashtable
[void]$countRequest.Remove('max_tokens')
$countBody = $countRequest | ConvertTo-Json -Depth 6
$tokenCount = Invoke-RestMethod -Method Post `
-Uri 'https://api.anthropic.com/v1/messages/count_tokens' `
-Headers $apiHeaders -ContentType 'application/json' `
-Body ([Text.Encoding]::UTF8.GetBytes($countBody))
$estimatedUsd = $tokenCount.input_tokens * 3 / 1000000 + 300 * 15 / 1000000
Write-Host ('Входных токенов: {0}; базовая оценка ${1:F6}' -f $tokenCount.input_tokens, $estimatedUsd)
$runChoice = Read-Host 'Для одного платного вызова введите YES'
if ($runChoice -ne 'YES') { return }
$apiResult = Invoke-RestMethod -Method Post `
-Uri 'https://api.anthropic.com/v1/messages' `
-Headers $apiHeaders -ContentType 'application/json' `
-Body ([Text.Encoding]::UTF8.GetBytes($requestBody))
$apiResult.content
$apiResult.usage
$apiResult.stop_reason
} finally {
$apiHeaders.Clear()
$apiCredential.Password = ''
$apiCredential = $null
$apiSecret.Dispose()
}
Скрытый ввод защищает от отображения ключа на экране; при отправке секрет всё равно используется процессом. Запускайте пример на доверенном компьютере, без записи сеанса, и не добавляйте вывод заголовков в журнал. Если выполнение завершилось ошибкой, PowerShell покажет её; не пересылайте коллегам весь диагностический вывод без проверки секретов и данных.
В этой заявке услуга — доставка 12 коробок из Казани в Самару. Срок отсутствует. Учебный эталон содержимого текстового блока ответа:
{
"service": "Доставка 12 коробок из Казани в Самару",
"deadline": null,
"missing": ["deadline"]
}
Это ожидаемое содержание, не запись живого запуска. Поля заявки ищите в текстовом блоке content, расход — в usage.input_tokens и usage.output_tokens. Значение stop_reason: end_turn означает, что модель закончила этот ответ; max_tokens — что достигнут предел генерации. Код не печатает HTTP-код: при обычном успешном ответе он показывает перечисленные данные, при HTTP-ошибке PowerShell выдаёт сообщение.
Вес и адрес не входят в обязательные поля учебного задания. Для своей операции сначала перечислите обязательные реквизиты и правила пропусков, затем включите их в инструкцию. Просьба «верни JSON» сама по себе не гарантирует корректный JSON: для регулярной обработки нужна проверка схемы и типов.
Перед платным вызовом код обращается к Token counting API с той же моделью, инструкцией и сообщением. Подсчёт входа доступен без платы за него, с ограничением скорости. Программа покажет N и оценку N / 1 000 000 × $3 + 300 / 1 000 000 × $15, затем дождётся YES; без этого платный запрос не отправится. Это оценка для базового режима без дополнительных инструментов, окончательный расход сверяйте после ответа.
В самостоятельной браузерной пробе без такого подсчёта точный вход заранее не определён: вы проверяете баланс и лимит, ограничиваете выход 300 токенами и запускаете один раз, затем смотрите фактический расход. Не подменяйте эту границу обещанием точной цены до запуска. Если предварительная денежная оценка обязательна, используйте вариант PowerShell или попросите технического коллегу выполнить подсчёт. Для трёх разных заявок считайте вход каждой отдельно.
Как проверить ответ и решить, нужна ли интеграция
Сохраните исходную обезличенную заявку, инструкцию, идентификатор модели, usage и результат проверки. Секретный ключ в журнал не включайте. Для каждой из трёх заявок сравните ответ с заранее составленным эталоном: все ли нужные поля найдены, нет ли придуманного срока, корректно ли отмечены пропуски.
Технический успех и полезный результат проверяются отдельно. Ответ с HTTP 200 может содержать неточное извлечение. Если stop_reason показывает достижение max_tokens, ответ мог оборваться: проверьте полноту и только затем меняйте лимит. При ошибке авторизации сначала проверьте ключ и организацию; при ограничении скорости — условие ошибки и время повтора. Коды и структуру ошибок сверяйте с официальным справочником.
Перед работой с реальными данными проверьте условия хранения коммерческих данных. Стандартное удаление входов и выходов API в течение 30 дней имеет исключения; отдельные функции и соглашения могут задавать другие условия. Не считайте API автоматически режимом без хранения.
К регулярному запуску переходите, когда понятны качество, расходы и действия при ошибке. Разработчику понадобятся проверка формата, ограничение повторов, защита от повторной записи, журнал и ручная обработка спорных заявок. На трёх примерах можно найти очевидную проблему, но нельзя доказать надёжность на всех будущих документах.
FAQ
Нужен ли программист для первой пробы?
Для проверки инструкции в playground собственное приложение не требуется. Для подключения к рабочей системе нужен человек, который отвечает за передачу данных, ошибки, ключи и обслуживание интеграции.
Можно ли одним ключом пользоваться всей командой?
Не рассылайте секрет коллегам в переписке. Организуйте доступ через настройки организации и разрешённое хранилище секретов; конкретные права должен назначить администратор. Для пилота заранее определите ответственного за ключ и расходы.
Можно ли использовать Claude API через подписку Agent Roi?
Условия внешнего API Anthropic и доступ к моделям в другом продукте нужно проверять отдельно. Эта инструкция описывает официальный Claude API и не обещает выдачу его ключей или API-кредитов в Agent Roi.
Возьмите три вымышленные заявки и сначала проверьте одинаковую инструкцию вручную. Если нужен выбор между чатом и агентным процессом, начните с гайда по ИИ-агентам для бизнеса, затем зафиксируйте требования к пилоту.
Больше материалов по теме — в разделе «ИИ-агенты, автоматизация и разработка».