claude-api: ligar o Claude pelo SDK oficial e evitar primeiro os parâmetros abandonados

Para quem

claude-api é para quem, no prompt, nomeia Claude ou Anthropic e precisa de uma referência de modelos, parâmetros, streaming, ferramentas ou cache. É uma referência Claude API / Anthropic SDK, não outro instalador. Quando um prompt nomeia Claude/Anthropic de qualquer forma, leia primeiro este guia; não pule porque «parece uma frase».

O uso mais justo: você vai acrescentar ou mudar uma chamada Claude num projeto existente, e a linguagem do projeto já tem um SDK oficial da Anthropic. O guia exige: ao implementar uma função Claude, a chamada deve passar pelo SDK oficial dessa linguagem. Não serve para quem só quer inventar pseudocódigo sem SDK indicado, ou tratar o caminho da página como comando de instalação.

O modelo padrão está escrito Claude Opus 5; a cadeia exata é claude-opus-5. Pedidos um pouco complexos usam por padrão adaptive thinking. O guia não dá comando de instalação. Se o assistente atual ainda não consegue mudar código segundo esta referência, o guia existente para aqui; não extraia um diretório de skill do endereço.

Primeira tentativa em 3 minutos

O primeiro caminho oficial é verificar ou mudar uma chamada segundo a referência, não instalar. A página do guia é

https://raw.githubusercontent.com/anthropics/skills/main/skills/claude-api/SKILL.md

Siga só as restrições dessa página. Não escreva uma frase de instalação que não aparece e não coloque placeholders de segredo no código.

Pré-requisito: o assistente atual já consegue trabalhar como claude-api, você tem um trecho de chamada descartável ou uma função vazia, e esta máquina já tem o SDK oficial da Anthropic dessa linguagem. Não há comando de instalação, então o «lugar» é este código de projeto, não um diretório de skill adivinhado.

Primeira tarefa de baixo risco: primeiro uma verificação somente leitura. Peça para ver se a chamada existente passa pelo SDK oficial, se o modelo é claude-opus-5, se thinking é adaptive e se há o budget_tokens abandonado. Não envie primeiro um pedido longo a uma conta real. Sinal de sucesso: o assistente aponta qualquer desvio desses quatro pontos e para para você confirmar antes de mudar o código.

Se precisar mudar, mude só a cadeia do modelo e a forma de thinking: thinking: {type: "adaptive"}. O guia diz que no Claude 4.6+ budget_tokens está abandonado e no Opus 4.6 / Sonnet 4.6 é recusado e devolve 400. Diante de um aviso de escrita, confirme primeiro que nenhum segredo está sendo escrito no repositório.

Casos de uso

Caso 1: acrescentar uma função Claude ao projeto. Se o prompt nomeia Claude/Anthropic, leia primeiro a referência. Implemente pelo SDK oficial da Anthropic da linguagem do projeto, modelo claude-opus-5, pedidos um pouco complexos por padrão com adaptive thinking. Serve quando você já escolheu a linguagem e só falta escrever a chamada certa. As frases existentes só expandem o caminho «SDK oficial» e não nomeiam outros SDKs; não troque por conta própria por um wrapper não nomeado. A página de confronto é

https://raw.githubusercontent.com/anthropics/skills/main/skills/claude-api/SKILL.md

Caso 2: tirar um parâmetro thinking antigo que devolve 400. No Claude 4.6+ use thinking: {type: "adaptive"}; budget_tokens está abandonado no Opus 4.6 / Sonnet 4.6, é recusado e devolve 400. Serve quando você acabou de copiar uma config thinking de um exemplo antigo e o pedido deu 400 na hora. Mude primeiro só este ponto e depois decida se envia um pedido real. O guia não lista todos os campos abandonados, então só dá para confirmar este budget_tokens.

Limites de uso

Sem comando de instalação: não trate o caminho da página como instalador. Limite de gatilho: se um prompt nomeia Claude/Anthropic de qualquer forma, leia primeiro; não pule como uma frase. Limite de chamada: implementar uma função deve passar pelo SDK oficial da Anthropic da linguagem do projeto; as frases existentes não expandem outros caminhos em paralelo. Limite de modelo: padrão Claude Opus 5, cadeia claude-opus-5; pedidos complexos por padrão adaptive thinking. Limite de parâmetro: budget_tokens dá 400 nos modelos 4.6 nomeados. Limite de segredos: não escreva placeholders de segredo nem coloque segredos no código. Esta referência também cobre preços, streaming, ferramentas e temas próximos, mas as frases existentes não dão exemplos passo a passo desses temas.