使用 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 的格式：

然後將這些轉換後的工具傳遞給 Claude：

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

後續步驟

在我們的食譜中探索我們現成可實施的工具使用程式碼範例存儲庫：