Claude CodeのCode Modeとは?有効化の手順、要件、起動しないときの直し方

Convika Team読了目安: 18 分

  • Claude Code
  • AI エージェント
目次

Code ModeはClaude Codeの実験的機能です。有効にすると、ClaudeはBashやEditなどのツールを1つずつ呼び出すのではなく、複数のツール呼び出しをJavaScriptのスクリプト1本にまとめて実行します。環境変数CLAUDE_CODE_EXPERIMENTAL_CODE_MODEを1にしてclaudeを起動すれば使えます。ただし使えるのは、v2.1.323以降のClaude Codeをターミナルで対話的に起動したときだけです。条件を満たさない場合、Code Modeは起動せず、理由がメッセージに表示されます。

この記事ではまずCode Modeの仕組みと要件を整理し、有効にする手順を説明します。続いて、有効にしたあとに変わる権限チェックと実行時間の上限を取り上げます。長時間の実行を任せると、その間はpushするたびにCIが動きます。そこでCIの料金と、定額で使えるGitHub Actionsランナー「Skipbox」にも触れます。起動しないときの対処は、記事の後半で13種類の理由ごとに表にまとめています。

機能の説明は2026年11月18日時点の公式ドキュメントにもとづいています。手順は同日、macOS上のClaude Code v2.1.327(モデルはFable 5.2)で実際に試しています。公式ドキュメントには「どのリリースでも変更または削除される可能性があります」とあるので、仕様は変わる前提で読んでください。

Code Modeとは

通常、ClaudeはBashやReadなどのツールを1つずつ呼び出し、結果を読んでから次に何をするかを決めます。Code ModeではClaudeが一連のツール呼び出しをスクリプトとして書き、Claude Codeがそれをセッションの中で実行します。

プロンプトでタスクを依頼するのはこれまでと同じです。違うのは、スクリプトの中で次の3つができることです。

  • コマンドを並列に実行する
  • ある呼び出しの結果を次の呼び出しで使う
  • 出力のうちClaudeが読む必要のある部分だけを返す

たとえば「リトライ回数の上限を上げて」と依頼すると、Claudeは次のようなスクリプトを書きます(公式ドキュメントの例)。

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() });

1行目でsrcの中からfunction retryPolicyを含むファイルをrgで探し、2行目で検索結果の先頭のファイルを取り出します。3行目でそのファイルのmaxAttempts: 3をmaxAttempts: 5に書き換え、4行目でテストを実行します。書き換えたファイルのパスとテストの出力は最後にClaudeへ返されます。通常なら検索、編集、テストのたびにClaudeが結果を読みますが、このスクリプトでは検索結果がそのまま次の行に渡ります。Claudeが読むのは最後の行が返す内容だけです。

会話に表示されるのは編集の差分などツール呼び出しの結果だけで、スクリプト自体は表示されません。スクリプトを読みたいときはCtrl+Oでトランスクリプトビューアを開いてください。実行されたスクリプトは、1本ごとにCodeという行に折りたたまれています。

どんな作業に向いているか

Code Modeはツール呼び出しの多い作業に向いています。たとえば次のようなものです。

  • 多数のファイルに同じ変更を入れる(数十ファイルの設定値の書き換えなど)
  • 検索結果を絞り込んでからClaudeに読ませる(数百行ヒットするうち、必要なのは一部だけの場合など)
  • 互いに独立したコマンドを同時に実行する(lintと型チェックなど)

Code Modeの要件

Code Modeを使うには、次の表の要件をすべて満たす必要があります。

項目要件
バージョンClaude Code v2.1.323以降(リリースチャネルはstableでもlatestでも可)
アカウントClaudeのサブスクリプション、またはConsoleアカウント
接続方法Anthropicへの直接接続
組織HIPAA構成とゼロデータ保持がどちらも無効の組織
モデルClaude Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.2
実行環境ターミナルで対話的に起動したclaudeセッション
エージェントチーム併用する場合はv2.1.326以降
インストール方法ネイティブビルド版のClaude Code
Windowsの場合Git for Windowsをインストールした環境

