---
title: Навык Claude API
url: https://platform.claude.com/docs/ru/agents-and-tools/agent-skills/claude-api-skill
description: Навык агента (Agent Skill) с открытым исходным кодом, который предоставляет Claude актуальные справочные материалы по API, документацию SDK и лучшие практики для создания приложений с использованием Claude API и Claude Managed Agents.
---
Навык `claude-api` — это [Agent Skill](https://platform.claude.com/docs/ru/agents-and-tools/agent-skills/overview) (навык агента) с открытым исходным кодом, который предоставляет Claude подробные, актуальные справочные материалы для создания приложений на двух поверхностях Anthropic:
* **Messages API:** Основная поверхность для одиночных запросов, чата с потоковой передачей, использования инструментов, пакетной обработки, кэширования подсказок, структурированных выходных данных и пользовательских агентных циклов.
* **Claude Managed Agents (бета):** Размещаемая Anthropic поверхность для управляемых сервером агентов с сохранением состояния, с выполнением инструментов на стороне Anthropic, постоянными конфигурациями агентов и песочницами для каждой сессии.
Он охватывает восемь языков программирования как для Messages API, так и для Managed Agents: Python, TypeScript, C#, Go, Java, PHP, Ruby и cURL.
Навык поставляется в комплекте с [Claude Code](https://code.claude.com/docs/en/overview), а также доступен в открытом [репозитории навыков Anthropic](https://github.com/anthropics/skills), откуда вы можете установить его в любую среду, поддерживающую Agent Skills.
Навык использует «progressive disclosure» ([постепенное раскрытие](https://platform.claude.com/docs/ru/agents-and-tools/agent-skills/overview#how-skills-work)), чтобы эффективно расходовать контекст: Claude загружает только документацию, относящуюся к языку вашего проекта, поверхности (Messages API или Managed Agents) и конкретной текущей задаче (использование инструментов, потоковая передача, пакеты и так далее), а не загружает всё сразу.
## Что предоставляет навык
После активации навык предоставляет Claude следующее.
**Для Messages API:**
* **Документация SDK для конкретного языка:** установка, быстрый старт, распространённые шаблоны и обработка ошибок для языка вашего проекта
* **Руководство по использованию инструментов:** примеры для конкретного языка и [концептуальные основы](https://platform.claude.com/docs/ru/agents-and-tools/tool-use/overview) вызова функций, включая бета-версию tool runner там, где она доступна
* **Шаблоны потоковой передачи:** детали реализации для создания интерфейсов чата и постепенного отображения ответа
* **Пакетная обработка:** офлайн-обработка пакетов за 50% стоимости
* **Кэширование подсказок:** проектирование стабильного префикса, размещение точек останова и аудит скрытых факторов, незаметно сбрасывающих кэш
* **Миграция моделей:** пошаговое руководство по переходу на более новые модели Claude (включая критические изменения и изменения поведения в [Claude Opus 5.5](https://platform.claude.com/docs/ru/models/opus-5-5/migration-guide#migrating-from-claude-opus-5), [Claude Sonnet 5.5](https://platform.claude.com/docs/ru/models/sonnet-5-5/migration-guide#migrating-from-claude-sonnet-5), [Claude Haiku 5.5](https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide) и [Claude Fable 5.1](https://platform.claude.com/docs/ru/models/fable-5-1/migration-guide))
* **Миграция на сохранённые размышления:** поиск, измерение и исправление правок истории, которые делают недействительными блоки `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](https://platform.claude.com/docs/ru/build-with-claude/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), и загружает соответствующую документацию.
| Язык | SDK Messages API | Tool runner | Managed Agents |
| ---------- | ---------------- | ----------- | -------------- |
| Python | Да | Да (бета) | Да (бета) |
| TypeScript | Да | Да (бета) | Да (бета) |
| C# | Да | Да (бета) | Да (бета) |
| Go | Да | Да (бета) | Да (бета) |
| Java | Да | Да (бета) | Да (бета) |
| PHP | Да | Да (бета) | Да (бета) |
| Ruby | Да | Да (бета) | Да (бета) |
| cURL | Да | Н/Д | Да (бета) |
Если ваш проект использует несколько языков, Claude спросит, какой из них применим. Для неподдерживаемых языков (Rust, Swift, C++) навык предоставляет примеры cURL/сырого HTTP.
## Как использовать навык
### В Claude Code (в комплекте)
Навык поставляется вместе с [Claude Code](https://code.claude.com/docs/en/overview) и не требует установки. Когда вы просите Claude помочь создать что-либо с использованием Claude API или когда ваш проект уже импортирует SDK Anthropic, навык активируется автоматически.
Вы также можете вызвать его напрямую:
Используйте этот навык в Claude Code
```text
/claude-api
```
Подробнее о том, как работают встроенные навыки в Claude Code, см. в [документации по навыкам Claude Code](https://code.claude.com/docs/en/skills#bundled-skills).
### Из репозитория навыков
Исходный код навыка доступен в [репозитории навыков Anthropic](https://github.com/anthropics/skills). Вы можете установить его с помощью команды `npx`:
```bash
npx skills add https://github.com/anthropics/skills --skill claude-api
```
Или попросите Claude Code установить его как [плагин Claude Code](https://code.claude.com/docs/en/plugins):
Позвольте Claude Code установить это за вас
```text
Установи плагин claude-api из маркетплейса плагинов anthropics/skills
```
```text wrap
/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skills
```
## Миграция на более новую модель Claude
Навык Claude API умеет выполнять миграцию моделей Claude по всей кодовой базе. Вызовите его напрямую командой `/claude-api migrate`:
Позвольте Claude Code выполнить миграцию вашего кода за вас
```text
/claude-api migrate этот проект на последнюю модель Claude Opus
```
Чтобы пропустить вопрос о подтверждении области действия, укажите её сразу:
Позвольте Claude Code выполнить миграцию вашего кода за вас
```text
/claude-api migrate всё в src/ на последнюю модель Claude Opus
```
Позвольте Claude Code выполнить миграцию вашего кода за вас
```text
/claude-api migrate apps/api.py и apps/worker.py на последнюю модель Claude Opus
```
Если область действия неоднозначна (например, при вызове `/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"}`
* **Замена предзаполнения**: шаблоны предзаполнения сообщений ассистента преобразуются в [структурированные выходные данные](https://platform.claude.com/docs/ru/build-with-claude/structured-outputs), где это применимо
* **Очистка бета-заголовков**: навык удаляет бета-заголовки, которые не требуются целевой модели (например, `effort-2025-11-24`, `fine-grained-tool-streaming-2025-05-14`, `interleaved-thinking-2025-05-14`), и переключает вызовы обратно с `client.beta.messages.create()` (go: `client.Beta.Messages.New()`; java: `client.beta().messages().create()`; csharp: `client.Beta.Messages.Create()`; php: `$client->beta->messages->create()`) на `client.messages.create()` (go: `client.Messages.New()`; java: `client.messages().create()`; csharp: `client.Messages.Create()`; php: `$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"` перед чтением содержимого ответа и настраивает [резервный путь повторной попытки](https://platform.claude.com/docs/ru/build-with-claude/refusals-and-fallback), когда целевой моделью является 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](https://platform.claude.com/docs/ru/models/opus-5-5/migration-guide#migrating-from-claude-opus-5), [Миграция на Claude Opus 5.5 с Claude Opus 4.8](https://platform.claude.com/docs/ru/models/opus-5-5/migration-guide#migrating-from-claude-opus-4-8), [Миграция на Claude Sonnet 5.5 с Claude Sonnet 5](https://platform.claude.com/docs/ru/models/sonnet-5-5/migration-guide#migrating-from-claude-sonnet-5), [Руководство по миграции на Claude Haiku 5.5](https://platform.claude.com/docs/ru/models/haiku-5-5/migration-guide) и [Руководство по миграции на Claude Fable 5.1 и Claude Mythos 5.1](https://platform.claude.com/docs/ru/models/fable-5-1/migration-guide).
## Проверка интеграции на совместимость с сохранёнными размышлениями
[Сохранённые размышления](https://platform.claude.com/docs/ru/build-with-claude/preserved-thinking) (preserved thinking) сохраняют блок `thinking` действительным только до тех пор, пока подсказка `system`, `tools` и предшествующие ему сообщения остаются неизменными. Чтобы найти и исправить места, где ваш код редактирует эту историю, откройте репозиторий, который формирует ваши запросы, и вызовите подкоманду `preserved-thinking-migration`:
Позвольте Claude Code проверить ваш код за вас
```text
/claude-api preserved-thinking-migration
```
Навык выполняет пять шагов:
1. **Область:** проверяет, затронута ли ваша интеграция, затем отправляет три тестовых запроса, чтобы убедиться, что API сообщает о намеренной правке.
2. **Поиск:** записывает несколько ваших собственных многоходовых сессий, сравнивает последовательные запросы и перечисляет все места, где ваш код редактирует префикс.
3. **Измерение:** воспроизводит сессии с `"drop_block"` и сообщает, в каких диалогах теряются блоки `thinking`, на каком ходу и почему.
4. **Исправление:** заменяет по одной правке за раз соответствующим шаблоном из раздела [Внесение изменений без редактирования префикса](https://platform.claude.com/docs/ru/build-with-claude/preserved-thinking#replace-prefix-edits) и повторяет измерение после каждого изменения.
5. **Отчёт:** подводит итоги по каждой причине, внесённому для неё изменению и показателям до и после.
Если в вашем проекте есть оценка (eval), навык также сравнивает баллы и использование токенов с отброшенными блоками `thinking` и без них.
Тестовые запросы и воспроизведения — это реальные запросы к Messages API, которые оплачиваются по обычным тарифам модели. Каждое воспроизведение запрашивает лишь несколько выходных токенов и устанавливает `tool_choice` в значение `none`, поэтому ни один инструмент не запускается. Навык сообщает стоимость и запрашивает ваше одобрение перед их отправкой.
## Настройка Managed Agent
Чтобы создать каркас нового Managed Agent с нуля, вызовите подкоманду `managed-agents-onboard`:
Позвольте Claude Code настроить вашего агента за вас
```text
/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.
**Создание чат-приложения:**
Позвольте Claude Code создать это за вас
```text
Создай интерфейс чата с потоковой передачей на основе Claude API на TypeScript
```
**Миграция существующего проекта:**
Позвольте Claude Code выполнить миграцию вашего кода за вас
```text
/claude-api migrate эту кодовую базу на последнюю модель Claude Opus и заново настрой effort
```
**Первоначальная настройка нового Managed Agent:**
Позвольте Claude Code настроить вашего агента за вас
```text
/claude-api managed-agents-onboard
```
В каждом случае навык загружает документацию для нужного языка и помогает Claude выполнить реализацию с использованием актуальных шаблонов API и лучших практик.
## Следующие шаги
Узнайте, как работают Agent Skills и модель постепенного раскрытия
Просмотрите официальные SDK Anthropic для всех поддерживаемых языков
Изучите публичный репозиторий навыков Anthropic на GitHub