ツールリファレンス

​

権限ルールとフックでツールを設定する

• 設定の permissions.allow と permissions.deny、および /permissions インターフェース内
• CLI フラグの --allowedTools と --disallowedTools
• Agent SDK の allowedTools と disallowedTools オプション内
• スキルの allowed-tools frontmatter 内
• フックの if 条件内

​

Agent ツールの動作

• どちらのフィールドも設定されていない場合: subagent は subagent で利用可能なすべてのツール を継承します。
• tools のみ: subagent はリストされたツールのみを取得します。
• disallowedTools のみ: subagent はリストされたツール以外のすべての親ツールを取得します。
• 両方設定されている場合: disallowedTools が優先されます。両方にリストされているツールは削除されます。

• Foreground subagents は、メイン会話で見られるのと同じ権限プロンプトを表示し、各ツール呼び出しが発生した時点で表示されます。
• Background subagents v2.1.186 以降、メインセッションで権限プロンプトを表示します。プロンプトはどの subagent がリクエストしているかを名前で示し、Esc キーを押すとそのツール呼び出しのみを拒否し、subagent を停止しません。v2.1.186 より前は、background subagent は権限プロンプトが表示されるツール呼び出しを自動的に拒否し、そのツールなしで続行していました。

​

AskUserQuestion ツールの動作

​

質問の自動継続タイムアウト

​

Bash ツールの動作

​

コマンド間で保持されるもの

• Claude がメインセッションで cd を実行すると、新しい作業ディレクトリは、プロジェクトディレクトリ内に留まっている限り、または --add-dir、/add-dir、もしくは設定の additionalDirectories で追加した追加の作業ディレクトリ内に留まっている限り、後続の Bash コマンドに引き継がれます。これには、後続のメッセージに応答して Claude が実行するコマンドが含まれます。
  • サブエージェントセッションは作業ディレクトリの変更を引き継ぎません。
  • cd がこれらのディレクトリの外に出た場合、Claude Code はプロジェクトディレクトリにリセットし、ツール結果に Shell cwd was reset to <dir> を追加します。
  • この引き継ぎを無効にして、すべての Bash コマンドがプロジェクトディレクトリで開始されるようにするには、CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1 を設定します。
• 環境変数は保持されません。1 つのコマンドで export しても、次のコマンドでは利用できません。
• シェルスタートアップファイルで定義されたエイリアスとシェル関数は利用可能です。セッション開始時に、Claude Code は ~/.zshrc、~/.bashrc、または ~/.profile をシェルに応じてソースし、結果のエイリアス、関数、シェルオプションをキャプチャして、すべての Bash コマンドに適用します。

​

タイムアウトと出力制限

• BASH_DEFAULT_TIMEOUT_MS — Claude がタイムアウトを渡さない場合のデフォルト。デフォルトでは 2 分です。
• BASH_MAX_TIMEOUT_MS — デフォルトでは、Claude が要求するものを上限で制限します。有効な上限は 2 つの値の大きい方です。デフォルトでは 10 分です。

​

出力制限

​

バックグラウンドコマンド

• タイムアウトが移動をトリガーする場合、結果は明示的に報告します。Command did not complete within its 120s timeout and was moved to the background。秒はタイムアウトに一致し、その後にタスク ID と出力が書き込まれているファイルのパスが続きます。
• バックグラウンドに移動されるコマンド内の cd、pushd、popd、または chdir は決して引き継がれません。結果は Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands. と述べているため、Claude は発生しなかったディレクトリ変更に対して行動しません。

​

Linux と WSL のメモリ制限