次のいずれかを経由して接続している場合は使えません。

  • ゲートウェイ
  • Amazon Bedrock
  • Claude Platform on AWS
  • Google CloudのAgent Platform
  • Microsoft Foundry
  • Claude Models on Google Cloud (Anthropic managed)

次の実行方法や環境でも使えません。

  • -pを付けた実行
  • Agent SDK
  • VS Codeパネル
  • Desktopアプリ
  • クラウドセッション

エージェントチームと併用する場合、チームメイトがCode Modeを使うかどうかは表示モードによって変わります。デフォルトのインプロセス表示モード(すべてのチームメイトをメインのターミナルの中で動かす)ではチームメイトもCode Modeを使い、分割ペイン表示モードでは使いません。エージェントチームとサブエージェントがどう違うかは、Claude CodeとCodexのサブエージェントの違いにまとめています。

上の表の要件をすべて満たしていても、次のいずれかを設定していると、Code Modeは起動しません。

  • APIキーヘルパー
  • OpenTelemetryエクスポート
  • 環境変数DISABLE_TELEMETRY

どの設定が原因かは起動時のメッセージに表示されるので、対処はCode Modeが起動しないときの表で確認してください。

Code Modeを有効にする手順

手順1:バージョンを確認する

claude --versionでバージョンを確認し、v2.1.323より古ければclaude updateで更新してください。stableチャネルで更新してもv2.1.323以降にならない場合は、新しいバージョンがstableに反映されるのを待つか、latestに切り替えてください。

手順2:環境変数を設定してClaude Codeを起動する

環境変数CLAUDE_CODE_EXPERIMENTAL_CODE_MODEを1にして起動すると有効になります。設定は、シェルで指定するか、~/.claude/settings.jsonに書くかの2通りです。

macOS、Linux、WSLのシェルでは次のコマンドで起動できます。

CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

WindowsのPowerShellでは次のとおりです。

$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
claude

設定ファイルで有効にするには~/.claude/settings.jsonに次のenvの設定を追記してからclaudeを起動してください。

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

設定ファイルに書く場合、効くのはユーザー設定(~/.claude/settings.json)だけです。プロジェクトの設定ファイルに書いてもClaude Codeは無視するので、クローンしたリポジトリの設定でCode Modeが勝手に有効になることはありません。

手順3:確認画面でYesを選択する

初めて起動するときは確認画面が表示されます。v2.1.327では画面のタイトルがCode Mode (experimental)で、選択肢はNo, start without itとYes, turn on Code Modeの2つでした。最初はNo, start without itが選択されているので、↓キーでYes, turn on Code Modeに移動してからEnterを押してください。そのままEnterを押すとCode Modeなしで起動してしまいます。

Yes, turn on Code Modeを選択するとClaude Codeが自動で再起動し、画面上部に次のメッセージが表示されます。

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

2回目以降は確認画面が表示されず、すぐにこのメッセージが出ました。別のメッセージが出たときや、何も出ないときはCode Modeが起動しないときで原因を確認できます。

手順4:ツール呼び出しの多いタスクを依頼する

結果が正しいかどうかを自分で判断できるよう、中身をよく知っているプロジェクトでツール呼び出しの多いタスクを依頼してみてください。今回は公式ドキュメントにあるプロンプトを英語のまま送りました。プロジェクト内のMarkdownファイルをすべて読み、リンク切れを一覧にしてもらう内容です。

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

検証には、Markdownファイルを3つ入れた小さなフォルダを使いました。3つのファイルにはローカルファイルへのリンクが合わせて7件あり、そのうち4件はリンク切れでした。実行中の会話には次の1行だけが表示されました。

Searching for 1 pattern, reading 3 files, running 7 shell commands…

