ツール使用とは?
既存のワークフローは、プロジェクト管理ソフトウェア、データベース、ファイルなど、さまざまな技術に依存しています。Claudeはこれらのものを自分自身で確認することはできません。代わりにツールに依存しており、ツールはClaudeに外部のデータやアクションへのアクセスを与えます。
ツールとは何か
簡単に言うと、ツールとはあなたが定義し、Claudeに公開する関数です。そのツールが何をするものか、どのような入力を受け取るかを記述し、Claudeはいつそれを呼び出すかを判断します。
ここで押さえておくべき重要なポイントは、Claudeはツールを実行しない——実行するのはあなたのコードですということです。流れは次のようになります。
- Claudeがリクエストをして、ツール呼び出しを要求する。
- あなたのコードがその関数を実行する。
- 結果がClaudeに戻され、処理が続行される。
ツールの定義方法
ツールはJSONスキーマであり、名前(name)、説明(description)、入力スキーマ(input schema)の3つの要素で構成されます。これらはリクエストボディ内でtools配列としてClaudeに渡します。
description(説明)は、Claudeがそのツールを呼び出すかどうかを判断するために読む部分です。曖昧な説明を書くと、ツール使用の質が悪くなります。これはエージェントが誤作動したり、利用可能なツールをうまく使えなかったりする最大の原因です。具体的に書きましょう。
ツール定義は次のようになります。
{
"name": "lookup_building_code",
"description": "Look up a specific building code section by its identifier. Returns the full text of that code section.",
"input_schema": {
"type": "object",
"properties": {
"section": {
"type": "string",
"description": "The building code section to look up"
}
},
"required": ["section"]
}
}では、これを使うとどうなるでしょうか。例えば、エージェントにコンプライアンスレポートを送るとします。最初のターンで、Claudeはstop_reason: "tool_use"を返してきます——これが私たちへの合図です。そのレスポンスは次のようになります。

私たちのループは、Claudeが要求したパラメータでlookup_building_codeを呼び出し、その結果をtool result(ツール結果)として——そのツール呼び出しのidに紐づいたtool_resultブロックを含むユーザーメッセージとして——Claudeに返します。