• サイズをバイト数として、または K、M、G、または T サフィックス付きで記述します。0、off、false、no、または none を設定して上限をオフにします。Claude Code は 4e9 などのサイズとして読み取ることができない他の値を無視します。
• Claude Code は、各コマンドごとではなく、1 つの上限に対してセッションのすべての Bash、PowerShell、および Monitor コマンドをカウントします。
• Claude Code はメモリ cgroup で上限を適用します。cgroup をセットアップできない場合、コマンドは上限なしで実行され、claude --debug からのデバッグログは理由を示します。
• Claude Code が開始した最初のプロセスが上限をオンにした後、またはオフ値または cgroup セットアップの失敗のためにオフにした後、Claude Code はその結果を保持します。変更または削除された値、または固定されたセットアップを適用するには、claude を再度起動します。
• コマンドが上限の下に留まることができない場合、カーネルはコマンドを強制終了し、その結果に上限を名前で示すものはありません。

• mcp: ローカルMCP サーバー
• lsp: 言語サーバー
• hooks: フックコマンド
• plugin: プラグインが実行するコマンド
• helper: Claude Code 独自のヘルパーコマンド（git など）
• agent: エージェントチームメイトなどの子 Claude Code プロセス

• 不明な名前: Claude Code は認識しない名前を無視します。
• Bash、PowerShell、および Monitor: Claude Code は、リストするものに関係なく、Bash、PowerShell、および Monitor ツールコマンドを上限の下に保ちます。
• 変数が設定されていない: Claude Code は、Anthropic がサーバーから配信する設定から他のキャップされた種類のセットを取得し、そのセットは時間とともに変わる可能性があるため、変更されないセットが必要な場合は変数を設定します。
• 権限ゲーティングフック: すべての種類がキャップされている場合でも、Claude Code はアクションをブロックまたは変更できるフック、およびそのようなフックが呼び出す MCP サーバーを上限から除外するため、カーネルが権限ゲーティングフックを強制終了してもブロックしていたアクションを許可することはできません。

​

Edit ツールの動作

• Read-before-edit: Claude は編集前に現在の会話でファイルを読み取り、PARTIAL view 通知で短縮された読み取りはカウントされません。Claude Opus 4.6、Claude Haiku 4.5、およびそれ以前のモデルは常に読み取りが必要です。新しいモデルは、読み取りが権限プロンプトを必要としない場合、および Read ツールが利用可能な場合、読み取られていないファイルを編集できます。
• Match: old_string はファイルに記述されたとおりに正確に表示される必要があります。空白またはインデントの 1 文字の違いでも一致を逃す可能性があります。
• Uniqueness: old_string は正確に 1 回だけ表示される必要があります。複数回表示される場合、Claude は 1 つの出現を特定するのに十分な周囲のコンテキストを含む長い文字列を提供するか、replace_all: true を設定してすべてを置換します。

​

EndConversation ツールの動作

• 継続的な不適切な入力に対する最後の手段として、会話をリダイレクトする試みが失敗し、前のメッセージで明確な警告を出した後
• カスタマーが明示的にツールのデモンストレーションを見たいと要求し、セッションを終了したいことを確認した場合

• バージョン: Claude Code v2.1.213 以降。
• モデル: セッションのモデルが Claude Opus 4.8、Claude Sonnet 5、Claude Fable 5、またはこれらのファミリーの後続バージョンです。
• サーフェス: インタラクティブターミナルセッション。IDE の統合ターミナルの claude セッションを含みます。これは JetBrains プラグインがそれを実行する方法です。他のサーフェスはこのツールを含みません。例えば：
  • 非インタラクティブな -p 実行
  • Agent SDK TypeScript および Python パッケージを通じたセッション
  • VS Code 拡張機能パネル。独自の CLI をバンドルしています
  • GitHub Actions
  • Claude Code on the web
• スタートアップモード: --bare セッションではありません。ベアモードはシェルとファイルツールのみをロードするため、このツールはそこに登録されません。
• プロバイダー: Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、または Microsoft Foundry では利用できません。また、クラウドゲートウェイを通じてサインインしたセッションでも利用できません。

​

Glob ツールの動作

