使用 Claude 进行工具使用

Claude 能够与工具和函数交互，让您扩展 Claude 的能力来执行更广泛的任务。

以下是使用 Messages API 向 Claude 提供工具的示例：

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

工具使用的工作原理

Claude 支持两种类型的工具：

1. 客户端工具：在您的系统上执行的工具，包括：

   • 您创建和实现的用户定义自定义工具
   • Anthropic 定义的工具，如计算机使用和文本编辑器，需要客户端实现

2. 服务器工具：在 Anthropic 服务器上执行的工具，如网络搜索和网络获取工具。这些工具必须在 API 请求中指定，但不需要您进行实现。

客户端工具

通过以下步骤将客户端工具与 Claude 集成：

注意：步骤 3 和 4 是可选的。对于某些工作流程，Claude 的工具使用请求（步骤 2）可能就是您所需要的全部，无需将结果发送回 Claude。

服务器工具

服务器工具遵循不同的工作流程：

工具使用示例

以下是一些代码示例，演示各种工具使用模式和技术。为了简洁起见，工具是简单的工具，工具描述比理想情况下要短，以确保最佳性能。

定价

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.

请参阅我们的模型概述表了解当前的每个模型价格。

当您发送工具使用提示时，就像任何其他 API 请求一样，响应将输出输入和输出令牌计数作为报告的 usage 指标的一部分。

下一步

在我们的食谱中探索我们的即用工具使用代码示例存储库：