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, 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 8 linguagens de programação tanto para a Messages API quanto para 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 "progressive disclosure" (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 chamadas de função, incluindo o tool runner beta quando 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% de desconto no 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 4.8)
• Informações atuais sobre modelos: IDs de modelo, 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 orientado por entrevista para configurar um novo Managed Agent do zero, disponível via o subcomando /claude-api managed-agents-onboard
• Documentação de 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 via processed_at, tratamento de interrupções, pegadinhas 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 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 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, 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 vem incluída no Claude Code e não requer instalação. Quando você pede ao Claude para ajudar a criar 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 mais informações 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 modelo Claude em toda uma base de código. Invoque-a diretamente com /claude-api migrate:

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

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-4-8
/claude-api migrate apps/api.py and apps/worker.py to claude-opus-4-8

Quando o escopo é ambíguo (por exemplo, um simples /claude-api migrate to claude-opus-4-8), 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_7 → Model.CLAUDE_OPUS_4_8) 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 disponibilidade geral (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 para output_config.effort para o modelo de destino (por exemplo, xhigh para casos de uso de codificaçã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, subagente 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 (o parâmetro fallbacks do lado do servidor, o middleware de fallback de recusa do SDK ou um retry de 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 baseline de custo/limite de taxa).

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



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 o guia pelo modelo mental de 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 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 que a skill ajuda o Claude a realizar:

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-4-8 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 específica da linguagem relevante e orienta o Claude na implementação usando padrões atuais da API e melhores práticas.



Próximos passos