Навык Claude API

Навык claude-api — это Agent Skill (навык агента) с открытым исходным кодом, который предоставляет Claude подробные, актуальные справочные материалы для создания приложений на двух поверхностях Anthropic:

• Messages API: Основная поверхность для одиночных запросов, чата с потоковой передачей, использования инструментов, пакетной обработки, кэширования подсказок, структурированных выходных данных и пользовательских агентных циклов.
• Claude Managed Agents (бета): Размещаемая Anthropic поверхность для управляемых сервером агентов с сохранением состояния, с выполнением инструментов на стороне Anthropic, постоянными конфигурациями агентов и песочницами для каждой сессии.

Он охватывает восемь языков программирования как для Messages API, так и для Managed Agents: Python, TypeScript, C#, Go, Java, PHP, Ruby и cURL.

Навык поставляется в комплекте с Claude Code, а также доступен в открытом репозитории навыков Anthropic, откуда вы можете установить его в любую среду, поддерживающую Agent Skills.

Навык использует «progressive disclosure» (постепенное раскрытие), чтобы эффективно расходовать контекст: Claude загружает только документацию, относящуюся к языку вашего проекта, поверхности (Messages API или Managed Agents) и конкретной текущей задаче (использование инструментов, потоковая передача, пакеты и так далее), а не загружает всё сразу.

Что предоставляет навык

После активации навык предоставляет Claude следующее.

Для Messages API:

• Документация SDK для конкретного языка: установка, быстрый старт, распространённые шаблоны и обработка ошибок для языка вашего проекта
• Руководство по использованию инструментов: примеры для конкретного языка и концептуальные основы вызова функций, включая бета-версию tool runner там, где она доступна
• Шаблоны потоковой передачи: детали реализации для создания интерфейсов чата и постепенного отображения ответа
• Пакетная обработка: офлайн-обработка пакетов за 50% стоимости
• Кэширование подсказок: проектирование стабильного префикса, размещение точек останова и аудит скрытых факторов, незаметно сбрасывающих кэш
• Миграция моделей: пошаговое руководство по переходу на более новые модели Claude (включая критические изменения и изменения поведения в Claude Opus 5.5, Claude Sonnet 5.5, Claude Haiku 5.5 и Claude Fable 5.1)
• Миграция на сохранённые размышления: поиск, измерение и исправление правок истории, которые делают недействительными блоки thinking, доступны через подкоманду /claude-api preserved-thinking-migration
• Актуальная информация о моделях: идентификаторы моделей, размеры «context window» (контекстное окно) и цены
• Распространённые ошибки: подробные рекомендации о том, как избежать частых ошибок при интеграции с API

Для Managed Agents (бета):

• Процесс первоначальной настройки: пошаговое руководство в формате интервью для создания нового Managed Agent с нуля. Оно доступно через подкоманду /claude-api managed-agents-onboard
• Документация Managed Agents для конкретных языков: создание постоянных агентов, запуск сессий, потоковая передача событий и обработка подтверждений инструментов для Python, TypeScript, C#, Go, Java, PHP, Ruby и cURL
• Клиентские шаблоны: переподключение к потоку без потерь, проверка состояния «в очереди/обработано» по processed_at, обработка прерываний, подводные камни при монтировании файлов и работа с учётными данными
• Ограничения развёртывания: Managed Agents доступен только в Claude API и Claude Platform on AWS. В Amazon Bedrock, Google Cloud и Microsoft Foundry он недоступен. Для других вариантов развёртывания навык предлагает Messages API и использование инструментов.

Когда навык активируется

Навык активируется двумя способами:

Автоматическая активация происходит, когда:

• Ваш код импортирует SDK Anthropic (anthropic для Python, @anthropic-ai/sdk для TypeScript/JavaScript)
• Вы просите Claude помочь создать, отладить или оптимизировать что-либо с использованием Claude API, SDK Anthropic или Managed Agents
• Вы добавляете, изменяете или настраиваете функцию Claude в файле (кэширование подсказок, адаптивные размышления, компактизация, использование инструментов, пакеты, файлы, цитаты, память) или ссылку на модель

