Code Mode でコードからツール呼び出しを実行する

Code Mode の仕組み

const files = await $`rg -l "function retryPolicy" src`.text();
const target = files.trim().split("\n")[0];
await edit(target, "maxAttempts: 3", "maxAttempts: 5");
({ edited: target, tests: $`npm test -- retryPolicy`.nothrow() });

Code Mode を使う場面

• 多くのファイルにわたって繰り返される変更
• Claude が読む前に結果を絞り込む必要がある検索
• 同時に実行できる複数の独立したコマンド

Code Mode の制限事項

• 再開: Code Mode のセッションは、ターミナルで Code Mode をオンにした状態でのみ再開できます
• auto モード: auto モードの分類器は、各ツール呼び出しではなくコードをレビューします
• 長時間実行されるコード: コードをバックグラウンドで実行できる場合を除き、完了するまで待つ必要があり、コードは 10 分後に停止します
• フック: PreToolUse フックが実行できない場合やタイムアウトした場合にツール呼び出しが拒否されることがあり、UserPromptSubmit フックによってコードの出力がブロックされることがあります
• 利用できない機能: Remote Control、Claude in Chrome、computer use は使用できません
• セッションの移動: セッションを Desktop アプリに移動したり、バックグラウンドセッションに変えたりすることはできず、/fork でバックグラウンドのコピーを開始することもできません

要件

• バージョン: Claude Code v2.1.323 以降（どちらのリリースチャネルでも可）。古いバージョンでは、理由 it isn't open to your account yet の表示の有無にかかわらず、Code Mode なしで起動します
• アカウント: Claude のサブスクリプションまたは Console アカウント。ゲートウェイ、Amazon Bedrock、Claude Platform on AWS、Google Cloud の Agent Platform、Microsoft Foundry を経由して Code Mode を使うことはできません
• 組織: 組織が HIPAA 構成やゼロデータ保持を使用していないこと
• モデル: Claude Opus 5.5、Sonnet 5.5、Haiku 5.5、または Fable 5.2
• サーフェス: ターミナルでの対話型の claude セッション。Code Mode は -p、Agent SDK、VS Code パネル、Desktop アプリ、クラウドセッションでは動作しません
• インストール: Claude Code のネイティブビルド
• Windows: Git for Windows がインストールされていること

Code Mode を試す

CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
claude

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
  }
}

Code Mode (experimental) is on · this session can be resumed only with Code Mode on

Read every Markdown file in this project and list the links that point to local files that don't exist.

Code Mode をオフにする

組織で Code Mode をブロックする

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0"
  }
}

権限と長時間実行されるコード

権限チェック

• auto モード: 分類器は、各ツール呼び出しではなく、実行前の各コードをレビューします。検索出力から取得したパスなど、実行時に計算される値は分類器には見えないため、制御する必要がある呼び出しにはルールやフックを残しておいてください。それでも、以前のコードの実行中に新しいコードが開始されると、プロンプトが表示されることがあります
• その他の権限モード: コードはレビューなしで開始され、そのモードでプロンプトが表示されるツール呼び出しごとにプロンプトが表示されます

長時間実行されるコード

• 待機: Claude はコードの完了後に応答し、コードは 10 分後に停止します（権限プロンプトで費やした時間を含みます）
• バックグラウンド: Claude との会話を続けることができ、コードは最大 2 時間実行できます

• 別のモードに切り替えた場合: 開始時のモードに戻るまで Shift+Tab を押します
• 別のモードで開始した場合、または claude --resume のリストからセッションを選択した場合: auto モードが利用できる場合は、終了してから、Code Mode をオンにした状態で claude --continue --permission-mode auto を実行します
• --tools にツール名を渡した場合: そのフラグなしで auto モードで再度起動します

トラブルシューティング

Code Mode が起動しない

カウントダウン付きの権限プロンプト

Claude Code will automatically block this request in 1:59, to avoid holding up an unattended session

フックによってツール呼び出しが拒否された

• the hook failed: Claude のコードからの呼び出しで、フックが開始できなかった、強制終了された、126、127、または 128 を超えるコードで終了した、あるいは HTTP エラーや無効な出力を返しました。フックを修正してください
• the hook did not finish: Claude のコードからの呼び出し、または Claude がセッション内でコードを実行した後のその他のツール呼び出しで、フックがタイムアウトしました。フックの timeout を引き上げてください

フックによってコードの出力が保留された

関連リソース

• 権限モード: auto モードとプロンプトを表示するモードを比較する
• フックリファレンス: PreToolUse フックと UserPromptSubmit フックを書く
• 管理設定: 1 つの設定を組織全体に適用する