完了するとこの1行はSearched for 1 pattern, read 3 files, ran 7 shell commandsに変わり、リンク切れ4件の一覧が表で返ってきました。プロンプトを送ってから結果が返るまでの時間は、2回試して25秒と17秒でした。会話には1行しか出ませんでしたが、裏では11回のツール呼び出しが実行されていました。中身は次の手順で確認できます。

手順5:Claudeが書いたスクリプトを読む

Ctrl+Oを押してCodeの行を展開すると、ツール呼び出しの元になっているJavaScriptを読めます。もう一度Ctrl+Oを押すと会話に戻ります。

手順4で実行したときはトランスクリプトビューアの先頭に次の行がありました。

⏺ Code(const files = (await $`find . -type f \( -iname '…) · 30 lines (click to show)

11回のツール呼び出しは30行のスクリプト1本にまとめられていました。この行の下には、スクリプトが実行したツール呼び出しが通常のツール名で並んでいます。内訳は次のとおりです。

  • Markdownファイルを探すfindが1回
  • ファイルごとのReadが3回
  • リンク先の有無を調べるtest -eが7回

Code Modeを無効にする

無効にするには、シェルの環境変数と~/.claude/settings.jsonの両方からCLAUDE_CODE_EXPERIMENTAL_CODE_MODEを削除し、新しいセッションを始めてください。

変数を残したまま値を0に変えても無効にできます。0は1より優先されるので、シェルと~/.claude/settings.jsonのどちらか一方に0があれば、もう一方が1でもCode Modeは無効になります。有効にしたはずなのにCode Modeのメッセージが出ないときは、どこかに0が残っていないかを先に確認してください。

Code Modeのセッションを再開する

Code Modeで始めたセッションをclaude --continueやclaude --resumeで再開するときはCLAUDE_CODE_EXPERIMENTAL_CODE_MODEを1にしたままにしてください。無効にするとそのセッションは再開できません。また、再開できるのはターミナルからだけです。

逆に、Code Modeなしで始めたセッションは、変数が1になっていてもそのままCode Modeなしで再開されます。

制限事項

Code Modeを使うときの制限は次のとおりです。

  • セッションの再開には条件がある(前節を参照)
  • autoモードの分類器(ユーザーの代わりに操作をチェックする別のモデル)は、個々のツール呼び出しではなくスクリプトをチェックする
  • バックグラウンドで実行できないセッションでは、スクリプトは10分で停止する
  • PreToolUseフックを実行できないときやタイムアウトしたときは、ツール呼び出しが拒否される
  • UserPromptSubmitフックがスクリプトの出力をブロックすることがある
  • Remote Control、Claude in Chrome、computer useは使えない
  • セッションをDesktopアプリに移すこともバックグラウンドセッションに変えることもできない
  • /forkでセッションを複製してバックグラウンドで動かすことはできない

このうち分類器、フック、10分の上限は設定や使い方しだいで影響が変わるので、次の節から順に説明します。

権限チェック

Code Modeでも、スクリプト内のツール呼び出しはBashなどの通常のツール名で扱われ、権限ルール(denyとask)とPreToolUseフックの両方でチェックされます。それに加えて、スクリプト自体がどうチェックされるかは権限モードで変わります。

権限モードスクリプトのチェック
autoモード分類器が実行前のスクリプトを1本ずつチェックする(ツール呼び出し単位ではない)
その他の権限モードスクリプトはチェックなしで実行され、そのモードで承認が必要なツール呼び出しのたびに確認が表示される

分類器が読むのは実行前のスクリプトなので、検索結果から得たパスのように実行時に決まる値は見えません。そのため、確実に制御したい呼び出しには権限ルールやフックを残しておいてください(公式ドキュメントも同じことを勧めています)。

フックを使っている場合の注意

PreToolUseフックでコマンドを許可またはブロックしている場合、Code Modeではフックに届くコマンドの形が変わります。たとえばappフォルダで実行するgit pushはcd 'app' && git pushとしてフックに届くことがあるので、フック側でコマンドの各部分をチェックする必要があります。スクリプト自体をチェックしたい場合は、REPL(スクリプトを実行するツール)にマッチするPreToolUseフックを書き、tool_input.codeからJavaScriptを読み取ってください。

フックが判定を返さなかったときの扱いも変わります。スクリプトからの呼び出しではフックが失敗するとthe hook failed、タイムアウトするとthe hook did not finishというエラーでツール呼び出しが拒否されます。onFailureを設定していなくても同じです。

スクリプトをバックグラウンドで実行できるセッションでは、UserPromptSubmitフックがスクリプトの出力に対しても動きます。出力を通すには、入力のsourceがpoll_eventのときはブロックしないようにフックを変更してください。

フックの書き換え方は、Skipboxのガイド「Claude CodeのCode Modeをチームで使う前に:フック、権限ルール、実行時間の上限、管理設定」で詳しく説明しています。autoモードで出るカウントダウン付きの権限確認や、管理設定で組織全体のCode Modeを止める方法も載っています。PreToolUseフックの基本はClaude Codeのガードレールはフックで作るで解説しています。

スクリプトの実行時間の上限(10分と2時間)

スクリプトが長時間のビルドやテストを実行している間、Claudeは完了を待つか、スクリプトをバックグラウンドで動かし続けます。どちらになるかはセッションの権限モードで決まります。

項目完了を待つ場合バックグラウンドで動かす場合
Claudeとの会話スクリプトの完了後にClaudeが応答するスクリプトの実行中も続けられる
実行時間の上限10分で停止する(権限確認の待ち時間も含む)最大2時間

バックグラウンドで実行するにはautoモードまたはbypassPermissionsモードでセッションを始めてください。確認をすべて省くbypassPermissionsモードの使いどころは--dangerously-skip-permissionsを安全に使う方法で説明しています。バックグラウンドで実行されずClaudeがスクリプトの完了を待ってしまう場合は、原因に応じて次のように対処してください。

  • セッションの途中で別のモードに切り替えた場合は、開始時のモードに戻るまでShift+Tabを押す
  • 別のモードで始めた場合やclaude --resumeの一覧からセッションを選択した場合は、いったん終了し、Code Modeを有効にしたままclaude --continue --permission-mode autoを実行する(autoモードが使える環境のみ)
  • --toolsにツール名を渡した場合は、そのフラグを外してautoモードで起動し直す

Code Modeでpushが増えるとCIの料金はどうなるか

バックグラウンドのスクリプトは最大2時間動き続けます。その間にClaudeがコミットとpushを繰り返すと、pushのたびにリポジトリのCIが動きます。pushが増えた分だけ、CIの実行時間も積み上がります。

なお、Code ModeがGitHub Actionsの中で動くことはありません。Claude CodeのGitHub ActionはAgent SDKをベースにしていて、Code ModeはAgent SDKでも非対話モード(-p)でも動かないからです。CIが動くのは、ターミナルのセッションからpushしたときです。

GitHubホストランナーは実行時間に応じて課金されます。プライベートリポジトリで使う標準のLinuxランナー(2コア)は1分あたり0.006ドルで、実行時間はジョブごとに1分単位で切り上げられます。たとえば10分かかるCIが1日30回動くと1日300分で1.8ドル、20営業日で36ドルです。プランに含まれる利用枠を使い切ったあとはこの金額がそのまま請求されます。

セルフホストランナーの実行時間にはGitHubの料金がかかりません。冒頭で触れたSkipboxは、セルフホストランナーを定額で使えるサービスです。4 vCPUのプランは月6,000 円(税込)で実行時間は無制限なので、エージェントが何回pushしても請求額は変わりません。ワークフローのruns-onを1行書き換えるだけで移行できます。リポジトリはパブリックでもプライベートでも、アカウントは組織でも個人でも使えます。

jobs:
  test:
    runs-on: skipbox

無料トライアルの期間は、最初のジョブを実行してから7日間です。7日たつ前にジョブの実行時間が合計3,000分に達した場合は、その時点でトライアルは終了します。トライアル中に同時に実行できるジョブは最大4つ(それぞれ4 vCPU)で、数はご自分のGitHub Actionsの利用状況から決まります。クレジットカードの登録は不要で、やめるときもruns-onを元に戻すだけです。

Skipboxの無料トライアルを始める(skipbox.dev)

Code Modeが起動しないとき

画面上部にCode Mode (experimental) isn't availableと表示される場合、Claude CodeはCode Modeなしで起動しています。理由はこのメッセージに続けて表示され、/statusでも確認できます。次の表から該当する理由を探して対処し、新しいセッションを始めてください。

理由に含まれる文字列対処
it isn't open to your account in this versionまたはit isn't open to your account yetv2.1.323より古ければ更新し、v2.1.323以降ならネットワーク接続を確認して起動し直す(直らないときは表の下を参照)
it only works directly with the Anthropic APIまたはit only works with the Anthropic APIクラウドプロバイダー、ゲートウェイ、カスタムのANTHROPIC_BASE_URLを経由させる設定を削除する
it doesn't work with an API key helperapiKeyHelper、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_CUSTOM_HEADERSのAuthorizationやX-Api-Keyヘッダーを削除してから、サインインするかANTHROPIC_API_KEYを設定する
it only works with Opus 5.5, Sonnet 5.5 and later models対応しているモデルで起動する(例:--model opus。Haiku 5.5とFable 5.2も対応)
it doesn't work in background jobs--remote-controlを付けずにフォアグラウンドで起動する(この理由がチームメイトの分割ペインに出る場合はインプロセス表示モードに切り替える)
it needs settings that Claude Code downloads from AnthropicDISABLE_TELEMETRYなど、機能フラグの取得を止めている変数を削除する
OpenTelemetry is onOpenTelemetryエクスポートなしで作業できる場合は、CLAUDE_CODE_ENABLE_TELEMETRYとENABLE_BETA_TRACING_DETAILEDを削除する
it doesn't yet work with the pluginセッションで/pluginを実行し、理由に名前が出ているプラグインを無効にする(組織が有効にしたプラグインは管理者に依頼する)
it doesn't yet work with an installed modツール呼び出しをチェックするmod(Claude Codeの動作を変えるプラグイン)を無効にする
it can't be used together with agent teams yetエージェントチームを使い続ける場合はClaude Codeをv2.1.326以降に更新し、今のバージョンのまま使う場合はCLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMSを削除する
this launch's tool options起動オプションとdenyルールを直す(直し方は表の下を参照)
couldn't save your answer~/.claude.jsonを書き込み可能にする
your organization's settings don't allow it組織の管理者に管理設定を確認してもらう

表の1行目の理由は、更新してネットワーク接続を確認しても消えないことがあります。その場合は日を改めて試してください。

this launch's tool optionsが表示された場合は、起動オプションとdenyルールを次のように直してください。

  • --restrictedは外す
  • --toolsを指定している場合はREPLを追加する
  • --disallowedToolsやdenyルールにREPLがあれば削除する

表にない理由が表示された場合はCode Modeの要件を見直してください。

Code Modeについてのメッセージが何も出ない場合はclaude --versionを実行し、v2.1.323より古ければ更新してください。そのあとシェルかユーザー設定でCLAUDE_CODE_EXPERIMENTAL_CODE_MODEが1になっているかを見てください。シェル、ユーザー設定、--settingsで渡したファイルのどこかに値を0にした設定が残っていれば、すべて削除してください。

Claude Codeで作ったページを公開するならConvika

サイトの全ページのHTMLを一度に直す作業は、Code Modeが向いている「多数のファイルに同じ変更を入れる作業」の典型です。直したページをそのまま公開したいときは、Convikaが使えます。Convikaはページを保存して公開するホスティングサービスで、Claude CodeからはMCPで接続します。

claude mcp add --transport http convika https://mcp.convika.com

続けてClaude Codeで/mcpを開きます。ブラウザでConvikaにログインしてください。あとは「このフォルダのHTMLをConvikaに保存して、プレビューのリンクを教えて」と依頼するだけです。Convikaのcreate_landing_page_previewツールがページを保存して非公開のプレビューリンクを返します。リンクの有効期限は1 時間です。ページが複数あるときはClaudeがcreate_pagesで下書きを一度に作ります。プレビューを見て「公開して」と依頼すればページが公開されます。そのあとはページビューやフォームの回答もClaude Codeの会話の中で確認できます。

接続からフォームの追加、独自ドメインの設定までの手順はClaude Codeで作ったページを公開する方法に載せています。公開までの手順をスキルにしておく方法はClaude CodeとCodexのスキルの違いで紹介しています。

よくある質問

Claude CodeのCode Modeとは何ですか?

Claude Codeの実験的機能です。ツールを1つずつ呼び出す代わりに、ClaudeがJavaScriptのスクリプトを書いて複数のツールをまとめて呼び出します。デフォルトでは無効で、環境変数を設定すると有効になります。

Code Modeを有効にするにはどうすればいいですか?

環境変数CLAUDE_CODE_EXPERIMENTAL_CODE_MODEを1に設定してclaudeを起動します。初回の確認画面ではYes, turn on Code Modeを選択してください。常に有効にしておきたいときは~/.claude/settings.jsonのenvに書きます。

Code Modeはどのバージョンとモデルで使えますか?

Claude Code v2.1.323以降で使えます。対応モデルはClaude Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.2の4つです。エージェントチームと併用する場合はv2.1.326以降が必要です。

VS CodeやDesktopアプリでCode Modeは使えますか?

使えません。動作するのはターミナルで対話的に起動したclaudeセッションだけです。-pを付けた実行もAgent SDKもクラウドセッションも非対応です。

Amazon Bedrockやゲートウェイ経由でCode Modeは使えますか?

使えません。ClaudeのサブスクリプションかConsoleアカウントでAnthropicに直接接続する必要があります。起動時のメッセージにit only works directly with the Anthropic APIと表示されることがあります。その場合は、クラウドプロバイダーやカスタムのANTHROPIC_BASE_URLを経由させる設定を削除してください。

Code Modeのセッションを再開できないのはなぜですか?

Code Modeが無効の状態で再開しようとしているためです。CLAUDE_CODE_EXPERIMENTAL_CODE_MODEを1にしたままターミナルでclaude --continueまたはclaude --resumeを実行してください。

Code Modeを無効にするにはどうすればいいですか?

シェルの環境変数と~/.claude/settings.jsonの両方からCLAUDE_CODE_EXPERIMENTAL_CODE_MODEを削除するか、どちらか一方で値を0にしてください。そのうえで新しいセッションを始めてください。

Claudeが書いたJavaScriptはどこで読めますか?

Ctrl+Oで開くトランスクリプトビューアでCodeという行を展開すると読めます。

スクリプトは何分まで実行できますか?

Claudeが完了を待つ場合は10分までです。権限確認の待ち時間もこの10分に含まれます。autoモードかbypassPermissionsモードで始めたセッションではバックグラウンドで最大2時間実行できます。

Code Modeを使うとGitHub Actionsの料金は増えますか?

Code Mode自体はGitHub Actionsの中では動きません。ただし長時間のセッションからpushするたびにCIが動き、GitHubホストランナーではその実行時間に応じて課金されます。Skipboxなら月6,000 円(税込)の定額で実行時間は無制限です。無料トライアルはクレジットカードの登録なしで、最初のジョブから7日間使えます。その前に実行時間の合計が3,000分に達した場合は、そこで終了します。

出典(2026年11月18日に確認)

関連記事

記事を共有する