Ручной вызов — ввод /claude-api (с необязательной подкомандой или текстом) в любой среде, где установлен навык.

Навык не активируется для общих задач программирования, работы в области ML/data science или кода, импортирующего другие AI SDK (например, OpenAI).

Поддерживаемые языки

Навык автоматически определяет язык вашего проекта, анализируя файлы проекта (например, requirements.txt для Python, tsconfig.json для TypeScript, go.mod для Go), и загружает соответствующую документацию.

Если ваш проект использует несколько языков, Claude спросит, какой из них применим. Для неподдерживаемых языков (Rust, Swift, C++) навык предоставляет примеры cURL/сырого HTTP.

Как использовать навык

В Claude Code (в комплекте)

Навык поставляется вместе с Claude Code и не требует установки. Когда вы просите Claude помочь создать что-либо с использованием Claude API или когда ваш проект уже импортирует SDK Anthropic, навык активируется автоматически.

Вы также можете вызвать его напрямую:

Подробнее о том, как работают встроенные навыки в Claude Code, см. в документации по навыкам Claude Code.

Из репозитория навыков

Исходный код навыка доступен в репозитории навыков Anthropic. Вы можете установить его с помощью команды npx:

npx skills add https://github.com/anthropics/skills --skill claude-api

Или попросите Claude Code установить его как плагин Claude Code:

/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skills

Миграция на более новую модель Claude

Навык Claude API умеет выполнять миграцию моделей Claude по всей кодовой базе. Вызовите его напрямую командой /claude-api migrate:

Чтобы пропустить вопрос о подтверждении области действия, укажите её сразу:

Если область действия неоднозначна (например, при вызове /claude-api migrate to claude-opus-5-5 без уточнений), навык до редактирования файлов попросит выбрать один из вариантов: весь рабочий каталог, конкретный подкаталог или явный список файлов. Это относится к коду, вызывающему как Messages API, так и Managed Agents.

Навык выполняет следующее:

• Замена идентификаторов моделей, включая типизированные константы SDK (Model.CLAUDE_OPUS_4_8 → Model.CLAUDE_OPUS_5_5), во всех поддерживаемых языках. Перед редактированием навык определяет роль каждого файла: вызывающий код, определение модели или непрозрачная строковая ссылка
• Определение облачной платформы: навык сохраняет форматы идентификаторов моделей, специфичные для платформы (например, префикс anthropic. в Amazon Bedrock), и не вносит изменения для функций, недоступных на платформах партнёров
• Несовместимые изменения параметров, например удаление temperature, top_p и top_k для Claude Opus 4.8 и Claude Opus 4.7, а также замена thinking: {type: "enabled", budget_tokens: N} на thinking: {type: "adaptive"}
• Замена предзаполнения: шаблоны предзаполнения сообщений ассистента преобразуются в структурированные выходные данные, где это применимо
• Очистка бета-заголовков: навык удаляет бета-заголовки, которые не требуются целевой модели (например, effort-2025-11-24, fine-grained-tool-streaming-2025-05-14, interleaved-thinking-2025-05-14), и переключает вызовы обратно с client.beta.messages.create() на client.messages.create()
• Калибровка усилий: навык рекомендует начальное значение output_config.effort для целевой модели (например, значение по умолчанию high для Claude Opus 5 и xhigh для задач программирования и агентных сценариев на Claude Opus 4.8 и Claude Opus 4.7)
• Настройка поведения подсказок: навык отмечает подсказки, которые управляют длиной ответа, вызовом инструментов, субагентами и следованием инструкциям, если на целевой модели они могут работать иначе
• Обработка скрытых изменений значений по умолчанию: если рассуждения модели показываются пользователям на Claude Opus 4.8 и Claude Opus 4.7, навык снова включает сводку размышлений (thinking.display: "summarized")
• Настройка резервного варианта при отказе: навык добавляет обработку stop_reason: "refusal" перед чтением содержимого ответа и настраивает резервный путь повторной попытки, когда целевой моделью является Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5 или Claude Sonnet 5.5 (серверный параметр fallbacks, обычно в режиме "default", промежуточное ПО SDK для резервного варианта при отказе или повторная попытка с резервным кредитом), а также обновляет код резервного варианта, написанный для более ранних предварительных форматов

