Как подключить Claude API к вашему приложению

Чтобы подключить Claude API, создайте ключ API в Claude Console Anthropic, сохраните его как секрет на сервере (обычно ANTHROPIC_API_KEY) и вызывайте Messages API из маршрута на вашем сервере, используя один из официальных SDK Anthropic. В каждом запросе указывается модель, задаётся max_tokens (максимальная длина ответа, которую вы примете), а переписка передаётся в messages; ваши инструкции идут отдельно, в system-промпте. Установите лимит расходов, передавайте длинные ответы потоком и обрабатывайте ошибки лимита запросов (429) и перегрузки (529) повторными попытками.

Это руководство охватывает настройку, безопасный порядок запросов, промпты для ИИ-конструктора и ошибки, к которым нужно быть готовым. Сведения об Anthropic взяты из её документации по состоянию на сентябрь 2026 года. О том, как в целом работают токены и цены, читайте как использовать LLM API.

Что с ним можно сделать

• Чат-ассистенты и виджеты помощи (как создать приложение-чатбот)
• Сводки, переписывание текстов и черновики ответов
• Извлечение полей из документов, писем и форм
• Ответы на вопросы по вашему собственному контенту
• Агенты, которые вызывают функции вашего приложения через tool use

Другие идеи — в статье как добавить функции ИИ в приложение.

Messages API вкратце

Согласно справочнику API Anthropic, запрос — это POST на https://api.anthropic.com/v1/messages со следующими параметрами:

API не хранит состояние: чтобы продолжить разговор, предыдущие реплики нужно передавать снова с каждым запросом. Поэтому длинные чаты стоят дороже за каждое сообщение.

Anthropic публикует официальные SDK для Python, TypeScript, C#, Go, Java, PHP и Ruby. Они выставляют заголовки, разбирают ответы и поддерживают потоковую передачу. Используйте их вместо сырого HTTP, если нет особой причины.

Выбор модели

Anthropic предлагает несколько моделей Claude, которые по-разному соотносят возможности, скорость и цену, и линейка меняется. Берите самую маленькую модель, которая хорошо решает вашу задачу, проверьте её на реальных примерах и храните идентификатор модели в конфигурации, чтобы переключать его без изменения кода. Актуальные варианты и тарифы смотрите на страницах Anthropic с моделями и ценами.

Настройка аккаунта

1. Войдите в Claude Console на platform.claude.com и подключите оплату.
2. Создайте ключ API. Держите отдельный ключ для тестирования и для продакшена, чтобы отозвать один, не сломав другой.
3. Установите лимит расходов. В документации Anthropic по ошибкам сказано, что при достижении установленного вами лимита расходов API возвращает ошибку 400, поэтому приложение должно показать понятное сообщение.
4. Проверьте лимиты запросов для вашего аккаунта в Console; они считаются на уровне организации.

Порядок запроса

1. Пользователь действует в вашем приложении: отправляет сообщение, нажимает «Резюмировать».
2. Браузер вызывает ваш серверный маршрут, а не Anthropic напрямую.
3. Ваш сервер проверяет, что пользователь вошёл в систему и может пользоваться функцией, и применяет лимит на пользователя.
4. Он формирует запрос: системный промпт с вашими правилами, ввод пользователя и данные из вашей базы, которые нужны задаче.
5. Он вызывает Messages API с ключом из окружения и разумным max_tokens.
6. Он передаёт ответ в браузер потоком и записывает использование токенов из ответа.

Варианты и компромиссы

Промпты для ИИ-конструктора

Первая функция:

Добавьте панель «Спросить про этот документ». Она вызывает серверный маршрут POST /api/ask, который проверяет, что пользователь вошёл в систему и является владельцем документа, затем вызывает Claude Messages API через официальный SDK Anthropic и секрет ANTHROPIC_API_KEY. Идентификатор модели читайте из секрета CLAUDE_MODEL. Системный промпт: «Отвечай только на основе предоставленного документа. Если ответа в нём нет, так и скажи». Передавайте текст документа и вопрос, установите max_tokens в 800, выводите ответ на страницу потоком и никогда не отдавайте ключ в браузер.

Ограничения и ошибки:

Ограничьте каждого пользователя 20 вопросами в час, учёт ведите в базе данных. Записывайте входные и выходные токены из каждого ответа вместе с ID пользователя и ID запроса. При ошибках 429 или 529 повторяйте запрос с экспоненциальной задержкой до 3 раз, учитывая заголовок retry-after, затем показывайте «Ассистент занят, попробуйте чуть позже». Если API сообщает об ошибке лимита расходов, показывайте «Функции ИИ приостановлены» и уведомляйте администратора.

Ошибки, к которым нужно готовиться

По документации Anthropic по ошибкам, вот те, с которыми ваше приложение действительно столкнётся:

По документации Anthropic, официальные SDK автоматически повторяют временные сбои (ошибки соединения, лимиты запросов и ошибки 5xx) по умолчанию два раза с экспоненциальной задержкой, и это можно настроить. Каждый ответ содержит заголовок request-id; записывайте его, чтобы поддержка могла отследить проблему.

Частые ошибки

• Вызов API из браузера. Ваш ключ становится публичным. Всегда ходите через свой сервер. См. как защитить ключи API.
• Забыть, что max_tokens — это ограничение, а не цель. Установите значение, которое нужно функции: слишком малое обрежет ответы, слишком большое даст длинные и дорогие ответы.
• Правила в пользовательском сообщении. Постоянные инструкции должны идти в system-промпт; права доступа — в вашем коде.
• Отправлять весь чат всегда. По мере роста переписки обрезайте или суммируйте старые реплики.
• Нет лимита расходов и лимита на пользователя.
• Жёстко прописанный идентификатор модели. Модели обновляются и выводятся из эксплуатации.
• Игнорирование причины остановки. Если ответ остановился из-за max_tokens, сообщите пользователю или повысьте лимит.

Чек-лист

• Ключ API создан в Claude Console и сохранён как секрет на сервере
• Отдельные ключи для тестирования и продакшена
• Установлен лимит расходов; понятное сообщение, когда он достигнут
• Все запросы идут через ваш сервер с проверкой прав
• Правила находятся в системном промпте; идентификатор модели настраивается
• max_tokens задан для каждой функции; длинные ответы передаются потоком
• Лимит запросов на пользователя в приложении
• Ошибки 429 и 529 обрабатываются с задержкой; ID запросов записываются
• Понятное состояние ошибки, которое не ломает страницу
• Проверено с пустым, очень длинным и враждебным вводом

Использование Claude API в Mythex

В приложениях, которые вы создаёте на Mythex, функции Claude используют ваш собственный ключ Anthropic и оплачиваются через ваш аккаунт Anthropic, а не из кредитов сборки Mythex. Это отдельно от агента Mythex, который пишет ваш код. Добавьте ANTHROPIC_API_KEY как секрет проекта через /secrets, в настройках проекта или в карточке секретов в чате, затем опишите функцию промптами, похожими на приведённые выше. После изменения секретов у опубликованного приложения опубликуйте его снова. Стартовый промпт есть в рецепте Добавление функций ИИ с вашими ключами API. Если выбираете между провайдерами, как подключить OpenAI API описывает то же самое для OpenAI.

Вопросы