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 construir aplicações em duas superfícies da Anthropic:

• Messages API: A superfície principal para requisições únicas, chat com streaming, uso de ferramentas, processamento em lote, 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 cobre oito linguagens de programação tanto para a Messages API quanto para os 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: 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 Claude com:

Para a Messages API:

• Documentação de SDK específica por 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 por linguagem e fundamentos conceituais para chamada de funções, incluindo o tool runner beta quando disponível
• Padrões de streaming: Detalhes de implementação para construir interfaces de chat e lidar com exibição incremental
• Processamento em lote: Processamento em lote offline com 50% de custo
• Cache de prompt: Design de estabilidade de prefixo, posicionamento de breakpoints e auditoria de invalidadores silenciosos
• Migração de modelos: 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)
• Informações atuais dos modelos: IDs de modelos, tamanhos de janela de contexto e preços
• Armadilhas comuns: Orientação detalhada sobre como evitar erros frequentes ao integrar com a API

Para Managed Agents (beta):

• Fluxo de onboarding: Um passo a passo guiado por entrevista para configurar um novo Managed Agent do zero, disponível através do subcomando /claude-api managed-agents-onboard
• Documentação de Managed Agents específica por 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, armadilhas de montagem de arquivos e tratamento de credenciais
• Restrições de implantação: Managed Agents está disponível apenas na API do Claude e na 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 uso de ferramentas em vez disso.



Quando a skill é ativada

A skill é ativada de duas formas:

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 construir, depurar ou otimizar algo com a API do Claude, um SDK da Anthropic ou Managed Agents
• Você adiciona, modifica ou ajusta um recurso do Claude em um arquivo (cache de prompt, pensamento adaptativo, compactação, uso de ferramentas, lotes, arquivos, citações, memória) ou uma referência a um modelo

Invocação manual digitando /claude-api (com subcomando opcional ou texto livre) 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 múltiplas linguagens, Claude pergunta qual delas se aplica. Para linguagens não suportadas (Rust, Swift, C++), a skill fornece exemplos em cURL/HTTP puro.



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 construir algo com a API do Claude, 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 API do Claude pode realizar migrações de modelos 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 de 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 pulando 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 Claude Opus 4.8 e 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 que estão em GA no modelo de destino (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 programação e agênticos no Claude Opus 4.8 e 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, reativando a sumarização de pensamento (thinking.display: "summarized") quando o raciocínio é exibido aos usuários no Claude Opus 4.8 e 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 retry de fallback quando o destino é Claude Fable 5 ou Claude Opus 5 (o parâmetro fallbacks do lado do servidor, tipicamente em seu modo "default", o middleware de refusal-fallback do SDK, ou um retry com crédito de fallback), e atualizando código de fallback escrito com base em formatos de preview anteriores

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

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



Configurando um Managed Agent

Para estruturar 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 dos Managed Agents (configurações de Agente versus Sessões), 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 Agente (uma vez) → Sessão (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.

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 Claude:

Construindo 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 onboarding de um novo Managed Agent:

/claude-api managed-agents-onboard

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



Próximos passos