Tool Choice（ツールチョイス）とは？読み方・Anthropic Claude APIで関数呼び出しを制御するパラメータの仕組み・auto/any/tool/noneの違い・実装例を完全解説

Q: tool_choiceを指定しないとどうなりますか？

デフォルトで{"type": "auto"}が適用されます。Claudeが応答中にツール呼び出しが必要かを自動判定します。

Q: anyとtoolはどう使い分けますか？

anyは複数ツールのうちどれかを必ず呼ばせたい場面、toolは特定のツールに固定したい場面で使います。

Q: OpenAIのrequiredと同じですか？

概念は近いです。OpenAIのrequiredはAnthropicのanyに対応しますが、API構造は異なります。

Tool Choice（ツールチョイス）とは、AnthropicのClaude Messages APIでツール（関数）呼び出しの挙動を制御するパラメータのこと。Claudeが必要に応じて自由にツールを選ぶ「auto」モードがデフォルトだが、特定の状況では「必ずツールを呼ばせたい」「特定のツールだけ呼ばせたい」「絶対にツールを呼ばせたくない」といった要求が発生する。Tool Choiceパラメータはこれらの挙動を明示的に指定するための仕組みである。

このパラメータは、Tool Use（ツール使用、関数呼び出し）機能と一体で動作する。たとえば構造化出力を強制したい場合や、検索を必須化したいエージェント、テスト時にツール使用を完全に切りたい場面で重宝する。実務では、エージェントの信頼性を高める決め手となる重要な設定です。読者の皆さんが本番運用で安定した挙動を得るには、この4モードの違いを正しく理解することが不可欠です。

Tool Choiceの読み方

ツールチョイス

ツール選択

Tool Choiceの仕組み

Tool ChoiceはMessages API呼び出しのtool_choiceフィールドで指定する。指定可能な値は4種類あり、それぞれClaudeの判断ロジックを上書きする形で動く。指定しない場合は{"type": "auto"}がデフォルトとして使われる。重要なポイントは、Tool Choiceは「Claudeが何を出力できるか」をAPI側で制限する仕組みだという点です。

Tool Choiceの4モード

auto
Claudeが判断（既定）

any
必ずどれかのツールを呼ぶ

tool
指定したツールを必ず呼ぶ

none
ツールを呼ばない

各モードの内部動作

autoはClaudeが応答中にツールを呼ぶかどうかを自分で判断する。anyは必ずいずれかのツールを呼ぶよう強制し、引数生成だけで終わる。toolは特定のツール名を指定して、そのツールしか呼ばせない。noneはツール定義を無視させ、テキストのみの応答を返す。実務では、auto以外を使うのはユースケースが明確なときに限ります。

並列ツール呼び出しの制御

Tool Choiceには関連オプションとしてdisable_parallel_tool_useフラグがある。これをtrueに設定すると、Claudeが1ターンで複数のツールを並列呼び出しする挙動を抑止できる。逐次的な処理が必要な場合や、ツール側に競合状態の懸念がある場合に重要です。

Tool Choiceの使い方・実例

基本的な使い方（Quick Start）

from anthropic import Anthropic

client = Anthropic()
response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    tools=[{
        "name": "get_weather",
        "description": "Get current weather",
        "input_schema": {
            "type": "object",
            "properties": {"location": {"type": "string"}},
            "required": ["location"]
        }
    }],
    tool_choice={"type": "tool", "name": "get_weather"},
    messages=[{"role": "user", "content": "東京の天気は？"}]
)
print(response.content)

よくある実装パターン

パターンA: 構造化出力を強制する（type: “tool”）

tools=[{
    "name": "extract_invoice",
    "description": "請求書情報を抽出",
    "input_schema": {
        "type": "object",
        "properties": {
            "amount": {"type": "number"},
            "due_date": {"type": "string"},
            "vendor": {"type": "string"}
        },
        "required": ["amount", "due_date", "vendor"]
    }
}],
tool_choice={"type": "tool", "name": "extract_invoice"}

向いているケース: JSON形式の構造化データを必ず取得したい場面。プロンプトで「JSONで返して」と頼むより信頼性が高い。

避けるべきケース: 自由形式のテキスト応答が必要な対話型UI。強制すると会話が不自然になる。

パターンB: 安全のためツールを完全停止する（type: “none”）

tool_choice={"type": "none"}

向いているケース: 要約タスクなどテキスト応答だけが欲しい場面。デバッグ時にツールの影響を切り分けたいときも有効。

避けるべきケース: ツールが必須のエージェントワークフロー全体に適用すると、機能が完全に止まる。

アンチパターン: anyを多用する

# NG: 何のツールが呼ばれてもよいから呼べと言うのは、設計が甘い
tool_choice={"type": "any"}

anyは「複数ツールがあって、どれを呼ぶかはClaudeに任せたいが、必ず呼ばせたい」という限定的な場面でだけ使う。それ以外ではautoかtoolを選ぶべきです。実務ではanyを乱用すると、どのツールが呼ばれるか予測しづらくなり、デバッグコストが上がる。

Tool Choiceのメリット・デメリット

メリット

挙動の予測可能性: 必ず関数を呼ぶことが保証されるため、後続処理の前提が安定する。
構造化出力の信頼性向上: プロンプトでJSONを頼むより遥かに堅牢。
デバッグ容易性: noneでツールの影響を切り分けられる。
セキュリティ強化: 危険なツールの呼び出しを防ぐホワイトリストとして機能する。

デメリット

会話の自然さが損なわれる: 強制呼び出しは応答テキストを抑制するため、UIによってはぎこちなくなる。
柔軟性の低下: Claudeの判断より固定挙動が優先されるため、想定外の質問に弱くなる。
失敗時のリトライ設計が必要: 強制したツールが失敗した場合の処理を呼び出し側で書く必要がある。

Tool ChoiceとOpenAI tool_choiceの違い

OpenAIにも同名のtool_choiceパラメータが存在し、混同されやすい。下記の比較表で違いを整理する。

観点	Anthropic tool_choice	OpenAI tool_choice
指定方法	{“type”: “auto/any/tool/none”}形式	“auto”/”required”/”none”の文字列、または{“type”:”function”,”function”:{“name”:…}}
必ずツールを呼ぶ指定	“any”	“required”
特定ツールの強制	{“type”:”tool”,”name”:”xxx”}	{“type”:”function”,”function”:{“name”:”xxx”}}
並列呼び出し制御	disable_parallel_tool_use	parallel_tool_calls
テキスト応答の併存	tool強制時はテキストが省略されやすい	同様