• セッションを開始するときに --tools または --allowedTools で Glob または Grep を指定するか、同等の Agent SDK オプションで指定します。--tools を使用すると、リストしたものが取得され、--allowedTools でいずれかのツールを指定すると両方が復元されます。設定ファイルの許可ルールはこの効果を持ちません。
• 権限 拒否ルール、--disallowedTools フラグ、または --restricted がセッションから Bash を削除します。
• サブエージェント が tools フィールドに Glob または Grep をリストし、Bash を除外します。リストされたツールはそのサブエージェントのみ、または --agent またはエージェント設定を通じてメインセッションエージェントとして実行される場合はセッション全体に戻ります。

• **/*.js は任意の深さにあるすべての .js ファイルにマッチします
• src/**/*.ts は src/ 以下のすべての .ts ファイルにマッチします
• *.{json,yaml} は現在のディレクトリ内の .json および .yaml ファイルにマッチします

​

Grep ツールの動作

• files_with_matches: ファイルパスのみで、行の内容はありません。これがデフォルトです。
• content: ファイルと行番号を含む一致する行。ツールの offset パラメータが一致を持つパターンの最後の一致を超えて指す場合、Grep は No entries at this offset を返すため、Claude はパターンが一致しないと結論付けるのではなく、offset を拡大またはリセットします。
• count: ファイルごとの一致数、その後すべての一致するファイル全体の合計。合計はツールの head_limit または offset パラメータがリストされたファイルごとのエントリを切り詰める場合でも、すべての一致をカバーします。v2.1.208 より前では、合計はリストされたエントリのみを合計していました。

​

LSP ツールの動作

• シンボルの定義にジャンプ
• シンボルへのすべての参照を検索
• 位置での型情報を取得
• ファイル内のシンボルをリスト表示
• ワークスペース全体でシンボルを名前で検索
• インターフェースの実装を検索
• コール階層をトレース

​

Monitor ツール

• ログファイルをテールして、エラーが表示されたらフラグを立てる
• PR または CI ジョブをポーリングして、ステータスが変更されたときに報告する
• ディレクトリのファイル変更を監視する
• 指定した長時間実行スクリプトからの出力を追跡する
• WebSocket フィードに接続して、到着した各メッセージを報告する

​

WebSocket ソース

• テキスト メッセージ: メッセージが複数行にまたがる場合でも、各メッセージが 1 つのイベントになります。
• バイナリ メッセージ: 渡されません。Claude は [binary frame, 512 bytes] などのプレースホルダー行を受け取ります。
• 1 MiB より大きいメッセージ: 監視が終了するため、フィルタリングされたフィードが存在する場合はそれにサブスクライブしてください。
• ソケット クローズ: 監視が終了し、Claude はクローズ コードを受け取ります。

​

NotebookEdit ツールの動作

• replace：セルのソースを上書きします。これがデフォルトです。
• insert：ターゲットの後に新しいセルを追加します。cell_id がない場合、新しいセルはノートブックの開始に移動します。cell_type を code または markdown に設定する必要があります。
• delete：ターゲット セルを削除します。

​

PowerShell ツール

• Git Bash がない Windows: ツールは自動的に有効になります。
• Git Bash がインストールされている Windows: ツールは claude.ai と Console アカウントではデフォルトで有効です。Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry セッションで有効にするには CLAUDE_CODE_USE_POWERSHELL_TOOL=1 を設定するか、無効にするには 0 を設定します。
• Linux、macOS、WSL: ツールはオプトインです。

​

PowerShell ツールを有効にする

{
  "env": {
    "CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"
  }
}

​

設定、フック、スキルでのシェル選択

• settings.json の "defaultShell": "powershell": インタラクティブな ! コマンドを PowerShell を経由してルーティングします。PowerShell ツールが有効になっている必要があります。
• 個別のコマンドフックの "shell": "powershell": そのフックを PowerShell で実行します。フックは PowerShell を直接起動するため、CLAUDE_CODE_USE_POWERSHELL_TOOL に関係なく機能します。
• スキルフロントマターの shell: powershell: !`command` ブロックを PowerShell で実行します。PowerShell ツールが有効になっている必要があります。

​

Windows エンコーディングと終了コード