По ходу редактирования навык сразу поясняет каждое изменение и его причину. По завершении он формирует контрольный список пунктов, требующих ручной проверки. Обычно это интеграционные тесты, настройка подсказок, управляющих длиной ответа, и пересмотр базовых показателей стоимости и «rate limit» (ограничений скорости).

Полный список изменений для конкретных моделей, которые применяет навык, см. в разделах Миграция на Claude Opus 5.5 с Claude Opus 5, Миграция на Claude Opus 5.5 с Claude Opus 4.8, Миграция на Claude Sonnet 5.5 с Claude Sonnet 5, Руководство по миграции на Claude Haiku 5.5 и Руководство по миграции на Claude Fable 5.1 и Claude Mythos 5.1.

Проверка интеграции на совместимость с сохранёнными размышлениями

Сохранённые размышления (preserved thinking) сохраняют блок thinking действительным только до тех пор, пока подсказка system, tools и предшествующие ему сообщения остаются неизменными. Чтобы найти и исправить места, где ваш код редактирует эту историю, откройте репозиторий, который формирует ваши запросы, и вызовите подкоманду preserved-thinking-migration:

Навык выполняет пять шагов:

1. Область: проверяет, затронута ли ваша интеграция, затем отправляет три тестовых запроса, чтобы убедиться, что API сообщает о намеренной правке.
2. Поиск: записывает несколько ваших собственных многоходовых сессий, сравнивает последовательные запросы и перечисляет все места, где ваш код редактирует префикс.
3. Измерение: воспроизводит сессии с "drop_block" и сообщает, в каких диалогах теряются блоки thinking, на каком ходу и почему.
4. Исправление: заменяет по одной правке за раз соответствующим шаблоном из раздела Внесение изменений без редактирования префикса и повторяет измерение после каждого изменения.
5. Отчёт: подводит итоги по каждой причине, внесённому для неё изменению и показателям до и после.

Если в вашем проекте есть оценка (eval), навык также сравнивает баллы и использование токенов с отброшенными блоками thinking и без них.

Тестовые запросы и воспроизведения — это реальные запросы к Messages API, которые оплачиваются по обычным тарифам модели. Каждое воспроизведение запрашивает лишь несколько выходных токенов и устанавливает tool_choice в значение none, поэтому ни один инструмент не запускается. Навык сообщает стоимость и запрашивает ваше одобрение перед их отправкой.

Настройка Managed Agent

Чтобы создать каркас нового Managed Agent с нуля, вызовите подкоманду managed-agents-onboard:

Навык проводит интервью, которое знакомит вас с ментальной моделью Managed Agents (конфигурации агентов в сравнении с сессиями), создаёт шаблон конфигурации агента, настраивает окружения и инструменты, настраивает цикл сессии и выдаёт готовый к запуску код для вашего языка. Навык также охватывает обязательный поток Agent (один раз) → Session (каждый запуск): model, system и tools находятся в агенте, никогда в сессии, а агенты должны создаваться один раз и использоваться по идентификатору.

Managed Agents требует бета-заголовок managed-agents-2026-04-01, который SDK устанавливает автоматически для всех вызовов client.beta.agents.*, client.beta.environments.*, client.beta.sessions.* и client.beta.vaults.*.

Примеры использования

Вот примеры задач, с которыми навык помогает справиться Claude.

Создание чат-приложения:

Миграция существующего проекта:

Первоначальная настройка нового Managed Agent:

В каждом случае навык загружает документацию для нужного языка и помогает Claude выполнить реализацию с использованием актуальных шаблонов API и лучших практик.

Следующие шаги