Uso de herramientas con Claude

Claude es capaz de interactuar con herramientas y funciones, permitiéndote extender las capacidades de Claude para realizar una variedad más amplia de tareas.

Aquí hay un ejemplo de cómo proporcionar herramientas a Claude usando la API de Mensajes:

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?"
      }
    ]
  }'

Cómo funciona el uso de herramientas

Claude admite dos tipos de herramientas:

1. Herramientas de cliente: Herramientas que se ejecutan en tus sistemas, que incluyen:

   • Herramientas personalizadas definidas por el usuario que creas e implementas
   • Herramientas definidas por Anthropic como uso de computadora y editor de texto que requieren implementación en el cliente

2. Herramientas de servidor: Herramientas que se ejecutan en los servidores de Anthropic, como las herramientas de búsqueda web y obtención web. Estas herramientas deben especificarse en la solicitud de API pero no requieren implementación de tu parte.

Herramientas de cliente

Integra herramientas de cliente con Claude en estos pasos:

Nota: Los pasos 3 y 4 son opcionales. Para algunos flujos de trabajo, la solicitud de uso de herramienta de Claude (paso 2) podría ser todo lo que necesites, sin enviar resultados de vuelta a Claude.

Herramientas de servidor

Las herramientas de servidor siguen un flujo de trabajo diferente:

Uso de herramientas MCP con Claude

Si estás construyendo una aplicación que utiliza el Protocolo de Contexto de Modelo (MCP), puedes usar herramientas de servidores MCP directamente con la API de Mensajes de Claude. Las definiciones de herramientas MCP utilizan un formato de esquema que es similar al formato de herramientas de Claude. Solo necesitas renombrar inputSchema a input_schema.

Conversión de herramientas MCP al formato de Claude

Cuando construyes un cliente MCP y llamas a list_tools() en un servidor MCP, recibirás definiciones de herramientas con un campo inputSchema. Para usar estas herramientas con Claude, conviértelas al formato de Claude:

Luego pasa estas herramientas convertidas a Claude:

Cuando Claude responde con un bloque tool_use, ejecuta la herramienta en tu servidor MCP usando call_tool() y devuelve el resultado a Claude en un bloque tool_result.

Para una guía completa sobre cómo construir clientes MCP, consulta Construir un cliente MCP.

Ejemplos de uso de herramientas

Aquí hay algunos ejemplos de código que demuestran varios patrones y técnicas de uso de herramientas. Por brevedad, las herramientas son simples y las descripciones de herramientas son más cortas de lo ideal para garantizar el mejor rendimiento.

Precios

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.

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

Consulte nuestra tabla de descripción general de modelos para los precios actuales por modelo.

Cuando envía un mensaje con uso de herramientas, al igual que cualquier otra solicitud de API, la respuesta mostrará tanto los recuentos de tokens de entrada como de salida como parte de las métricas de usage reportadas.

Próximos Pasos

Explore nuestro repositorio de ejemplos de código de uso de herramientas listos para implementar en nuestros libros de recetas: