Habilidade Claude API

A habilidade claude-api é uma Habilidade de Agente de código aberto que fornece ao Claude material de referência detalhado e atualizado para construir aplicações em duas superfícies Anthropic:

• Messages API — a superfície principal para solicitaçõ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 de primeira parte para agentes com estado gerenciado por servidor com execução de ferramentas hospedada pela Anthropic, configurações de agente persistentes e contêineres por sessão.

Ela cobre 8 linguagens de programação para a Messages API (Python, TypeScript, Java, Go, Ruby, C#, PHP e cURL) e 7 linguagens para Managed Agents (Python, TypeScript, Java, Go, Ruby, PHP e cURL — C# não é atualmente suportado).

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

A habilidade usa divulgação progressiva para manter o contexto eficiente: Claude carrega apenas a documentação relevante para a linguagem do seu projeto, 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 habilidade fornece

Quando acionada, a habilidade equipa 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 de uso de ferramentas: Exemplos específicos da linguagem e fundações conceituais para chamadas de função, incluindo o executor de ferramentas beta onde disponível
• Padrões de streaming: Detalhes de implementação para construir UIs de chat e lidar com exibição incremental
• Processamento em lote: Processamento em lote offline com 50% de desconto
• Cache de prompt: Design de estabilidade de prefixo, colocação de pontos de interrupção e auditoria de invalidador silencioso
• Migração de modelo: Orientação passo a passo para migrar para modelos Claude mais novos (incluindo as mudanças significativas e mudanças de comportamento em Claude Opus 4.7)
• Informações de modelo atual: 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 integração: Um passo a passo orientado por entrevista para configurar um novo Managed Agent do zero, disponível via 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, Java, Go, Ruby, PHP e cURL
• Padrões de cliente: Reconexão de stream sem perdas, portão processed_at enfileirado/processado, tratamento de interrupção, armadilhas de montagem de arquivo e tratamento de credenciais
• Restrições de implantação: Managed Agents é apenas de primeira parte (não disponível em Amazon Bedrock, Google Vertex AI ou Microsoft Foundry) — a habilidade roteia implantações de terceiros para Messages API + uso de ferramentas

Quando a habilidade é ativada

A habilidade é ativada de duas maneiras:

A ativação automática ocorre quando:

• Seu código importa um SDK Anthropic (anthropic para Python, @anthropic-ai/sdk para TypeScript/JavaScript)
• Você pede ao Claude para ajudar a construir, depurar ou otimizar algo com a Claude API, um SDK Anthropic ou Managed Agents
• Você adiciona, modifica ou ajusta um recurso 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 opcional ou prosa) em qualquer ambiente onde a habilidade está instalada.

A habilidade 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 habilidade detecta automaticamente a linguagem do seu projeto examinando arquivos do projeto (por exemplo, requirements.txt para Python, tsconfig.json para TypeScript, go.mod para Go) e carrega a documentação apropriada.

Se seu projeto usa múltiplas linguagens, Claude pergunta qual se aplica. Para linguagens não suportadas (Rust, Swift, C++), a habilidade fornece exemplos cURL/HTTP brutos.

Como usar a habilidade

Em Claude Code (agrupada)

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

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

/claude-api

Para mais informações sobre como as habilidades agrupadas funcionam em Claude Code, consulte a documentação de habilidades do Claude Code.

Do repositório de habilidades

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

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

Ou instale-a como um plugin do Claude Code:

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

Migrando para um modelo Claude mais novo

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

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

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

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

A habilidade lida com:

• Trocas de ID de modelo, incluindo constantes de SDK digitadas (Model.CLAUDE_OPUS_4_6 → Model.CLAUDE_OPUS_4_7) 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
• Mudanças de parâmetro significativas, como remover temperature, top_p e top_k para 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 de assistente para saídas estruturadas onde aplicável
• Limpeza de cabeçalho beta, removendo cabeçalhos que são GA no modelo de destino (por exemplo, effort-2025-11-24, fine-grained-tool-streaming-2025-05-14, interleaved-thinking-2025-05-14) e alternando de volta de para

Conforme edita, a habilidade explica cada mudança e sua motivação inline. Ao concluir, ela produz uma lista de verificação de itens que requerem verificação manual (normalmente testes de integração, ajuste de prompt de controle de comprimento e re-baseline de custo/limite de taxa).

Para a lista completa de mudanças específicas do modelo que a habilidade aplica, consulte Migrando para Claude Opus 4.7.

Configurando um Managed Agent

Para estruturar um novo Managed Agent do zero, invoque o subcomando managed-agents-onboard:

/claude-api managed-agents-onboard

A habilidade executa uma entrevista que o orienta através do modelo mental de Managed Agents (Configurações de Agente versus Sessões), cria um modelo de configuração de agente, configura ambientes e ferramentas, configura o loop de sessão e emite código executável para sua linguagem. A habilidade também cobre o fluxo obrigatório Agente (uma vez) → Sessão (a cada execução) — model, system e tools vivem 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 habilidade ajuda Claude a lidar:

Construindo um aplicativo 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-7 and re-tune effort

Integrando um novo Managed Agent:

/claude-api managed-agents-onboard

Em cada caso, a habilidade carrega a documentação específica da linguagem relevante e orienta Claude através da implementação usando padrões de API atuais e melhores práticas.

Próximos passos