Навык 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 и Claude Fable 5.1)
• Актуальная информация о моделях: Идентификаторы моделей, размеры контекстного окна и цены
• Распространённые ошибки: Подробное руководство по избежанию частых ошибок при интеграции с API

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

• Процесс онбординга: Пошаговое руководство в формате интервью по настройке нового Managed Agent с нуля, доступное через подкоманду /claude-api managed-agents-onboard
• Документация Managed Agents для конкретного языка: Создание постоянных агентов, запуск сессий, потоковая передача событий и обработка подтверждений инструментов для Python, TypeScript, C#, Go, Java, PHP, Ruby и cURL
• Клиентские паттерны: Переподключение к потоку без потерь, шлюз queued/processed на основе processed_at, обработка прерываний, подводные камни монтирования файлов и работа с учётными данными
• Ограничения развёртывания: Managed Agents доступен только в Claude API и Claude Platform на 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-api

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

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

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

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

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

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

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

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

/claude-api migrate this project to claude-opus-5

Вы также можете сразу передать конкретную область действия, чтобы пропустить вопрос о подтверждении области:

/claude-api migrate everything under src/ to claude-opus-5
/claude-api migrate apps/api.py and apps/worker.py to claude-opus-5

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

Навык обрабатывает:

• Замену идентификаторов моделей, включая типизированные константы SDK (Model.CLAUDE_OPUS_4_8 → Model.CLAUDE_OPUS_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)
• Настройку поведения подсказок, отмечая подсказки для контроля длины, запуска инструментов, субагентов и следования инструкциям, которые могут вести себя иначе на целевой модели
• Обработку скрытых значений по умолчанию, повторно включая суммаризацию мышления (thinking.display: "summarized"), когда рассуждения показываются пользователям в Claude Opus 4.8 и Claude Opus 4.7
• Настройку резервного варианта при отказе, добавляя обработку stop_reason: "refusal" перед чтением содержимого ответа и настраивая резервный путь повторной попытки, когда целевой моделью является Claude Fable 5.1, Claude Fable 5 или Claude Opus 5 (серверный параметр fallbacks, обычно в режиме "default", промежуточное ПО SDK для резервного варианта при отказе или повторная попытка с резервным кредитом), а также обновляя резервный код, написанный под более ранние предварительные версии

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

Полный список специфичных для моделей изменений, которые применяет навык, см. в разделах Миграция на Claude Opus 5 с Claude Opus 4.8 и Миграция на Claude Fable 5.1.

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

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

/claude-api 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 справляться:

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

Build a streaming chat UI with the Claude API in TypeScript

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

/claude-api migrate this codebase to claude-opus-5 and re-tune effort

Онбординг нового Managed Agent:

/claude-api managed-agents-onboard

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

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