Claude API

Навык claude-api — это официальная инструкция Anthropic для разработки приложений на Claude. Она помогает выбрать подходящую поверхность API, определить язык проекта и открыть нужный раздел документации перед реализацией. В источнике отдельно разобраны обычный Claude API, вызовы инструментов и Managed Agents; Claude Agent SDK обозначен как отдельный продукт со своим набором правил. Это полезное разделение: один запрос, управляемый приложением цикл tool use и полностью управляемый Anthropic агент — разные уровни ответственности, состояния и размещения вычислений. Для обычной классификации, суммаризации, извлечения и вопросов-ответов скилл рекомендует начинать с одного вызова Claude API. Когда логику нескольких шагов контролирует приложение, используется Claude API вместе с tool use. Для собственного агента можно выбрать ручной цикл или Tool Runner SDK: в первом случае команда сама обрабатывает остановку на tool_use, выполняет функции и отправляет результаты обратно, а во втором SDK помогает вести этот цикл для определённых разработчиком инструментов. Managed Agents описан отдельно как серверный вариант для долгоживущих сессий, рабочих пространств, файлов, bash, выполнения кода, Skills и MCP. Источник подчёркивает, что Tool Runner не даёт встроенного доступа к файлам или оболочке, а Agent SDK и Managed Agents не следует смешивать с обычным API. Правило выбора клиента в этой инструкции простое: для поддерживаемого языка сначала используется официальный Anthropic SDK; raw HTTP допустим, когда его явно запрашивают, проект сам является shell или cURL-проектом либо для языка нет официального SDK. Названия классов, функций, пространств имён и параметров нельзя угадывать по примеру на другом языке. Сначала нужно определить Python, TypeScript, Java, Go, Ruby, C# или PHP и прочитать соответствующий файл в исходном skill-пакете. Перед изменением целевого файла также проверяются маркеры другого провайдера: если проект использует OpenAI или другой явно названный API, инструкцию для Claude нельзя автоматически применять поверх него. Скилл описывает Messages API как центральную точку, через которую проходят сообщения, инструменты и ограничения ответа. Вокруг него перечислены пакетная обработка сообщений, Files API, подсчёт токенов и Models API. Для выбора модели и проверки возможностей рекомендуется получать живые сведения через Models API, а не полагаться на закэшированную таблицу в документе. Для длинных диалогов источник отдельно рассматривает compaction и сохранение полного содержимого блоков ответа. Для повторяющегося префикса промпта описан prompt caching с проверкой cache-read usage, а для длинного результата — streaming и получение финального сообщения после завершения потока. Практический сценарий работы выглядит так: определить тип задачи, выбрать поверхность, прочитать языкоспецифичный раздел, сверить актуальные model ID и capability через официальную документацию или Models API, затем реализовать минимальный вызов и отдельно проверить tool use, streaming, токены и ошибки. При миграции существующего кода предусмотрен отдельный subcommand migrate, который требует сначала определить область файлов и только потом читать руководство по миграции. Для Bedrock, Vertex AI и Microsoft Foundry нужно учитывать отдельные таблицы доступности и партнёрские условия; нельзя автоматически переносить ограничения, цены или параметры платформы Claude API на облачный провайдер. Ограничения карточки существенны. SKILL.md — это инструкция и навигация по документации, а не исполняемый SDK, тест интеграции или гарантия корректности конкретного приложения. Закэшированные модели, цены и API-детали могут устареть, поэтому перед релизом их нужно проверить по официальным живым источникам. Навык не заменяет проверку ключей, профилей, прав доступа, лимитов, ретраев, таймаутов и обработки отказов в самом проекте. При использовании инструментов, MCP, файлов или Managed Agents отдельно оцениваются разрешения, область данных, длительность сессии и стоимость. Перед установкой и обновлением следует прочитать исходный SKILL.md целиком и проверить фактические примеры для выбранного языка и провайдера.