claude-api

Overview

O que o claude-api ajuda você a fazer

A skill claude-api é uma referência prática para criar aplicações com LLMs usando Claude por meio da Claude API, dos SDKs oficiais da Anthropic e, quando disponíveis, dos materiais do Agent SDK. Ela é organizada por linguagem para que desenvolvedores possam ir rapidamente da configuração inicial para requisições funcionais, respostas em streaming, tool use e padrões de integração de backend.

Esta skill é especialmente útil quando você já sabe que quer trabalhar com Claude e precisa de orientação de implementação, e não de uma visão geral sobre IA. O repositório inclui documentação específica por linguagem para C#, Go, Java, PHP, Ruby, Python e TypeScript, além de exemplos HTTP brutos em curl/.

Para quem esta skill é indicada

claude-api é uma ótima opção para:

• Desenvolvedores backend integrando Claude a serviços, workers e ferramentas internas
• Desenvolvedores de API decidindo entre chamadas HTTP diretas e SDKs oficiais
• Equipes comparando o suporte entre linguagens antes de padronizar em Python, TypeScript, Go, Java, PHP, Ruby ou C#
• Desenvolvedores que precisam de exemplos de streaming, tool use, batching, uso da files API e tratamento de erros
• Builders de agentes usando os materiais do Agent SDK em Python ou TypeScript

Quais problemas ela resolve

Em vez de obrigar você a juntar exemplos espalhados, claude-api oferece um ponto de partida estruturado para decisões comuns de implementação:

• Qual SDK ou superfície de API usar
• Qual pasta de linguagem ler primeiro
• Como autenticar com ANTHROPIC_API_KEY
• Como enviar a primeira requisição de mensagem
• Quando preferir streaming para saídas longas
• Onde encontrar referências de tool use, batches, files API, prompt caching, modelos e códigos de erro

A skill também inclui arquivos de referência compartilhados, como shared/error-codes.md, shared/models.md, shared/prompt-caching.md, shared/live-sources.md e shared/tool-use-concepts.md, o que ajuda quando você precisa de orientação sobre o comportamento do backend além de um exemplo mínimo de hello world.

Superfícies de documentação suportadas no repositório

As evidências do repositório mostram estas áreas principais:

• csharp/
• curl/
• go/
• java/
• php/
• python/agent-sdk
• python/claude-api
• ruby/
• typescript/agent-sdk
• typescript/claude-api
• shared/

Isso faz do claude-api mais do que uma simples coleção de snippets para uma única linguagem. O melhor é entendê-lo como uma skill multilíngue de integração backend para o ecossistema da Claude API.

Quando o claude-api é uma boa escolha

Use claude-api quando:

• Sua base de código importa anthropic, @anthropic-ai/sdk ou claude_agent_sdk
• Você quer padrões de uso dos SDKs oficiais da Anthropic
• Você precisa de exemplos práticos para integração server-side com a Claude API
• Você quer orientação de instalação por linguagem antes de implementar
• Você precisa entender recursos como streaming, tool use, batches ou suporte à files API

Quando o claude-api não é a escolha certa

Esta skill não é a melhor opção quando:

• Seu projeto usa o SDK de outro provedor de IA, como openai
• Você precisa de ajuda genérica de programação sem relação com integração com Claude
• Você está procurando padrões de UI para frontend, e não fluxos de API e backend
• Você precisa de uma linguagem não coberta pelo repositório e não quer usar exemplos HTTP brutos de curl/

How to Use

Instale a skill

Adicione claude-api a partir do repositório de skills da Anthropic:

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

Após a instalação, comece por SKILL.md e depois siga para a pasta da linguagem que corresponde à sua base de código.

Escolha primeiro a pasta certa

A forma mais rápida de usar claude-api bem é selecionar o caminho específico da sua linguagem antes de entrar nos detalhes de implementação.

Pontos de partida úteis no repositório incluem:

• SKILL.md
• csharp/claude-api.md
• curl/examples.md
• go/claude-api.md
• java/claude-api.md
• php/claude-api.md
• ruby/claude-api.md
• python/claude-api/README.md
• typescript/claude-api/README.md
• python/agent-sdk/README.md
• typescript/agent-sdk/README.md

Se você está avaliando o suporte de SDK antes de escolher uma stack, compare várias pastas de linguagem lado a lado. O repositório separa claramente o uso direto da Claude API da orientação sobre Agent SDK em Python e TypeScript.

Combine a superfície certa com o seu caso de uso

Com base na estrutura do repositório, claude-api oferece vários caminhos práticos:

• Use curl/examples.md para requisições HTTP brutas ou linguagens não suportadas
• Use pastas de linguagem como go/, java/, php/, ruby/ ou csharp/ para padrões com SDKs oficiais
• Use python/claude-api/ ou typescript/claude-api/ para cobertura mais aprofundada de temas como streaming, tool use, batches e files API
• Use python/agent-sdk/ ou typescript/agent-sdk/ se o seu projeto estiver centrado em fluxos com agentes, e não apenas em chamadas diretas de mensagem

Essa estrutura é útil na hora de decidir pela instalação, porque nem toda linguagem oferece os mesmos recursos de nível mais alto. Por exemplo, o repositório inclui explicitamente documentação do Agent SDK para Python e TypeScript, enquanto as outras linguagens se concentram no uso dos SDKs da Claude API.

Configure a autenticação com segurança

Nos exemplos do repositório, o padrão é usar a variável de ambiente ANTHROPIC_API_KEY em vez de inserir segredos diretamente no código. Isso faz do claude-api uma boa escolha para fluxos de backend com foco em produção e ambientes de CI.

Antes de testar os exemplos, confirme que seu runtime consegue ler ANTHROPIC_API_KEY.

Caminhos típicos de instalação por linguagem

As evidências do repositório incluem estes exemplos de instalação:

• C#: dotnet add package Anthropic
• Go: go get github.com/anthropics/anthropic-sdk-go
• PHP: composer require "anthropic-ai/sdk"
• Ruby: gem install anthropic
• Java: configuração de dependência com com.anthropic:anthropic-java
• HTTP bruto: use curl com https://api.anthropic.com/v1/messages

Se você está decidindo entre SDK e HTTP, comece pelo SDK quando sua linguagem for suportada e passe para os exemplos em curl/ quando precisar de controle mais baixo nível sobre a requisição ou estiver trabalhando em outra linguagem.

Comece com uma requisição básica de mensagem

A maioria dos guias de linguagem em claude-api segue o mesmo fluxo prático:

1. Inicializar um client
2. Ler a chave de API do ambiente
3. Enviar uma requisição de mensagem com um modelo Claude
4. Ler os blocos de texto da resposta

Essa consistência é útil quando equipes trabalham com várias linguagens de backend. Você pode padronizar o padrão de requisição mesmo que a sintaxe do código mude.

Use streaming para respostas longas

O SKILL.md do repositório recomenda explicitamente usar streaming por padrão em requisições que possam envolver entrada longa, saída longa ou max_tokens alto, porque o streaming ajuda a evitar timeouts. Essa orientação é uma das conclusões operacionais mais importantes do claude-api.

Se sua aplicação gera respostas longas, resumos, loops de ferramentas ou raciocínios estendidos, consulte primeiro a documentação de streaming:

• python/claude-api/streaming.md
• typescript/claude-api/streaming.md
• Seções de streaming dentro de arquivos específicos por linguagem, como go/claude-api.md, java/claude-api.md, ruby/claude-api.md e csharp/claude-api.md

Explore recursos avançados de backend

Um dos motivos para instalar claude-api em vez de depender de um único quickstart é a cobertura mais profunda de temas no repositório. Arquivos relevantes incluem:

• python/claude-api/tool-use.md
• typescript/claude-api/tool-use.md
• python/claude-api/batches.md
• typescript/claude-api/batches.md
• python/claude-api/files-api.md
• typescript/claude-api/files-api.md
• shared/tool-use-concepts.md
• shared/prompt-caching.md
• shared/models.md