• > と >> でのリダイレクトは PowerShell 5.1 で UTF-8 ファイルを書き込みます
• Claude Code はネイティブコマンドの標準入力にパイプされたテキストを UTF-8 としてエンコードします
• Claude Code は ANSI エスケープシーケンスなしでエラー出力をキャプチャします
• 子プロセスが標準入力で待機するコマンドは、ハングするのではなくファイルの終わりを受け取ります
• where.exe からの終了コード 1 は一致がないことを意味し、fc.exe と diff.exe からはファイルが異なることを意味するため、コマンドが出力を生成する場合、Claude Code はその終了コードをコマンドエラーではなく有効な否定的な回答として扱います。Claude Code は where.exe /Q または $null へのリダイレクトなどのサイレント形式を終了コード 1 での失敗として報告します

​

プレビューの制限事項

• PowerShell プロファイルは読み込まれません
• Windows では、サンドボックス化はサポートされていません

​

Read ツールの動作

• 画像: PNG、JPG、およびその他の画像形式は、生バイトではなく Claude が見ることができるビジュアルコンテンツとして返されます。Claude Code は大きな画像をモデルの画像サイズ制限に合わせるようにリサイズして再圧縮してから送信するため、Claude は大きなスクリーンショットのダウンスケール版を見る可能性があります。v2.1.196 以降、そのリサイズ後も 500KB より大きい画像は、ピクセル寸法を変更せずに品質を低下させた JPEG として再エンコードされます。Claude が大きな画像の細かいピクセルレベルの詳細を見落とした場合、ImageMagick を使用して Bash で領域をトリミングするなど、関心のある領域を最初にトリミングするよう指示してください。
• PDF: Claude は短い .pdf ファイルを全体として読み込みます。10 ページを超える PDF の場合、pages パラメータ（例："1-5"）を使用して範囲で読み込み、一度に最大 20 ページまで読み込みます。ページ範囲の読み込みは poppler-utils の pdftoppm でページをレンダリングするため、macOS では brew install poppler でインストールし、Debian および Ubuntu では apt-get install poppler-utils でインストールしてください。Windows およびその他のプラットフォームでは、pdftoppm を PATH に配置する poppler ビルドをインストールしてください。これがない場合、ページ範囲の読み込みは pdftoppm is not installed というエラーで失敗します。
• Jupyter ノートブック: .ipynb ファイルは、コード、マークダウン、ビジュアライゼーションを含むすべてのセルとその出力を返します。Claude Code は 100 MB を超えるノートブックファイルの読み込みを拒否します。エラーは Claude に、Bash シェルコマンドを使用してセルのスライスなど、ノートブックの一部を読み込む方法を指示します。

​

SendFeedback ツールの動作

• ツールまたはコマンドが失敗し続ける
• 要求されたことに対応できない
• 自分が犯した間違いを指摘するか、それに気付く
• フィードバックを提出するよう要求する

​

Claude がドラフトを作成するときに表示される内容

​

ドラフトを確認して編集する

• タイトル、領域、詳細を編集する
• トランスクリプトを送信 を yes または no に設定します。Claude がドラフトをキューに入れたセッションからのトランスクリプトがまだ利用可能な場合、yes で開始され、その会話を Anthropic に送信します。no はレポートのみを送信します
• ドラフトを送信するか、破棄するか、後で使用するためにキューに残す

​

ドラフトを送信する

• タイトル、領域、詳細
• Claude Code バージョン、オペレーティングシステム、モデルなどの環境情報
• 最近の API リクエストの ID
• 確認画面で トランスクリプトを送信 を yes のままにした場合の会話トランスクリプト。カードから送信する場合、トランスクリプトは含まれません

​

ドラフトを破棄または保持する

​

Claude が作成したフィードバックをオフにする

​

Claude が作成したフィードバックなしのセッション

