Claude API skill

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

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

Он охватывает 8 языков программирования для Messages API (Python, TypeScript, Java, Go, Ruby, C#, PHP и cURL) и 7 языков для Managed Agents (Python, TypeScript, Java, Go, Ruby, PHP и cURL — C# в настоящее время не поддерживается).

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

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

Что предоставляет skill

При активации skill оснащает Claude следующим:

Для Messages API:

• Документация SDK для конкретного языка: Установка, быстрый старт, общие паттерны и обработка ошибок для языка вашего проекта
• Руководство по использованию инструментов: Примеры для конкретного языка и концептуальные основы для вызова функций, включая бета-версию средства запуска инструментов, где доступно
• Паттерны потоковой передачи: Детали реализации для создания пользовательских интерфейсов чата и обработки пошагового отображения
• Пакетная обработка: Автономная пакетная обработка со скидкой 50%
• Кэширование подсказок: Проектирование стабильности префикса, размещение контрольных точек и аудит молчаливого инвалидатора
• Миграция модели: Пошаговое руководство по миграции на новые модели Claude (включая критические изменения и сдвиги поведения на Claude Opus 4.7)
• Информация о текущей модели: ID моделей, размеры контекстного окна и цены
• Распространённые ошибки: Подробное руководство по избеганию частых ошибок при интеграции с API

Для Managed Agents (beta):

• Поток адаптации: Управляемое интервью для настройки нового Managed Agent с нуля, доступное через подкоманду /claude-api managed-agents-onboard
• Документация Managed Agents для конкретного языка: Создание постоянных агентов, запуск сессий, потоковая передача событий и обработка подтверждений инструментов для Python, TypeScript, Java, Go, Ruby, PHP и cURL
• Паттерны клиента: Безубыточное переподключение потока, шлюз processed_at в очереди/обработанный, обработка прерываний, проблемы с монтированием файлов и обработка учётных данных
• Ограничения развёртывания: Managed Agents доступен только от первого лица (недоступен на Amazon Bedrock, Google Vertex AI или Microsoft Foundry) — skill маршрутизирует развёртывания третьих сторон на Messages API + использование инструментов вместо этого

Когда skill активируется

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

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

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

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

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

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

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

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

Как использовать skill

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

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

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

/claude-api

Дополнительную информацию о том, как работают встроенные skills в Claude Code, см. в документации skills Claude Code.

Из репозитория skills

Исходный код skill доступен в репозитории skills 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 skill может выполнять миграции моделей Claude по всей кодовой базе. Вызовите его напрямую с помощью /claude-api migrate:

/claude-api migrate this project to claude-opus-4-7

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

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

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

Skill обрабатывает:

• Замены ID модели, включая типизированные константы SDK (Model.CLAUDE_OPUS_4_6 → Model.CLAUDE_OPUS_4_7) на всех поддерживаемых языках и классифицирует каждый файл как вызывающий, определитель модели или непрозрачную ссылку на строку перед редактированием
• Критические изменения параметров, такие как удаление temperature, top_p и top_k для 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) и переключение обратно с на

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

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

Настройка Managed Agent

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

/claude-api managed-agents-onboard

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

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

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

Вот примеры задач, которые skill помогает Claude обрабатывать:

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

Build a streaming chat UI with the Claude API in TypeScript

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

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

Адаптация нового Managed Agent:

/claude-api managed-agents-onboard

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

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