Claudeが書いたコードでツールをまとめて動かす

米Anthropicは11月17日(日本時間18日6時18分)、プログラミング支援の「Claude Code」の新しい実験機能「Code Mode」を、開発者向けのXアカウント@ClaudeDevsで紹介した。Claudeがスクリプトを書いて複数のツールを組み合わせて動かし、時間のかかるコマンドを実行している間も利用者に応答できるという。環境変数 CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 を設定した利用者だけが使える。

Check out Code Mode, a new, experimental way for Claude Code to work with tools. Claude writes scripts that chain your tools together in sophisticated ways, and it can answer you while long commands are still running. Opt in with CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1

訳:Claude Codeがツールを扱う新しい実験的な方法「Code Mode」を見てほしい。Claudeがツールを高度に組み合わせるスクリプトを書き、長いコマンドの実行中も応答できる。CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 で有効にできる。

公式ドキュメントによると、これまでのClaude Codeでは、Claudeがコマンドの実行(Bash)やファイルの読み書き(Read、Edit)などのツールを1回ずつ呼び、結果を読んでから次の手を決めていた。Code Modeでは、Claudeがツールを呼ぶJavaScriptのコードを書き、Claude Codeがそのコードを利用者のセッションの中で実行する。1つのコードで複数のコマンドを並行して動かし、ある結果を次の呼び出しに使い、出力のうちClaudeが読む必要のある部分だけを返せる。

ドキュメントは向いている作業として、多くのファイルにまたがる同じ変更、Claudeが読む前に結果を絞り込む必要がある検索、同時に動かせる独立した複数のコマンドを挙げた。会話の画面には編集の差分などのツールの呼び出しが表示され、コードそのものは記録の画面を開くと読める。

実験的な機能で、標準ではオフ

ドキュメントは、Code Modeを「実験的で、標準ではオフ」とし、どのリリースでも変更や削除がありうると明記した。Claude Codeの公式の更新履歴では、11月12日付の版2.1.323で、Claudeがツールを呼ぶJavaScriptを書く実験的なオプトイン(利用者が自分で有効にする方式)として追加された。その後も13日付の2.1.325、16日付の2.1.326、17日付の2.1.327で、Code Modeに関する修正や変更が続いている。

有効にするには、シェルで環境変数を1にしてClaude Codeを起動するか、利用者の設定ファイル ~/.claude/settings.json の env に同じ変数を書く。プロジェクトの設定ファイルに書いた場合は無視される。ドキュメントは、クローンしたリポジトリが利用者に代わってCode Modeを有効にすることはできないと説明している。初めて使うときには、有効にするかの確認が出る。

Anthropicは、正式に提供する時期や、Code Modeで作業がどれだけ速くなるかといった効果の数字を明らかにしていない。追加の料金がかかるかどうかも、ドキュメントと投稿には書かれていない。

使えるのは対話式のターミナルだけ

ドキュメントが挙げる条件は多い。版はClaude Code v2.1.323以降(2つある配信経路のどちらでもよい)で、アカウントはClaudeのサブスクリプション(定額の契約)かConsoleのアカウントが要る。ゲートウェイ(中継の仕組み)や、Amazon Bedrock、Claude Platform on AWS、Google CloudのAgent Platform、Microsoft Foundry、Claude Models on Google Cloud(Anthropic managed)を通しては使えない。HIPAA(米国の医療情報の規則)向けの設定や、ゼロデータ保持(データを保存しない契約)を使う組織も対象外だ。

対応するモデルはClaude Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.2。使えるのはターミナルで対話しながら動かすClaude Codeだけで、1回きりで動かす -p、開発キットのAgent SDK、VS Codeの画面、デスクトップのアプリ、クラウドのセッションでは使えない。ネイティブ版のClaude Codeが前提で、Windowsでは「Git for Windows」が入っている必要がある。「エージェントチーム」の機能を有効にした状態で使うには、v2.1.326以降が要る。

APIキーを渡す補助の仕組み(API key helper)、OpenTelemetryでの計測データの書き出し、DISABLE_TELEMETRY などの設定がオンだと、Code Modeは起動しない。ドキュメントは、v2.1.323以降でも「アカウントにまだ開放されていない」と表示される場合があるとし、通信の状態を確かめても表示が消えなければ日を改めて試すよう案内している。段階的に開放しているかどうかは、明らかにしていない。

長い処理は10分で止まり、一部の機能は使えない

ドキュメントは、有効にする前に受け入れるべき制約も挙げた。コードの実行を待つ場合、Claudeはコードが終わってから答え、コードは10分で止まる。この10分には、利用者が権限の確認に答える時間も含まれる。実行中のコードを裏で動かし続ければ、利用者はClaudeとやりとりを続けられ、コードは最長2時間動ける。裏で動かすには、セッションを「auto」(自動モード)か「bypassPermissions」の権限モードで始める必要がある。

Code Modeのセッションでは、「Remote Control」「Claude in Chrome」「computer use」の各機能は使えない。セッションをデスクトップのアプリに移したり、裏で動くセッションにしたりすることもできない。

コードの中の呼び出しも権限のルールを通る

Claudeが書いたコードの中のツールの呼び出しも、利用者が決めた禁止や確認のルールと、ツールを使う前に動く「フック」(利用者が設定する自動処理)を、通常と同じ名前で通る。自動モードでは、自動チェックが実行前にコード全体をまとめて審査する。ドキュメントによると、この審査は検索結果から取り出したファイルの場所のような、実行中に決まる値を見ない。そのため、必ず制御したい呼び出しにはルールやフックを残しておくよう求めている。ほかの権限モードでは、コードは審査なしで始まり、そのモードで確認が出る呼び出しのたびに利用者に確認が出る。

ドキュメントは、コマンドの文字列で判定するBashのルールについて、Code Modeの有無にかかわらず、ルールに合わない形で禁止したコマンドを実行されうると注意した。コマンドの文字列によらない制限には、サンドボックス(隔離した実行環境)を使うよう案内している。

再開するときもオンのままで、組織では禁止できる

Code Modeで始めたセッションを --continue や --resume で再開するときは、環境変数を1のままにしておく必要がある。オフの状態では、Claude Codeは再開を断る。Code Modeなしで始めたセッションは、変数を設定していてもCode Modeなしで再開する。

オフにするには、シェルと利用者の設定ファイルから変数を消すか、値を0にして新しいセッションを始める。どちらか一方に0があれば、もう一方に1を書いてもオフのままになる。組織の管理者は、全社に配る管理用の設定(managed settings)で値を0にすれば、組織の利用者がCode Modeを使えないようにできる。使用中の利用者は、終了するか再起動するまでCode Modeのまま動き、その後は以前のCode Modeのセッションを再開できなくなる。管理用の設定から利用者のCode Modeをオンにすることはできない。