ツール定義

モデルは未通知のツールを呼び出せないため、使用可能なすべてのツールはリクエスト内で記述されます。Claude API では tools パラメータのエントリとして、name、平易な description、JSON Schema で記述された input_schema が含まれます。モデルはリクエストとツールの説明から呼び出すタイミングを判断します。

これらはすべて入力として課金されます。Anthropic の価格設定ではツール名・説明・スキーマは入力トークンとしてカウントされ、ツールが存在すると API は数百トークンのツール使用システムプロンプトを追加します（Claude Opus 5.5 では 286 トークン、2026年9月時点）。Anthropic が定義したツールは独自の定義を持ち、以降の呼び出しと結果は別途課金されます。

エージェントでは、組み込みツール、MCP サーバー、プラグインが定義を提供します。未使用ツールがコンテキストを占めるかはクライアントによって異なり、詳細なスキーマを最初から含めるものも、後で読み込むものもあります。2026 年 9 月時点で、Claude Code は MCP 定義をデフォルトで遅延し、Codex もツール検索で検出可能な MCP ツールを遅延できます。

定義はプロンプトキャッシュの最前部に位置します。Anthropic はツール、システムプロンプト、メッセージの順にプレフィックスをキャッシュするため、リクエスト間でツールを追加・削除・編集するとそれ以降のキャッシュが無効化され、次のリクエストは全コンテキストを再処理し課金されます。