Навык Claude API

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

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

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

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

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



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

При активации навык снабжает Claude следующим:

Для Messages API:

• Документация по SDK для конкретного языка: установка, быстрый старт, распространённые паттерны и обработка ошибок для языка вашего проекта
• Руководство по использованию инструментов: примеры для конкретного языка и концептуальные основы вызова функций, включая бета-версию исполнителя инструментов (tool runner), где она доступна
• Паттерны потоковой передачи: детали реализации для создания чат-интерфейсов и обработки инкрементального отображения
• Пакетная обработка: офлайн-обработка пакетов со скидкой 50%
• Кэширование подсказок: проектирование стабильности префиксов, размещение точек останова и аудит скрытых инвалидаторов
• Миграция моделей: пошаговое руководство по миграции на более новые модели Claude (включая критические изменения и изменения поведения в Claude Opus 4.8)
• Актуальная информация о моделях: идентификаторы моделей, размеры контекстного окна и цены
• Распространённые ошибки: подробное руководство по избежанию частых ошибок при интеграции с 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-4-8

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

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

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

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

• Замену идентификаторов моделей, включая типизированные константы SDK (Model.CLAUDE_OPUS_4_7 → Model.CLAUDE_OPUS_4_8) во всех поддерживаемых языках, и классифицирует каждый файл как вызывающий код, определитель модели или непрозрачную строковую ссылку перед редактированием
• Определение облачной платформы, сохраняя специфичные для платформы форматы идентификаторов моделей (например, префикс 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"}
• Замену префилла, преобразуя паттерны префилла сообщений ассистента в структурированные выводы, где это применимо
• Очистку бета-заголовков, удаляя заголовки, которые стали общедоступными (GA) в целевой модели (например, 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 для целевой модели (например, 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 (серверный параметр fallbacks, промежуточное ПО SDK для резервного варианта при отказе или повторная попытка с резервным кредитом), а также обновляя код резервного варианта, написанный для более ранних предварительных форматов

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

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



Настройка Managed Agent

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

/claude-api managed-agents-onboard

Навык запускает интервью, которое проводит вас через ментальную модель Managed Agents (конфигурации агентов и сессии), создаёт шаблон конфигурации агента, настраивает окружения и инструменты, настраивает цикл сессии и генерирует исполняемый код для вашего языка. Навык также охватывает обязательный поток Агент (один раз) → Сессия (каждый запуск): 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-4-8 and re-tune effort

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

/claude-api managed-agents-onboard

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



Дальнейшие шаги