Skill
Claude API
Crédito: anthropics no GitHub (anthropics/skills) · 0 cópias
Indicada na UseIA por Cristiano Rochenbach Abreu em 5 de out. de 2026
179,8 mil estrelas no GitHubVer no GitHub
Tradução feita por IA. Em caso de dúvida, vale o texto original (aba “Original”).
---
name: claude-api
description: |-
Referência da API do Claude / SDK da Anthropic — ids de modelos, preços, parâmetros, streaming, uso de ferramentas, MCP, agentes, cache, contagem de tokens, migração de modelos.
GATILHO — leia ANTES de abrir o arquivo-alvo; não pule porque "parece uma linha só" — sempre que: o prompt nomear Claude/Anthropic de qualquer forma (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); o usuário perguntar sobre um LLM (preços/escolha de modelo/limites/cache) — nunca responda de memória; OU a tarefa tiver formato de LLM sem provedor declarado (agente/MCP/definição de ferramenta/multiagente/RAG/LLM como juiz/uso de computador; gerar/resumir/extrair/classificar/reescrever/conversar em linguagem natural; depurar recusas/cortes/streaming/chamadas de ferramentas/tokens).
PULE somente quando outro provedor estiver sendo trabalhado (prevalece sobre todos os gatilhos): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama nomeados na consulta; OU `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` no projeto encontrar resultados (rode esse grep PRIMEIRO se nenhum provedor for nomeado — não leia o arquivo).
license: Complete terms in LICENSE.txt
---
# Construindo aplicações com LLM usando o Claude
Esta skill ajuda você a construir aplicações com LLM usando o Claude. Escolha a superfície certa conforme suas necessidades, detecte a linguagem do projeto e depois leia a documentação específica da linguagem.
## Antes de começar
Examine o arquivo-alvo (ou, se não houver arquivo-alvo, o prompt e o projeto) em busca de marcadores de provedores que não sejam da Anthropic - `import openai`, `from openai`, `langchain_openai`, `OpenAI(`, `gpt-4`, `gpt-5`, nomes de arquivo como `agent-openai.py` ou `*-generic.py`, ou qualquer instrução explícita para manter o código neutro quanto ao provedor. Se encontrar algum, pare e diga ao usuário que esta skill produz código com o SDK do Claude/Anthropic; pergunte se ele quer migrar o arquivo para o Claude ou se quer uma implementação que não use o Claude. Não edite um arquivo que não seja da Anthropic com chamadas ao SDK da Anthropic. (Exceção: o subcomando `prompt-audit` é não interativo e não para aqui - ele registra os marcadores de provedores que não são da Anthropic nas premissas declaradas do seu relatório e nunca propõe migrar um arquivo que não seja da Anthropic para o SDK da Anthropic.)
## Requisito de saída
Quando o usuário pedir para adicionar, modificar ou implementar uma funcionalidade do Claude, seu código deve chamar o Claude por uma destas vias:
1. **O SDK oficial da Anthropic** para a linguagem do projeto (`anthropic`, `@anthropic-ai/sdk`, `com.anthropic.*` etc.). Este é o padrão sempre que existir um SDK compatível com o projeto.
2. **HTTP puro** (`curl`, `requests`, `fetch`, `httpx` etc.) - somente quando o usuário pedir explicitamente cURL/REST/HTTP puro, quando o projeto for um projeto de shell/cURL ou quando a linguagem não tiver SDK oficial.
Nunca misture as duas - não recorra a `requests`/`fetch` em um projeto Python ou TypeScript só porque parece mais leve. Nunca recorra a camadas de compatibilidade com a OpenAI.
**Nunca adivinhe o uso do SDK.** Nomes de funções, nomes de classes, namespaces, assinaturas de métodos e caminhos de importação devem vir de documentação explícita - os arquivos `{lang}/` desta skill ou os repositórios oficiais do SDK ou links de documentação listados em `shared/live-sources.md`. Se a interface de que você precisa não estiver explicitamente documentada nos arquivos da skill, use o WebFetch no repositório relevante do SDK em `shared/live-sources.md` antes de escrever o código. Não deduza APIs de Ruby/Java/Go/PHP/C# a partir do formato de cURL nem do SDK de outra linguagem.
**Se o WebFetch ou o acesso ao repositório falhar** (rede restrita, timeouts, clone bloqueado): não fique tentando de novo - escreva o código a partir dos padrões e das tabelas de namespace/pacote do arquivo `{lang}/`, rode o compilador ou o interpretador nele e itere sobre a saída de erros. Para SDKs com tipagem estática (C#, Java, Go), um ciclo de compilar e corrigir com os erros locais chega a um código funcional mais rápido do que uma pesquisa de rede bloqueada.
## Padrões
A menos que o usuário peça de outra forma:
Para a versão do modelo Claude, use o Claude Opus 5.5, que pode ser acessado pela string de modelo exata `claude-opus-5-5`. Use por padrão o raciocínio adaptativo (`thinking: {type: "adaptive"}`) para qualquer coisa minimamente complicada. E, por fim, use por padrão o streaming para qualquer requisição que possa envolver entrada longa, saída longa ou `max_tokens` alto - isso evita estourar os timeouts da requisição. Use o auxiliar `.get_final_message()` / `.finalMessage()` do SDK para obter a resposta completa se você não precisar tratar eventos individuais do stream. Quando uma requisição em streaming definir ferramentas definidas pelo usuário (do cliente), ative `eager_input_streaming: true` em cada uma dessas ferramentas, para que entradas grandes de ferramentas (conteúdo de arquivos, código, documentos) cheguem em streaming à medida que são geradas, em vez de chegarem de uma só vez depois que o servidor termina de armazená-las em buffer; o cliente passa então a ser responsável pela validação: os parsers tolerantes dos SDKs podem devolver uma entrada silenciosamente truncada em vez de gerar um erro; portanto valide cada entrada de ferramenta interpretada contra o seu esquema antes de executá-la (os auxiliares tipados do runner, como `betaZodTool` / `@beta_tool` tipado, já fazem isso; as ferramentas com JSON Schema do `betaTool()` e os laços manuais precisam validar por conta própria), trate uma falha como um JSON inválido (um `tool_result` de erro `INVALID_JSON` quando você tem o bloco, ou reemita caso contrário), verifique os motivos de parada `max_tokens` / `refusal` antes de executar ferramentas e capture apenas o erro de JSON do SDK, nunca os erros de API tipados dele - o padrão está em `shared/tool-use-concepts.md` -> Eager input streaming. Deixe desativado em requisições sem streaming, em ferramentas de servidor e quando a requisição passa por um proxy ou por uma implantação mais antiga de modelo no Bedrock que rejeita o campo.
## Aviso: deriva da API - seu conhecimento prévio pode estar desatualizado
Vários formatos comuns da API do Claude mudaram em 2025-2026. Se você lembra de um padrão do treinamento, verifique-o contra os arquivos `{lang}/` desta skill antes de escrever — as linhas abaixo são os pontos de deriva mais frequentes:
| Área | Conhecimento desatualizado | API atual |
|---|---|---|
| Raciocínio estendido | `thinking: {type: "enabled", budget_tokens: N}` | Em modelos Claude 4.6+: `thinking: {type: "adaptive"}`. O `budget_tokens` está obsoleto no Opus 4.6 / Sonnet 4.6 e é **rejeitado com um 400** no Fable 5/5.1 / Sonnet 5.5 / Sonnet 5 / Opus 5.5 / 5 / 4.8 / 4.7. Modelos anteriores à 4.6 ainda usam `budget_tokens`. |
| Tipo da ferramenta de busca na web / de acesso a páginas | `web_search_20250305`, `web_fetch_20250910` | `web_search_20260209`, `web_fetch_20260209` (filtragem dinâmica) no Opus 5.5/5/4.8/4.7/4.6, Sonnet 5.5, Sonnet 5 e Sonnet 4.6. Modelos mais antigos mantêm as variantes básicas; na Vertex AI só está disponível o `web_search_20250305` básico (o web fetch não está na Vertex) - veja a referência rápida de Server Tools abaixo. |
| Nomes de parâmetros em PHP | nomes snake_case do protocolo como argumentos nomeados (`max_tokens`) | Os argumentos nomeados de nível superior são camelCase (`maxTokens`). As chaves de arrays aninhados variam conforme o recurso (por exemplo, `'taskBudget'`, `'skillID'`, `'mcp_server_name'`) - copie a chave exata do exemplo documentado; não converta tudo em massa. |
| Credenciais de Managed Agents | Manter os segredos no lado do host por meio de ferramentas personalizadas (a única opção antes de os vaults existirem) | Credenciais `environment_variable` em vaults - armazenadas pela Anthropic, substituídas na saída, nunca visíveis no sandbox (`shared/managed-agents-tools.md` -> Vaults). As ferramentas personalizadas no lado do host continuam sendo a alternativa para sandboxes auto-hospedados. |
| Files API / Skills | `client.beta.files.*` / `client.beta.skills.*` com os betas `files-api-2025-04-14` / `skills-2025-10-02` | Fora do beta: `client.files.*` / `client.skills.*`, sem cabeçalho beta. Nos SDKs atuais, `client.beta.files` / `client.beta.skills` têm mudanças incompatíveis de formato em relação às versões anteriores, alinhadas aos namespaces estáveis - migre conforme `shared/live-sources.md` -> Files API / Skills Guide. |
Os arquivos `{lang}/` desta skill são a autoridade, acima dos padrões lembrados.
---
## Subcomandos
Se o Pedido do Usuário no fim deste prompt for apenas uma string de subcomando (sem prosa), procure em todas as tabelas de **Subcomandos** deste documento - inclusive nas seções acrescentadas abaixo - e siga diretamente a coluna Ação correspondente. Isso permite que os usuários invoquem fluxos específicos por meio de `/claude-api <subcommand>`. Se nenhuma tabela do documento corresponder, trate o pedido como prosa normal.
| Subcomando | Ação |
|---|---|
| `migrate` | Migra código existente da API do Claude para um modelo mais novo. **Leia `shared/model-migration.md` imediatamente** e siga-o em ordem: Passo 0 (confirme o escopo - pergunte quais arquivos/diretórios antes de qualquer edição), Passo 1 (classifique cada arquivo) e depois a seção de mudanças incompatíveis do modelo de destino. Não resuma o guia - execute-o. Se o usuário não indicou um modelo de destino, pergunte para qual modelo migrar no mesmo turno da pergunta de escopo. Depois de aplicadas as mudanças do modelo de destino, audite o texto dos prompts, as descrições das ferramentas e o código das requisições do escopo contra `shared/prompt-audit.md` - o prompting escrito para o modelo de origem faz parte de toda migração e não se anuncia. |
| `prompt-audit` | Audita prompts, descrições de ferramentas, skills e arquivos de configuração de agentes (`CLAUDE.md`, arquivos de regras, comandos, subagentes) existentes em busca de padrões ultrapassados ("cruft"): textos escritos para modelos mais antigos e instruções que o repositório já superou ou que se contradizem. **Leia `shared/prompt-audit.md` imediatamente** e siga-o em ordem: Passo 0 (estabeleça o escopo e o modelo de destino a partir do pedido e do repositório - declare as suposições no relatório, não pare para perguntar), inventário, procedência e depois a varredura de padrões. Produza os dois entregáveis por completo - o relatório de auditoria (achados com `file:line`, padrão, por que está obsoleto, confiança) e uma proposta de diff - sem pausar para confirmação; aplique as edições somente se o pedido tiver solicitado isso explicitamente. Não resuma o guia - execute-o. |
| `upgrade` | Atualiza a dependência do SDK da Anthropic do projeto entre versões principais - atualmente o SDK de Python, `anthropic` 0.x -> 1.x. Palavras finais podem indicar a linguagem e/ou um escopo (`upgrade python`, `upgrade python sdk src/`). **Leia `python/claude-api/sdk-upgrade.md` imediatamente** e siga-o em ordem: Passo 0
[…] Conteúdo completo no GitHub.Funciona com:Claude

