Communitygithub.com

Construindo Aplicações com Claude

Referência para a API Claude / SDK Anthropic — IDs de modelo, preços, parâmetros, streaming, uso de ferramentas, MCP, agentes, cache, contagem de tokens, migração de modelo.

O que é Construindo Aplicações com Claude?

Esta skill fornece um guia abrangente para desenvolvedores que desejam construir aplicações baseadas em modelos de linguagem (LLMs) utilizando o Claude da Anthropic. Ela abrange desde chamadas únicas de API para tarefas simples como classificação e sumarização até sistemas complexos de agentes com loops de ferramentas gerenciados pelo usuário ou totalmente gerenciados pela plataforma Managed Agents. A skill inclui detecção automática de linguagem de programação (Python, TypeScript, Java, Go, Ruby, C#, PHP) e fornece código SDK oficial específico para cada linguagem, evitando shims ou bibliotecas de terceiros. Além disso, alerta sobre mudanças na API (como o novo pensamento adaptativo e tipos de ferramentas de busca web desatualizadas) e exige consulta às fontes oficiais para garantir que o código gerado esteja correto e atualizado. O suporte inclui plataformas como Claude Platform on AWS, Amazon Bedrock, Google Vertex AI e Microsoft Foundry, com tabelas de disponibilidade de recursos específicas.

Funciona com✓Claude Code✓Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/LiChangZheng10086/doyin_ai_video/tree/HEAD/.agents/skills/claude-api

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Construindo Aplicações com Claude faz?

Esta skill ajuda você a construir aplicações com Claude. Escolha a superfície certa com base nas suas necessidades, detecte a linguagem do projeto e, em seguida, leia a documentação específica da linguagem.

Antes de Começar

Examine o arquivo de destino (ou, se não houver arquivo de destino, o prompt e o projeto) em busca de marcadores de provedor não-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 em relação ao provedor. Se encontrar algum, pare e informe ao usuário que esta skill produz código do SDK do Claude/Anthropic; pergunte se ele deseja alterar o arquivo para o Claude ou prefere uma implementação que não seja do Claude. Não edite um arquivo não-Anthropic com chamadas do SDK da Anthropic.

Requisito de Saída

Quando o usuário pedir para adicionar, modificar ou implementar um recurso do Claude, seu código deve chamar o Claude através de uma das seguintes opções:

  1. O SDK oficial da Anthropic para a linguagem do projeto (anthropic, @anthropic-ai/sdk, com.anthropic.*, etc.). Esta é a opção padrão sempre que existir um SDK compatível para o projeto.
  2. HTTP puro (curl, requests, fetch, httpx, etc.) — apenas quando o usuário pedir explicitamente por cURL/REST/HTTP puro, o projeto for um projeto shell/cURL, ou a linguagem não tiver SDK oficial.

Nunca misture os dois — não use requests/fetch em um projeto Python ou TypeScript apenas porque parece mais leve. Nunca recorra a adaptadores compatíveis com 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 — seja dos arquivos {lang}/ nesta skill ou dos repositórios oficiais do SDK ou links de documentação listados em shared/live-sources.md. Se a ligação necessária não estiver explicitamente documentada nos arquivos da skill, faça WebFetch do repositório relevante do SDK a partir de shared/live-sources.md antes de escrever código. Não deduza APIs Ruby/Java/Go/PHP/C# a partir de formas cURL ou do SDK de outra linguagem.

Se o WebFetch ou o acesso ao repositório falhar (restrição de rede, tempo limite, bloqueio de clonagem): não continue tentando — escreva o código a partir dos padrões e tabelas de namespace/package no arquivo {lang}/, execute o compilador ou interpretador e itere com base na saída de erro. Para SDKs com tipagem estática (C#, Java, Go), um loop de compilação e correção com base em erros locais chega ao código funcional mais rápido do que pesquisa de rede bloqueada.

Padrões

A menos que o usuário solicite o contrário:

Para a versão do modelo Claude, use Claude Opus 5, que pode ser acessado através da string exata do modelo claude-opus-5. Por favor, use pensamento adaptativo (thinking: {type: "adaptive"}) para qualquer coisa remotamente complicada. E, finalmente, use streaming para qualquer requisição que possa envolver entrada longa, saída longa ou max_tokens alto — isso evita atingir timeouts de requisição. Use o auxiliar .get_final_message() / .finalMessage() do SDK para obter a resposta completa se não precisar lidar com eventos de stream individuais

⚠️ Derivação de API — Seu Conhecimento de Treinamento Pode Estar Desatualizado

Várias formas comuns da API do Claude mudaram em 2025–2026. Se você se lembrar de um padrão do treinamento, verifique-o nos arquivos {lang}/ desta skill antes de escrever — as linhas abaixo são os pontos de derivação mais frequentes:

ÁreaConhecimento desatualizadoAPI Atual
Pensamento estendidothinking: {type: "enabled", budget_tokens: N}Em modelos Claude 4.6+: thinking: {type: "adaptive"}. budget_tokens está obsoleto no Opus 4.6 / Sonnet 4.6 e rejeitado com 400 no Fable 5 / Sonnet 5 / Opus 5 / 4.8 / 4.7. Modelos anteriores a 4.6 ainda usam budget_tokens.
Tipo de ferramenta de busca web / fetch webweb_search_20250305, web_fetch_20250910web_search_20260209, web_fetch_20260209 (filtragem dinâmica) no Opus 5/4.8/4.7/4.6, Sonnet 5 e Sonnet 4.6. Modelos mais antigos mantêm as variantes básicas; no Vertex AI, apenas a web_search_20250305 básica está disponível (web fetch não está no Vertex) — veja o QR de Server Tools abaixo.
Nomes de parâmetros PHPnomes snake_case como argumentos nomeados (max_tokens)Argumentos nomeados de nível superior são camelCase (maxTokens). As chaves de array aninhadas variam por recurso (ex.: 'taskBudget', 'skillID', 'mcp_server_name') — copie a chave exata do exemplo documentado; não converta em massa.
Credenciais de Agentes GerenciadosManter secrets do lado do servidor via ferramentas personalizadas (a única opção antes do lançamento dos cofres)Credenciais Vault environment_variable — armazenadas pela Anthropic, substituídas na saída, nunca visíveis no sandbox (shared/managed-agents-tools.md → Vaults). Ferramentas personalizadas do lado do servidor continuam sendo a alternativa para sandboxes auto-hospedados.

Os arquivos {lang}/ nesta skill são a referência autoritativa sobre os padrões lembrados.


Subcomandos

Se a Solicitação do Usuário no final deste prompt for uma string de subcomando simples (sem prosa), pesquise todas as tabelas de Subcomandos neste documento — incluindo quaisquer uma em seções anexadas abaixo — e siga a Ação correspondente diretamente. Isso permite que os usuários invoquem fluxos específicos via /claude-api <subcomando>. Se nenhuma tabela no documento corresponder, trate a solicitação como prosa normal.

SubcomandoAção
migrateMigrar código existente da API Claude para um modelo mais novo. Leia shared/model-migration.md imediatamente e siga em ordem: Passo 0 (confirme o escopo — pergunte quais arquivos/diretórios antes de qualquer edição), Passo 1 (classifique cada arquivo), depois a seção de alterações de quebra por destino. Não resuma o guia — execute-o. Se o usuário não nomeou um modelo de destino, pergunte para qual modelo migrar na mesma rodada da pergunta de escopo.

Detecção de Linguagem

Antes de ler exemplos de código, determine em qual linguagem o usuário está trabalhando:

  1. Examine os arquivos do projeto para inferir a linguagem:

    • *.py, requirements.txt, pyproject.toml, setup.py, Pipfile → Python — leia de python/
    • *.ts, *.tsx, package.json, tsconfig.json → TypeScript — leia de typescript/
    • *.js, *.jsx (sem arquivos .ts presentes) → TypeScript — JS usa o mesmo SDK, leia de typescript/
    • *.java, pom.xml, build.gradle → Java — leia de java/
    • *.kt, *.kts, build.gradle.kts → Java — Kotlin usa o SDK Java, leia de java/
    • *.scala, build.sbt → Java — Scala usa o SDK Java, leia de java/
    • *.go, go.mod → Go — leia de go/
    • *.rb, Gemfile → Ruby — leia de ruby/
    • *.cs, *.csproj → C# — leia de csharp/
    • *.php, composer.json → PHP — leia de php/
  2. Se múltiplas linguagens forem detectadas (ex.: arquivos Python e TypeScript):

    • Verifique a qual linguagem o arquivo ou pergunta atual do usuário se refere
    • Se ainda ambíguo, pergunte: "Detectei arquivos Python e TypeScript. Qual linguagem você está usando para a integração com a API Claude?"
  3. Se a linguagem não puder ser inferida (projeto vazio, sem arquivos fonte ou linguagem não suportada):

    • Use AskUserQuestion com opções: Python, TypeScript, Java, Go, Ruby, cURL/HTTP puro, C#, PHP
    • Se AskUserQuestion não estiver disponível, use exemplos Python por padrão e observe: "Mostrando exemplos Python. Avise-me se precisar de uma linguagem diferente."
  4. Se uma linguagem não suportada for detectada (Rust, Swift, C++, Elixir, etc.):

    • Sugira exemplos cURL/HTTP puro de curl/ e observe que SDKs da comunidade podem existir
    • Ofereça-se para mostrar exemplos Python ou TypeScript como implementações de referência
  5. Se o usuário precisar de exemplos cURL/HTTP puro, leia de curl/.

Suporte a Recursos Específicos por Linguagem

Todas as linguagens SDK acima suportam tanto o Tool Runner beta quanto os Agentes Gerenciados (beta) — Python (decorador @beta_tool), TypeScript (betaZodTool + Zod), Java (classes anotadas), Go (BetaToolRunner no pacote toolrunner), Ruby (BaseTool + tool_runner), C# (BetaToolRunner + esquema JSON puro), PHP (BetaRunnableTool + toolRunner()); os pontos de entrada de código estão na referência rápida de Padrões de Uso de Ferramentas abaixo. cURL é HTTP puro (sem recursos SDK) e suporta Agentes Gerenciados.

Exemplos de código de Agentes Gerenciados: veja o guia de leitura na seção ## Agentes Gerenciados (Beta) abaixo.


Qual Superfície Devo Usar?

Comece simples. Use o nível mais simples que atenda às suas necessidades. Chamadas únicas de API e workflows lidam com a maioria dos casos de uso — recorrer a agentes apenas quando a tarefa genuinamente exigir exploração aberta e orientada por modelo. "Mais simples" significa a menor quantidade de código que você possui: para um agente hospedado, agendado ou com memória, Agentes Gerenciados geralmente é a opção mais simples (sem código de loop, sem arquivos de estado, sem agendador), mesmo sendo uma plataforma maior.

Caso de UsoNívelSuperfície RecomendadaPor quê?
Classificação, sumarização, extração, Q&AChamada única de LLMAPI ClaudeUma requisição, uma resposta
Processamento em lote ou embeddingsChamada única de LLMAPI ClaudeEndpoints especializados
Pipelines multi-etapas com lógica controlada por códigoWorkflowAPI Claude + uso de ferramentasVocê orquestra o loop
Agente personalizado com suas próprias ferramentasAgenteAPI Claude + uso de ferramentasMáxima flexibilidade
Agente stateful gerenciado pelo servidor com workspaceAgenteAgentes GerenciadosA Anthropic executa o loop e hospeda o sandbox de execução de ferramentas
Configurações de agente persistidas e versionadasAgenteAgentes GerenciadosAgentes são objetos armazenados; sessões fixam uma versão
Agente multi-turn de longa duração com montagens de arquivoAgenteAgentes GerenciadosContêineres por sessão, fluxo de eventos SSE, Skills + MCP
Agente que executa em um agendamento (cron, "toda noite")AgenteAgentes Gerenciados — implantações agendadasAs implantações disparam sessões autonomamente; sem agendador do lado do cliente

Nota: Agentes Gerenciados é a escolha certa quando você quer que a Anthropic execute o loop do agente e hospede o contêiner onde as ferramentas executam — operações de arquivo, bash, execução de código são executadas no workspace por sessão. Se você quiser hospedar o compute você mesmo ou executar seu próprio runtime de ferramentas personalizadas, API Claude + uso de ferramentas é a escolha certa — use o tool runner para o loop agentic — seus hooks por turno ainda fornecem portões de aprovação, logging, interceptação de erros e execução condicional (veja shared/tool-use-concepts.md) — ou o loop manual quando você quiser possuir todo o loop você mesmo.

Acesso ao provedor de nuvem. Claude Platform on AWS é operado pela Anthropic com paridade de API no mesmo dia — veja shared/claude-platform-on-aws.md para configuração do cliente. Para disponibilidade por recurso em Claude Platform on AWS, Amazon Bedrock, Google Vertex AI e Microsoft Foundry, veja shared/platform-availability.md — essa tabela é a fonte única da verdade nesta skill; não deduza disponibilidade de outro lugar.

Construindo um Agente: Quatro Abordagens

Depois de decidir que você realmente precisa de um agente (uso de ferramentas aberto e orientado por modelo), existem quatro maneiras distintas de construir um. Duas perguntas independentes as separam: quem fornece o harness (o loop do agente + gerenciamento de contexto) e quem fornece a implantação (a infraestrutura na qual o agente é executado). O Tool Runner e o Claude Agent SDK fornecem apenas um harness — você ainda os hospeda e implanta — e é por isso que são fáceis de confundir. Agentes Gerenciados (CMA) é a única opção que fornece ambos o harness e a implantação gerenciada; o loop manual não fornece nenhum.

#AbordagemVocê escreveHarness e implantaçãoFerramentas disponíveisUse quando
1API Claude — loop manualO loop while stop_reason == "tool_use" você mesmoVocê constrói o harness; você hospedaApenas ferramentas que você defineVocê quer possuir o loop inteiro — sem dependência beta, ou um fluxo de controle que os hooks por turno do Tool Runner não atendem
2API Claude — Tool Runner (client.beta.messages.tool_runner + @beta_tool / betaZodTool)Apenas as funções de ferramentaO SDK fornece o loop (apenas harness); você hospedaApenas ferramentas que você defineUm agente de ferramentas personalizadas sem escrever o loop manualmente (a maioria dos casos). Os hooks por turno ainda fornecem portões de aprovação, interceptação de erros, modificação de resultado (ex.: cache_control), repetições, streaming e compactação
3Agentes Gerenciados (REST, beta)Configuração do agente + resultados de suas ferramentasA Anthropic fornece o harness e hospeda um sandbox por sessão (harness + implantação)Sandbox hospedado pela Anthropic (bash, arquivos, execução de código) + Skills/MCP + suas ferramentasVocê quer que a Anthropic execute o loop e hospede o workspace por sessão; configurações persistidas/versionadas; sessões de longa duração
4Claude Agent SDK — produto separado (claude-agent-sdk / @anthropic-ai/claude-agent-sdk)Um prompt + opçõesO SDK fornece o harness do Claude Code + ferramentas integradas (apenas harness); você hospedaFerramentas integradas Read/Write/Edit/Bash/Glob/Grep/WebSearch/WebFetch + MCP + subagentesVocê quer um agente de codificação/sistema de arquivos completo executando em sua própria infraestrutura

A divisão harness/implantação é o modelo mental principal: as opções 1, 2 e 4 deixam a implantação com você; apenas a opção 3 (CMA) adiciona implantação gerenciada. As opções 1–3 são o que esta skill gera; a opção 4 é uma biblioteca diferente com seus próprios documentos — veja a desambiguação abaixo.

Tool Runner ≠ Claude Agent SDK. Eles soam parecidos, mas são pacotes diferentes:

  • Tool Runner faz parte do SDK regular da API Anthropic (anthropic / @anthropic-ai/sdk), acessado via client.beta.messages.tool_runner. Ele automatiza...

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

LiChangZheng10086/doyin_ai_video

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

LiChangZheng10086/doyin_ai_video

Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.

LiChangZheng10086/doyin_ai_video

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

LiChangZheng10086/doyin_ai_video

Grill me about specs for the workflows I want to build, within this workspace.

LiChangZheng10086/doyin_ai_video

Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.

LiChangZheng10086/doyin_ai_video

智能 PPT 生成器。支持 7 种视觉风格(乐高/波普/黏土/黑白/商务/学术/科技),具备根据内容自动推荐风格、生成大纲、绘制配图并组装成片的全自动能力。

LiChangZheng10086/doyin_ai_video

Use this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions \"deck,\" \"slides,\" \"presentation,\" or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.

LiChangZheng10086/doyin_ai_video

Diagnose and fix React codebase health issues. Use when reviewing React code, fixing performance problems, auditing security, or improving code quality.

LiChangZheng10086/doyin_ai_video

Sentry error monitoring and performance tracing patterns for Next.js applications.

LiChangZheng10086/doyin_ai_video

Simplify and refine recently modified code for clarity and consistency. Use after writing code to improve readability without changing functionality.

LiChangZheng10086/doyin_ai_video

✅ "你知道今天所有大模型能读懂你的话,全靠一个叫Transformer的架构吗?"

LiChangZheng10086/doyin_ai_video

Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like \"the xlsx in my downloads\") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.

Habilidades Relacionadas