そしてClaudeは処理を続けます。この時点で、Claudeが必要とするものが揃うまで、ツールの呼び出しと結果の返却を繰り返すことができます。
複数のツール: Claudeに選ばせる
1つのツールだけでも役立ちますが、興味深いのは、Claudeに複数のツールを与え、どれをどの順番で使うかを選ばせることです。
こんな場面を想像してください。デンバーへの3日間の旅行の荷造りをしていて、今日の天気と今後数日の予報の両方が知りたいとします。そこで、1つではなく2つのツールを宣言します。
const tools = [
{
name: "get_weather",
description: "Get today's current weather for a city.",
input_schema: {
type: "object",
properties: {
city: { type: "string", description: "The city to check" }
},
required: ["city"]
}
},
{
name: "get_forecast",
description: "Get the weather forecast for the next few days for a city.",
input_schema: {
type: "object",
properties: {
city: { type: "string", description: "The city to check" }
},
required: ["city"]
}
}
];このループは、すでに見てきたエージェントループとまったく同じです。新しい要素は、switch文でツール名によって処理を振り分けるrunTool関数だけです——このコードブロックが、実際にあなたのコードが実行される場所です。また、実行できるように2つのハードコードされた検索結果と冒頭のメッセージも追加されており、「Your first API call」のclientを使用しています。
// ハードコードされた2つのルックアップです。実際のアプリでは天気サービスを呼び出します。
const getWeather = (city) => `${city} today: 34F, snow flurries`;
const getForecast = (city) => `${city}, next three days: 38F, 45F, and 52F, sunny`;
const messages = [
{
role: "user",
content:
"I'm packing for a three-day trip to Denver. What's the weather today and over the next few days?",
},
];
function runTool(name, input) {
switch (name) {
case "get_weather":
return getWeather(input.city);
case "get_forecast":
return getForecast(input.city);
}
}
while (true) {
const response = await client.messages.create({
model: "claude-sonnet-5",
max_tokens: 1024,
messages,
tools,
});
if (response.stop_reason !== "tool_use") {
// Claudeの処理が完了 — これが最終的な回答です
for (const block of response.content) {
if (block.type === "text") console.log(block.text);
}
break;
}
messages.push({ role: "assistant", content: response.content });
const toolResults = response.content
.filter((block) => block.type === "tool_use")
.map((block) => ({
type: "tool_result",
tool_use_id: block.id,
content: runTool(block.name, block.input),
}));
messages.push({ role: "user", content: toolResults });
}そして、これがパターンのすべてです。3つ目のツールが欲しいですか?配列に追加し、switchにcaseを追加すれば完了です。
これを実行すると、Claudeがget_weatherを呼び出し、次にget_forecastを呼び出すのがわかります——同じターンで両方呼ばれることもあれば、1つずつ呼ばれることもあります。そして、Claudeは「重ね着をしてください、今日は雪がちらつく見込みで、週の後半は暖かくなります」と答えます。
ここで注目してほしいのは、Claudeがどのように選んだかです。説明文を読み取り、あなたのプロンプトを「今日の天気」と「今後数日」にマッピングし、それぞれに適したツールを選びました。だからこそ、ツールの説明が本当に重要なのです。
ツールランナー: 定型コードを省略する
これまでに書いたコードには、すでに2つの危険信号に気づいたかもしれません。
- 2つの単純な検索のために、大量のコードが必要になっている。
- 実際のコードベースでは、手持ちの関数のたびにJSONスキーマを手書きしたくはありません。コードを2度書いているようなものです。
そこで登場するのがツールランナーです。これはTypeScript、Python、Ruby、C#、Go、Java、PHPのClaude SDKにベータ版として提供されています。各ツールを一度定義すれば、ランナーがツール使用/ツール結果のループ全体を内部で処理してくれます。
TypeScriptでは、ランナーが推奨するヘルパーであるbetaZodTool()が、Zod(データの形を宣言・検証するためのTypeScriptライブラリ)で書かれた短いスキーマで各ツールを記述します。このヘルパーにはZod 3.25.0以降が必要で、新規インストールであればそれが手に入ります。
npm install zodコードは「ツールを記述し、プロンプトを送信し、結果を待つ」だけに縮小されます。ツールランナーを通して組み立てた、同じ2ツールの天気デモを見てみましょう。
import { betaZodTool } from "@anthropic-ai/sdk/helpers/beta/zod";
import { z } from "zod";
// 手動で実行したのと同じ2つのルックアップを、それぞれ短いZodスキーマでラップする
const weatherTool = betaZodTool({
name: "get_weather",
description: "Get today's current weather for a city.",
inputSchema: z.object({
city: z.string().describe("The city to check"),
}),
run: async ({ city }) => getWeather(city),
});
const forecastTool = betaZodTool({
name: "get_forecast",
description: "Get the weather forecast for the next few days for a city.",
inputSchema: z.object({
city: z.string().describe("The city to check"),
}),
run: async ({ city }) => getForecast(city),
});
const runner = client.beta.messages.toolRunner({
model: "claude-sonnet-5",
max_tokens: 1024,
messages: [
{
role: "user",
content:
"I'm packing for a three-day trip to Denver. What's the weather today and over the next few days?",
},
],
tools: [weatherTool, forecastTool],
});
// ツールのやり取りがすべて落ち着いた後、runnerをawaitして最終メッセージを取得する
const finalMessage = await runner;
for (const block of finalMessage.content) {
if (block.type === "text") console.log(block.text);
}同じシナリオですが、コードはごくわずかです。
- while文もなく、stop reasonによるswitchもなく、ツール結果を手動でメッセージに追加することもありません——ランナーがそのすべてを処理します。
- 手書きのJSONスキーマもなく、ツールごとに短いZodスキーマがあるだけで、それがClaudeから送られてくる入力の検証も行います。
- 各
run関数は、先ほど手動で実行したのと同じ検索処理をラップしています。 - ランナーをawaitすると、すべてが完了した時点で最終的なアシスタントメッセージが返されます。
実行すると、同じ答えが得られます。
実際のツールは既存のコードをラップする
実際には、あなたのツールはハードコードされた天気データではないはずです。それらはすでにアプリケーション内に存在する実際の関数をラップすることになります。
コンプライアンスレビューエージェントを例にとると、そのツールは、すでにコードベースに存在するlookup_building_code関数とsearch_building_code関数の薄いラッパーです。ツールランナーを使うと、それぞれの関数を、各自のZodスキーマを持つ短いツール定義でラップし、エージェントは書くすべての所見で具体的な建築基準の条項を引用します。

まとめ
- ツールはClaudeにあなたのシステムへのアクセスを与えます。 ツールとは、あなたが定義し公開する関数であり、Claudeはいつそれを呼び出すかを判断し、あなたのコードがそれを実行します。
- ツールは名前、説明、入力スキーマを持つJSONスキーマであり、リクエスト内で
tools配列として渡されます。 - 具体的な説明を書きましょう。 曖昧な説明は、エージェントが誤作動する最大の原因です。
stop_reason: "tool_use"は、ツールを実行し、結果をツール結果として返すための合図です。- 複数のツールがある場合は、ツール名で処理を振り分けます。ツールを追加するということは、配列への追加とcaseの追加を意味します。
- SDKのツールランナー(Claude SDK群でベータ版として利用可能)がループ全体を処理し、TypeScriptでは各ツールがZodスキーマを持つ短い定義になります。あるいは、ループ自体を自分で実行することもできます。
- あなたが実行するか、ループを委任するかのどちらかです。その委任の最も先にあるのが、managed agentsで、エージェント全体をAnthropicに委任します。