• キューを確認する画面がない非インタラクティブ -p 実行と Agent SDK セッション
• マシン上のキューに書き込むことができない Claude Code on the web などのクラウドセッション
• Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、または Microsoft Foundry 上のセッション
• CLAUDE_CODE_SEND_FEEDBACK=0 または DISABLE_FEEDBACK_COMMAND=1 を設定したセッション、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC を空でない値に設定したセッション、または 機能フラグ取得 をオフにしたセッション
• 製品フィードバックをオフにした組織、および ゼロデータ保持を使用する組織

​

Task ツールの利用可能性

• Claude Code を開始する前に CLAUDE_CODE_ENABLE_TODO_TOOLS=1 をエクスポートします。例えば CLAUDE_CODE_ENABLE_TODO_TOOLS=1 claude。Claude Code はすべてのモデルとすべてのプロバイダーで同じツールを提供します
• --allowedTools で、例えば claude --allowedTools TaskCreate のようにツールの 1 つを指定します
• --tools でツールをリストします。これはセッションの組み込みツールを指定されたものに制限します。使用する他の組み込みツールと一緒に必要なツールを含めます
• Agent SDK では、allowedTools と tools オプション は 2 つのフラグと同じように機能します

​

WebFetch ツールの動作

• WebFetch は localhost およびドットのない他のホスト名（ベアなイントラネット名など）をリクエストを行う前に拒否します。返されるエラー は Claude に Bash 経由で curl を使用してローカルサーバーに到達するよう指示します。
• HTTP URL は自動的に HTTPS にアップグレードされます。
• 大きなページは処理前に固定文字数制限に切り詰められます。
• WebFetch はデフォルトで各レスポンスを 15 分間キャッシュするため、同じ URL の繰り返しフェッチは迅速に返されます。Claude Code v2.1.233 以降では、CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS を設定して、WebFetch が各レスポンスを保持する期間を変更できます。
• ページが 5 分以内（WebFetch が従うリダイレクトを含む）にダウンロードを完了しない場合、デッドラインエラーで失敗します。Claude Code v2.1.268 以降では、CLAUDE_CODE_WEBFETCH_DEADLINE_MS を設定して制限を変更するか、0 に設定して削除できます。
• URL が別のホストにリダイレクトされる場合、WebFetch はそれに従う代わりに、元の URL とリダイレクト先を名前で示すテキスト結果を返します。その後 Claude は 2 番目の WebFetch 呼び出しで新しい URL をフェッチします。
• 抽出ステップが過負荷の API にヒットした場合、Claude Code はバックオフで再試行します。それでも失敗するフェッチはエラー結果を返します。v2.1.212 より前では、API エラーテキストが抽出されたページコンテンツであるかのように Claude に到達する可能性がありました。

• Yes: このフェッチのみを承認します。次の WebFetch 呼び出しは、同じドメインであってもプロンプトを再度表示します。
• Yes, and don’t ask again for <domain>: フェッチを承認し、そのドメインの WebFetch(domain:...) 許可ルールをそのリポジトリの .claude/settings.local.json に保存します。保存された承認の永続化方法 を参照してください。組織が allowManagedPermissionRulesOnly を設定している場合、Claude Code はこのオプションを非表示にします。
• No, and tell Claude what to do differently: フェッチを拒否します。

​

WebSearch ツールの動作

​

セッション検索制限

​

Write ツールの動作

• Claude Opus 4.6、Claude Haiku 4.5、およびそれ以前のモデルは常に読み込みが必要なため、読み込まれていない既存ファイルへの Write は エラーで失敗します。
• より新しいモデルは、read-before-edit と同じ条件下で、このセッション中に読み込んだことのないファイルを上書きできます。読み込みが権限プロンプトを必要とせず、Read ツールが利用可能な場合です。
• Jupyter ノートブック、および Claude が PARTIAL view 通知 で部分的にのみ読み込んだファイルは、すべてのモデルで読み込みが必要です。

​

利用可能なツールを確認する

What tools do you have access to?

​

関連項目

• MCP servers：外部サーバーを接続してカスタム ツールを追加する
• 権限：権限システム、ルール構文、ツール固有のパターン
• Subagents：subagent のツール アクセスを構成する
• フック：ツール実行の前後にカスタム コマンドを実行する