Loading...
    • Guia do Desenvolvedor
    • Referência da API
    • MCP
    • Recursos
    • Notas de lançamento
    Search...
    ⌘K
    Primeiros passos
    Introdução ao ClaudeInício rápido
    Modelos e preços
    Visão geral dos modelosEscolhendo um modeloNovidades no Claude 4.5Migrando para Claude 4.5Descontinuação de modelosPreços
    Construir com Claude
    Visão geral de recursosUsando a API MessagesJanelas de contextoMelhores práticas de prompting
    Capacidades
    Cache de promptEdição de contextoPensamento estendidoEsforçoStreaming de mensagensProcessamento em loteCitaçõesSuporte multilíngueContagem de tokensEmbeddingsVisãoSuporte a PDFAPI de arquivosResultados de buscaSaídas estruturadasComplemento Google Sheets
    Ferramentas
    Visão geralComo implementar o uso de ferramentasUso eficiente de ferramentas em tokensStreaming de ferramentas granularFerramenta BashFerramenta de execução de códigoChamada de ferramentas programáticaFerramenta de uso de computadorFerramenta de editor de textoFerramenta de busca na webFerramenta de pesquisa na webFerramenta de memóriaFerramenta de busca de ferramentas
    Habilidades do agente
    Visão geralInício rápidoMelhores práticasUsando habilidades com a API
    SDK do agente
    Visão geralSDK TypeScriptSDK PythonGuia de migração
    Guias
    Entrada de streamingTratamento de permissõesGerenciamento de sessãoSaídas estruturadas no SDKHospedando o SDK do agenteModificando prompts do sistemaMCP no SDKFerramentas personalizadasSubagentos no SDKComandos de barra no SDKHabilidades do agente no SDKRastreando custos e usoListas de tarefasPlugins no SDK
    MCP na API
    Conector MCPServidores MCP remotos
    Claude em plataformas de terceiros
    Amazon BedrockMicrosoft FoundryVertex AI
    Engenharia de prompts
    Visão geralGerador de promptsUsar modelos de promptsMelhorador de promptsSeja claro e diretoUse exemplos (prompting multisshot)Deixe Claude pensar (CoT)Use tags XMLDê um papel ao Claude (prompts do sistema)Preencha previamente a resposta do ClaudeEncadeie prompts complexosDicas de contexto longoDicas de pensamento estendido
    Testar e avaliar
    Definir critérios de sucessoDesenvolver casos de testeUsando a ferramenta de avaliaçãoReduzindo latência
    Fortalecer proteções
    Reduzir alucinaçõesAumentar consistência de saídaMitigar ataques de jailbreakRecusas de streamingReduzir vazamento de promptManter Claude em personagem
    Administração e monitoramento
    Visão geral da API de administraçãoAPI de uso e custoAPI de análise do Claude Code
    Console
    Log in
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    Ferramentas

    Uso de ferramentas com Claude

    Claude é capaz de interagir com ferramentas e funções, permitindo que você estenda as capacidades do Claude para realizar uma variedade maior de tarefas.

    Aprenda tudo o que você precisa para dominar o uso de ferramentas com Claude como parte dos nossos novos cursos! Por favor, continue a compartilhar suas ideias e sugestões usando este formulário.

    Aqui está um exemplo de como fornecer ferramentas ao Claude usando a API Messages:

    • Como funciona o uso de ferramentas
    • Ferramentas do cliente
    • Ferramentas do servidor
    • Exemplos de uso de ferramentas
    • Preços
    • Próximos Passos
    curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "tools": [
      {
        "name": "get_weather",
        "description": "Get the current weather in a given location",
        "input_schema": {
          "type": "object",
          "properties": {
            "location": {
              "type": "string",
              "description": "The city and state, e.g. San Francisco, CA"
            }
          },
          "required": ["location"]
        }
      }
    ],
    "messages": [
      {
        "role": "user",
        "content": "What is the weather like in San Francisco?"
      }
    ]
  }'

    Como funciona o uso de ferramentas

    Claude suporta dois tipos de ferramentas:

    1. Ferramentas do cliente: Ferramentas que executam em seus sistemas, que incluem:

      • Ferramentas personalizadas definidas pelo usuário que você cria e implementa
      • Ferramentas definidas pela Anthropic como uso de computador e editor de texto que requerem implementação do cliente

    2. Ferramentas do servidor: Ferramentas que executam nos servidores da Anthropic, como as ferramentas de busca na web e busca na web. Essas ferramentas devem ser especificadas na solicitação da API, mas não requerem implementação da sua parte.

    Ferramentas definidas pela Anthropic usam tipos versionados (por exemplo, web_search_20250305, text_editor_20250124) para garantir compatibilidade entre versões de modelos.

    Ferramentas do cliente

    Integre ferramentas do cliente com Claude nestas etapas:

    1. 1

      Forneça ao Claude ferramentas e um prompt do usuário

      • Defina ferramentas do cliente com nomes, descrições e esquemas de entrada em sua solicitação da API.
      • Inclua um prompt do usuário que possa requerer essas ferramentas, por exemplo, "Como está o tempo em San Francisco?"
    2. 2

      Claude decide usar uma ferramenta

      • Claude avalia se alguma ferramenta pode ajudar com a consulta do usuário.
      • Se sim, Claude constrói uma solicitação de uso de ferramenta formatada adequadamente.
      • Para ferramentas do cliente, a resposta da API tem um stop_reason de tool_use, sinalizando a intenção do Claude.
    3. 3

      Execute a ferramenta e retorne os resultados

      • Extraia o nome da ferramenta e a entrada da solicitação do Claude
      • Execute o código da ferramenta em seu sistema
      • Retorne os resultados em uma nova mensagem user contendo um bloco de conteúdo tool_result
    4. 4

      Claude usa o resultado da ferramenta para formular uma resposta

      • Claude analisa os resultados da ferramenta para elaborar sua resposta final ao prompt original do usuário.

    Nota: As etapas 3 e 4 são opcionais. Para alguns fluxos de trabalho, a solicitação de uso de ferramenta do Claude (etapa 2) pode ser tudo o que você precisa, sem enviar resultados de volta ao Claude.

    Ferramentas do servidor

    Ferramentas do servidor seguem um fluxo de trabalho diferente:

    1. 1

      Forneça ao Claude ferramentas e um prompt do usuário

      • Ferramentas do servidor, como busca na web e busca na web, têm seus próprios parâmetros.
      • Inclua um prompt do usuário que possa requerer essas ferramentas, por exemplo, "Busque as últimas notícias sobre IA" ou "Analise o conteúdo nesta URL."
    2. 2

      Claude executa a ferramenta do servidor

      • Claude avalia se uma ferramenta do servidor pode ajudar com a consulta do usuário.
      • Se sim, Claude executa a ferramenta, e os resultados são automaticamente incorporados na resposta do Claude.
    3. 3

      Claude usa o resultado da ferramenta do servidor para formular uma resposta

      • Claude analisa os resultados da ferramenta do servidor para elaborar sua resposta final ao prompt original do usuário.
      • Nenhuma interação adicional do usuário é necessária para a execução da ferramenta do servidor.

    Exemplos de uso de ferramentas

    Aqui estão alguns exemplos de código demonstrando vários padrões e técnicas de uso de ferramentas. Para brevidade, as ferramentas são ferramentas simples, e as descrições das ferramentas são mais curtas do que seria ideal para garantir o melhor desempenho.

    Preços

    Tool use requests are priced based on:

    1. The total number of input tokens sent to the model (including in the tools parameter)
    2. The number of output tokens generated
    3. For server-side tools, additional usage-based pricing (e.g., web search charges per search performed)

    Client-side tools are priced the same as any other Claude API request, while server-side tools may incur additional charges based on their specific usage.

    The additional tokens from tool use come from:

    • The tools parameter in API requests (tool names, descriptions, and schemas)
    • tool_use content blocks in API requests and responses
    • tool_result content blocks in API requests

    When you use tools, we also automatically include a special system prompt for the model which enables tool use. The number of tool use tokens required for each model are listed below (excluding the additional tokens listed above). Note that the table assumes at least 1 tool is provided. If no tools are provided, then a tool choice of none uses 0 additional system prompt tokens.

    ModelTool choiceTool use system prompt token count
    Claude Opus 4.5auto, none
    any, tool    		346 tokens
    313 tokens
    Claude Opus 4.1auto, none
    any, tool    		346 tokens
    313 tokens
    Claude Opus 4auto, none
    any, tool    		346 tokens
    313 tokens
    Claude Sonnet 4.5auto, none
    any, tool    		346 tokens
    313 tokens
    Claude Sonnet 4auto, none
    any, tool    		346 tokens
    313 tokens
    Claude Sonnet 3.7 (deprecated)auto, none
    any, tool    		346 tokens
    313 tokens
    Claude Haiku 4.5auto, none
    any, tool    		346 tokens
    313 tokens
    Claude Haiku 3.5auto, none
    any, tool    		264 tokens
    340 tokens
    Claude Opus 3 (deprecated)auto, none
    any, tool    		530 tokens
    281 tokens
    Claude Sonnet 3auto, none
    any, tool    		159 tokens
    235 tokens
    Claude Haiku 3auto, none
    any, tool    		264 tokens
    340 tokens

    These token counts are added to your normal input and output tokens to calculate the total cost of a request.

    Consulte nossa tabela de visão geral de modelos para preços atuais por modelo.

    Quando você envia um prompt de uso de ferramenta, assim como qualquer outra solicitação da API, a resposta produzirá contagens de tokens de entrada e saída como parte das métricas de usage relatadas.

    Próximos Passos

    Explore nosso repositório de exemplos de código de uso de ferramentas prontos para implementar em nossos cookbooks:

    Ferramenta Calculadora

    Aprenda como integrar uma ferramenta de calculadora simples com Claude para computações numéricas precisas.
    Agente de Atendimento ao Cliente

    Construa um bot de atendimento ao cliente responsivo que aproveita ferramentas do cliente para melhorar o suporte.

    Extrator JSON

    Veja como Claude e o uso de ferramentas podem extrair dados estruturados de texto não estruturado.