Skill da API do Claude

A skill claude-api é uma Agent Skill de código aberto que fornece ao Claude material de referência detalhado e atualizado para criar aplicações em duas superfícies da Anthropic:

• Messages API: A superfície principal para requisições únicas, chat com streaming, "tool use" (uso de ferramentas), processamento em lote, "prompt caching" (cache de prompt), saídas estruturadas e loops de agente personalizados.
• Claude Managed Agents (beta): Uma superfície hospedada pela Anthropic para agentes com estado gerenciados pelo servidor, com execução de ferramentas hospedada pela Anthropic, configurações de agente persistentes e sandboxes por sessão.

Ela abrange oito linguagens de programação tanto para a Messages API quanto para o Managed Agents: Python, TypeScript, C#, Go, Java, PHP, Ruby e cURL.

A skill vem incluída no Claude Code e também está disponível no repositório de skills da Anthropic de código aberto, onde você pode instalá-la em qualquer ambiente que suporte Agent Skills.

A skill usa divulgação progressiva para manter o contexto eficiente: o Claude carrega apenas a documentação relevante para a linguagem do seu projeto, a superfície (Messages API ou Managed Agents) e a tarefa específica em questão (uso de ferramentas, streaming, lotes e assim por diante), em vez de carregar tudo de uma vez.

O que a skill fornece

Quando acionada, a skill equipa o Claude com:

Para a Messages API:

• Documentação de SDK específica da linguagem: Instalação, início rápido, padrões comuns e tratamento de erros para a linguagem do seu projeto
• Orientação sobre uso de ferramentas: Exemplos específicos da linguagem e fundamentos conceituais para chamada de funções, incluindo o tool runner beta onde disponível
• Padrões de streaming: Detalhes de implementação para criar interfaces de chat e lidar com exibição incremental
• Processamento em lote: Processamento em lote offline com 50% do custo
• Cache de prompt: Design de estabilidade de prefixo, posicionamento de breakpoints e auditoria de invalidadores silenciosos
• Migração de modelo: Orientação passo a passo para migrar para modelos Claude mais recentes (incluindo as mudanças incompatíveis e alterações de comportamento no Claude Opus 5 e no Claude Fable 5.1)
• Informações atuais sobre modelos: IDs de modelo, tamanhos de "context window" (janela de contexto) e preços
• Armadilhas comuns: Orientação detalhada sobre como evitar erros frequentes ao integrar com a API

Para o Managed Agents (beta):

• Fluxo de onboarding: Um passo a passo guiado por entrevista para configurar um novo Managed Agent do zero, disponível por meio do subcomando /claude-api managed-agents-onboard
• Documentação do Managed Agents específica da linguagem: Criação de agentes persistentes, início de sessões, streaming de eventos e tratamento de confirmações de ferramentas para Python, TypeScript, C#, Go, Java, PHP, Ruby e cURL
• Padrões de cliente: Reconexão de stream sem perdas, gate de enfileirado/processado com processed_at, tratamento de interrupções, pegadinhas de montagem de arquivos e tratamento de credenciais
• Restrições de implantação: O Managed Agents está disponível apenas na Claude API e no Claude Platform on AWS (não no Amazon Bedrock, Google Cloud ou Microsoft Foundry). A skill direciona outras implantações para a Messages API e o uso de ferramentas.

Quando a skill é ativada

A skill é ativada de duas maneiras:

Ativação automática ocorre quando:

• Seu código importa um SDK da Anthropic (anthropic para Python, @anthropic-ai/sdk para TypeScript/JavaScript)
• Você pede ao Claude para ajudar a criar, depurar ou otimizar algo com a Claude API, um SDK da Anthropic ou o Managed Agents
• Você adiciona, modifica ou ajusta um recurso do Claude em um arquivo (cache de prompt, pensamento adaptativo, compactação, uso de ferramentas, lote, arquivos, citações, memória) ou uma referência de modelo

Invocação manual digitando /claude-api (com subcomando ou texto opcional) em qualquer ambiente onde a skill esteja instalada.

A skill não é ativada para tarefas gerais de programação, trabalho de ML/ciência de dados ou código que importa outros SDKs de IA (como OpenAI).

Linguagens suportadas

A skill detecta a linguagem do seu projeto automaticamente examinando os arquivos do projeto (por exemplo, requirements.txt para Python, tsconfig.json para TypeScript, go.mod para Go) e carrega a documentação apropriada.

Se o seu projeto usa várias linguagens, o Claude pergunta qual delas se aplica. Para linguagens não suportadas (Rust, Swift, C++), a skill fornece exemplos em cURL/HTTP bruto.

Como usar a skill

No Claude Code (incluída)

A skill é distribuída com o Claude Code e não requer instalação. Quando você pede ao Claude para ajudar a criar algo com a Claude API, ou quando seu projeto já importa um SDK da Anthropic, a skill é ativada automaticamente.

Você também pode invocá-la diretamente:

/claude-api

Para saber mais sobre como as skills incluídas funcionam no Claude Code, consulte a documentação de skills do Claude Code.

