Claude Code(AIに日本語で頼んで、パソコンの作業を手伝ってもらう道具)に、11月12日公開の2.1.323から「Code Mode」という実験的な機能が入りました。初期設定ではオフです。

ふだんのClaude Codeは、ファイルを読む、検索する、書き換える、といった道具を1回ずつ呼びます。Code Modeでは、Claudeがその手順をJavaScript(プログラムの言語の一つ)で書き、何回分もの呼び出しを1回でまとめて動かします。この記事では、Claude CodeのCode Modeの入れ方と、試す前に知っておきたい条件を順に見ます。11月19日時点の情報です。

どんな作業で効くのか

公式が挙げている場面は3つです。

  • 同じ書き換えを、何十ものファイルにくり返す
  • 検索した結果をふるいにかけてから、次の作業に渡す
  • 互いに関係のないコマンドを、同時に走らせる

たとえば「プロジェクト中の古い関数名を探して、全部新しい名前に直し、最後にテストを動かす」という頼み方です。関数はプログラムの中の名前の付いた処理のまとまり、テストは作ったものが正しく動くかを自動で確かめる仕組みのことです。プログラム以外なら、「フォルダの中の100個のCSVファイルの列の名前を、全部同じにそろえる」ような作業も同じ形です。これまでは検索、ファイルごとの書き換え、テストと、呼び出しが何十回も並びました。Code Modeでは、Claudeが書いた1本のコードの中でそれが進みます。

画面に出るのは、差分(書き換えた前後の違い)のような道具の結果だけで、コードそのものは出ません。書かれたコードを読みたいときは Ctrl+O で記録の画面を開き、「Code」の行を開きます。

オンにする手順

必要なのは、環境変数(パソコンに覚えさせておく設定の値)を1つ足すことだけです。

  1. claude --version で版を確かめ、2.1.323より古ければ claude update で上げる
  2. ターミナル(文字でパソコンに指示を出す画面)で、次のように起動する
  3. 最初の1回だけ出る確認で「Yes, turn on Code Mode」を選ぶ
CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

毎回打つのが面倒なら、自分のパソコンにあるClaude Codeの設定ファイル(~/.claude/settings.json)に、同じ値を書いておきます。Claude Codeに「Code Modeを常にオンにする設定を足して」と頼めば書いてくれます。プロジェクトの中の設定ファイルに書いても無視される点に注意してください。リポジトリ(チームで共有するファイルの置き場所)経由で、勝手にオンにされないための作りです。

使える条件はかなり狭い

ここが一番つまずきやすいところです。公式ドキュメントに並ぶ条件を、ざっとまとめます。

項目

条件

起動のしかた

ターミナルで対話する claude だけ。-p、VS Codeの拡張機能のパネル、デスクトップアプリ、クラウドは不可

モデル

Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.2

契約

Claudeのサブスクか、Claude Consoleのアカウント。Bedrockなど他社クラウド経由は不可

組織

HIPAA構成や、データを残さない契約(ZDR)の組織は不可

その他

ネイティブ版で入れていること。OpenTelemetryの書き出しなどを設定していると起動しない。Windowsは Git for Windows が必要

表の言葉を補っておきます。-p は1回だけ答えさせて終わる使い方、BedrockはAmazonのクラウド経由でClaudeを使う契約、HIPAAはアメリカの医療データの規制、ネイティブ版は公式のインストーラーで入れた版、OpenTelemetryは動作の記録を外の監視の道具に送る仕組みです。

使えないときは、起動時に「Code Mode (experimental) isn't available」という行が出て、理由も添えられます。/status でも同じ理由が見られます。

私も研修の準備で試そうとして、最初はこの行で止まりました。理由を見ると、VS Codeの拡張機能のパネルで動かしていたからでした。ターミナルから起動し直したら使えました。

許可の確認はどう変わるか

気になるのは、まとめて動くなら危ない操作も素通りするのでは、という点だと思います。公式の説明はこうです。

  • コードの中の道具の呼び出しも、1回ずつ、ふだんの名前(コマンドを実行する道具のBashなど)で、拒否と確認の決まりとフック(決まったタイミングで差し込む自前の処理)を通る
  • オートモード以外では、ふだんなら確認が出る呼び出しのたびに、やはり確認が出る
  • オートモード(安全そうな操作をClaude Codeが判断して進める動き方)では、判断の仕組みが「呼び出しごと」ではなく「コード全体」を先に見る

3つ目には注意書きがあります。実行の途中で決まる値、たとえば検索結果から拾ったファイルの場所は、事前の判断では見えません。どうしても止めたい操作は、拒否の決まりやフックで押さえておくよう勧められています。

時間の上限とできないこと

画面の前で終わるのを待つ動かし方では、確認待ちの時間も含めて10分で止まります。オートモードか、確認をすべて飛ばすモードなら、裏に回して最大2時間まで動かせます。

ほかにも、スマホなど別の端末から操作するRemote Control、ブラウザの中で動くClaude in Chrome、画面を操作する機能(computer use)は使えません。Code Modeで始めた会話は、Code Modeをオンにしたままでないと再開できないことも覚えておいてください。

その後の更新で、2.1.326からはエージェントチーム(複数のClaudeを組ませる機能)とも一緒に使えるようになり、2.1.328では、オートモードと確認を飛ばすモードで、ほとんどのコードの実行後にあった0.75秒の待ちがなくなりました。

会社で使っている人へ

管理者は、組織の管理用の設定で CLAUDE_CODE_EXPERIMENTAL_CODE_MODE を 0 にすれば止められます。逆に、管理者が全員を強制的にオンにすることはできません。実験的な機能で、公式も「いつ変わったり消えたりしてもおかしくない」と書いています。

私のおすすめは、個人の手元で、書き換えが多い作業から試すことです。Claude Codeの許可の考え方をまだ決めていない会社は、Code Modeより先にそちらを整えてください。