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-opus-4-20250514",
    "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. 客户端工具:在您的系统上执行的工具,包括:

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

Anthropic 定义的工具使用版本化类型(例如,web_search_20250305text_editor_20250124)以确保跨模型版本的兼容性。

客户端工具

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

1

为 Claude 提供工具和用户提示

  • 在您的 API 请求中定义具有名称、描述和输入模式的客户端工具。
  • 包含可能需要这些工具的用户提示,例如,“旧金山的天气如何?”
2

Claude 决定使用工具

  • Claude 评估是否有任何工具可以帮助处理用户的查询。
  • 如果是,Claude 构造一个格式正确的工具使用请求。
  • 对于客户端工具,API 响应的 stop_reasontool_use,表示 Claude 的意图。
3

执行工具并返回结果

  • 从 Claude 的请求中提取工具名称和输入
  • 在您的系统上执行工具代码
  • 在包含 tool_result 内容块的新 user 消息中返回结果
4

Claude 使用工具结果制定响应

  • Claude 分析工具结果以制定对原始用户提示的最终响应。

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

服务器工具

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

1

为 Claude 提供工具和用户提示

  • 服务器工具,如网络搜索,有自己的参数。
  • 包含可能需要这些工具的用户提示,例如,“搜索有关 AI 的最新新闻。”
2

Claude 执行服务器工具

  • Claude 评估服务器工具是否可以帮助处理用户的查询。
  • 如果是,Claude 执行工具,结果会自动合并到 Claude 的响应中。
3

Claude 使用服务器工具结果制定响应

  • 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.

ModelTool choiceTool use system prompt token count
Claude Opus 4auto, none
any, tool
346 tokens
313 tokens
Claude Sonnet 4auto, none
any, tool
346 tokens
313 tokens
Claude Sonnet 3.7auto, none
any, tool
346 tokens
313 tokens
Claude Sonnet 3.5 (Oct)auto, none
any, tool
346 tokens
313 tokens
Claude Sonnet 3.5 (June)auto, none
any, tool
294 tokens
261 tokens
Claude Haiku 3.5auto, none
any, tool
264 tokens
340 tokens
Claude Opus 3auto, 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.

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

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


下一步

在我们的食谱中探索我们的即用型工具使用代码示例库: