使用 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-6",
    "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。

伺服器端工具

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

搭配 Claude 使用 MCP 工具

如果您正在建構使用 Model Context Protocol (MCP) 的應用程式，您可以直接在 Claude 的 Messages API 中使用來自 MCP 伺服器的工具。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-opus-4-6",
    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 指標中輸出輸入和輸出的 token 計數。

後續步驟

在我們的 cookbook 中探索可直接實作的工具使用程式碼範例：