A partir do repositório de skills

O código-fonte da skill está disponível no repositório de skills da Anthropic. Você pode instalá-la usando o comando npx:

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

Ou instalá-la como um plugin do Claude Code:

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

Migrando para um modelo Claude mais recente

A skill da Claude API pode realizar migrações de modelo Claude em toda uma base de código. Invoque-a diretamente com /claude-api migrate:

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

Você também pode passar um escopo específico antecipadamente para pular a pergunta de confirmação de escopo:

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

Quando o escopo é ambíguo (por exemplo, um simples /claude-api migrate to claude-opus-5), a skill pede que você escolha entre o diretório de trabalho inteiro, um subdiretório específico ou uma lista explícita de arquivos antes de editar qualquer arquivo. Isso se aplica tanto a chamadores da Messages API quanto do Managed Agents.

A skill lida com:

• Trocas de ID de modelo, incluindo constantes tipadas do SDK (Model.CLAUDE_OPUS_4_8 → Model.CLAUDE_OPUS_5) em todas as linguagens suportadas, e classifica cada arquivo como um chamador, um definidor de modelo ou uma referência de string opaca antes de editar
• Detecção de plataforma de nuvem, preservando formatos de ID de modelo específicos da plataforma (por exemplo, o prefixo anthropic. no Amazon Bedrock) e ignorando alterações para recursos que não estão disponíveis em plataformas operadas por parceiros
• Mudanças incompatíveis de parâmetros, como remover temperature, top_p e top_k para o Claude Opus 4.8 e o Claude Opus 4.7, e converter thinking: {type: "enabled", budget_tokens: N} para thinking: {type: "adaptive"}
• Substituição de prefill, convertendo padrões de prefill de mensagem do assistente para saídas estruturadas quando aplicável
• Limpeza de cabeçalhos beta, removendo cabeçalhos beta que o modelo de destino não requer (por exemplo, effort-2025-11-24, fine-grained-tool-streaming-2025-05-14, interleaved-thinking-2025-05-14) e voltando de client.beta.messages.create para client.messages.create
• Calibração de esforço, recomendando um ponto de partida de output_config.effort para o modelo de destino (por exemplo, o padrão high no Claude Opus 5, e xhigh para casos de uso de codificação e agênticos no Claude Opus 4.8 e no Claude Opus 4.7)
• Ajuste de comportamento de prompt, sinalizando prompts de controle de comprimento, acionamento de ferramentas, subagentes e seguimento de instruções que podem se comportar de forma diferente no modelo de destino
• Tratamento de padrões silenciosos, optando novamente pela sumarização de pensamento (thinking.display: "summarized") quando o raciocínio é exibido aos usuários no Claude Opus 4.8 e no Claude Opus 4.7
• Configuração de fallback de recusa, adicionando tratamento de stop_reason: "refusal" antes de ler o conteúdo da resposta e configurando um caminho de nova tentativa com fallback quando o destino é o Claude Fable 5.1, Claude Fable 5 ou Claude Opus 5 (o parâmetro fallbacks do lado do servidor, normalmente em seu modo "default", o middleware de fallback de recusa do SDK ou uma nova tentativa com crédito de fallback), e atualizando código de fallback escrito com base em formatos de preview anteriores

À medida que edita, a skill explica cada alteração e sua motivação inline. Ao concluir, ela produz uma checklist de itens que requerem verificação manual (normalmente testes de integração, ajuste de prompts de controle de comprimento e redefinição de linha de base de custo/"rate limit" (limite de taxa)).

Para a lista completa de alterações específicas de modelo que a skill aplica, consulte Migrando para o Claude Opus 5 a partir do Claude Opus 4.8 e Migrando para o Claude Fable 5.1.

Configurando um Managed Agent

Para criar a estrutura de um novo Managed Agent do zero, invoque o subcomando managed-agents-onboard:

/claude-api managed-agents-onboard

A skill executa uma entrevista que guia você pelo modelo mental do Managed Agents (configurações de Agent versus Sessions), cria um template de configuração de agente, configura ambientes e ferramentas, configura o loop de sessão e emite código executável para a sua linguagem. A skill também cobre o fluxo obrigatório Agent (uma vez) → Session (a cada execução): model, system e tools ficam no agente, nunca na sessão, e os agentes devem ser criados uma vez e referenciados por ID.

O Managed Agents requer o cabeçalho beta managed-agents-2026-04-01, que o SDK define automaticamente para todas as chamadas client.beta.agents.*, client.beta.environments.*, client.beta.sessions.* e client.beta.vaults.*.

Exemplo de uso

Aqui estão exemplos de tarefas com as quais a skill ajuda o Claude a lidar:

Criando uma aplicação de chat:

Build a streaming chat UI with the Claude API in TypeScript

Migrando um projeto existente:

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

Fazendo o onboarding de um novo Managed Agent:

/claude-api managed-agents-onboard

Em cada caso, a skill carrega a documentação específica da linguagem relevante e guia o Claude pela implementação usando padrões de API atuais e melhores práticas.

Próximos passos