Esses materiais são especialmente valiosos para fluxos de backend em produção, nos quais você precisa de mais do que um simples exemplo de request-response.

Use as referências compartilhadas para troubleshooting

Se a sua primeira integração falhar, claude-api inclui materiais de apoio que ajudam na depuração e no planejamento:

• shared/error-codes.md para o significado dos erros HTTP, possibilidade de retry e causas comuns
• shared/models.md para referências relacionadas a modelos
• shared/live-sources.md para orientações relacionadas a fontes

A referência de códigos de erro é particularmente útil porque diferencia condições com retry possível, como 429, 500 e 529, de problemas de requisição sem retry, como 400, ou falhas de autenticação, como 401.

Checklist prático de avaliação antes de adotar claude-api

Antes de adotar esta skill em um projeto, pergunte:

• Precisamos de exemplos com SDKs oficiais em uma das linguagens suportadas?
• Esperamos saídas longas e, portanto, precisamos de orientação sobre streaming?
• Precisamos de exemplos de tool use, files API ou processamento em lote?
• Estamos construindo fluxos com agentes em Python ou TypeScript?
• Queremos um caminho alternativo com HTTP bruto usando curl?

Se a resposta para várias dessas perguntas for sim, claude-api provavelmente é uma ótima escolha.

FAQ

O que é o claude-api neste repositório?

claude-api é uma skill em anthropics/skills que ajuda desenvolvedores a criar aplicações com a Claude API, os SDKs da Anthropic e os recursos do Agent SDK. Ela é organizada por linguagem e apoiada por documentos de referência compartilhados.

Como instalo o claude-api?

Use:

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

Depois, abra SKILL.md e a pasta da linguagem que corresponde à sua stack.

Quais linguagens o claude-api cobre?

As evidências do repositório mostram documentação para C#, Go, Java, PHP, Ruby, Python, TypeScript e exemplos HTTP brutos com curl.

O claude-api inclui orientação sobre Agent SDK?

Sim, mas com base na estrutura do repositório, os materiais de Agent SDK estão especificamente em python/agent-sdk/ e typescript/agent-sdk/. Se você precisa de exemplos de fluxos com agentes, essas são as primeiras pastas a inspecionar.

O claude-api ajuda com streaming e tool use?

Sim. O repositório inclui documentação sobre streaming e tool use, especialmente nas pastas da Claude API para Python e TypeScript, e vários guias específicos por linguagem também trazem seções sobre streaming.

O claude-api é só para chamadas diretas de API?

Não. Ele cobre tanto o uso direto da Claude API quanto padrões de integração baseados em SDK. Também inclui exemplos HTTP brutos em curl/examples.md para desenvolvedores que não querem usar um SDK ou estão trabalhando em outra linguagem.

Quando devo usar curl em vez de um SDK?

Use curl quando precisar de exemplos HTTP brutos, quando sua linguagem não estiver coberta por um SDK oficial nesta skill ou quando quiser inspecionar diretamente a estrutura de requisição e resposta antes de adotar uma client library.

O claude-api inclui orientação sobre tratamento de erros?

Sim. shared/error-codes.md documenta os códigos de erro HTTP, causas comuns e quais problemas permitem retry. Isso faz do claude-api uma skill útil para planejamento de integração em produção, e não apenas para a configuração inicial.

O claude-api é uma boa opção para ajuda geral de programação?

Não. A descrição do repositório é focada no uso da Claude API e dos SDKs da Anthropic. Se sua tarefa não tem relação com integração com Claude, esta skill é específica demais.

O que devo ler primeiro depois de instalar o claude-api?

Comece por SKILL.md e depois vá para o arquivo que corresponde à sua linguagem e ao seu caso de uso. Para muitas equipes, a melhor sequência é:

1. SKILL.md
2. Seu guia de linguagem, como go/claude-api.md ou php/claude-api.md
3. Documentos específicos de tema, como streaming.md, tool-use.md, batches.md ou files-api.md
4. Referências compartilhadas, como shared/error-codes.md