使用 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。

服务器工具

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

使用 MCP 工具与 Claude

如果您正在构建使用模型上下文协议 (MCP) 的应用程序，您可以直接将 MCP 服务器中的工具与 Claude 的 Messages API 一起使用。MCP 工具定义使用的模式格式与 Claude 的工具格式相似。您只需将 inputSchema 重命名为 input_schema。

将 MCP 工具转换为 Claude 格式

当您构建 MCP 客户端并在 MCP 服务器上调用 list_tools() 时，您将收到具有 inputSchema 字段的工具定义。要将这些工具与 Claude 一起使用，请将它们转换为 Claude 的格式：

from mcp import ClientSession

async def get_claude_tools(mcp_session: ClientSession):
    """Convert MCP tools to Claude's tool format."""
    mcp_tools = await mcp_session.list_tools()

    claude_tools = []
    for tool in mcp_tools.tools:
        claude_tools.append({
            "name": tool.name,
            "description": tool.description or "",
            "input_schema": tool.inputSchema  # Rename inputSchema to input_schema
        })

    return claude_tools

然后将这些转换后的工具传递给 Claude：

import anthropic

client = anthropic.Anthropic()
claude_tools = await get_claude_tools(mcp_session)

response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    tools=claude_tools,
    messages=[{"role": "user", "content": "What tools do you have available?"}]
)

当 Claude 响应 tool_use 块时，使用 call_tool() 在您的 MCP 服务器上执行该工具，并在 tool_result 块中将结果返回给 Claude。

有关构建 MCP 客户端的完整指南，请参阅构建 MCP 客户端。

工具使用示例

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

定价

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 指标的一部分。

后续步骤

在我们的食谱中探索现成可用的工具使用代码示例库：