Claude CodeのCode Modeをチームで許可する前に、フック、権限ルール、管理設定のどこを見直すべきかをまとめました。Code Modeは、ClaudeがJavaScriptのコードを書き、1ステップで多数のツール呼び出しを実行する実験的な機能です。デフォルトでは無効で、今後のリリースで仕様が変わったり機能ごと削除されたりする可能性があります。
先に結論を書くと、コード内のツール呼び出しにはこれまでどおりdenyとaskの権限ルールもPreToolUseフックも適用されます。ただし次の3点が変わります。
- autoモードの分類器はClaudeが書いたコードをレビューするだけで、コード内のツール呼び出しを1つずつ確認することはない
PreToolUseフックが失敗するかタイムアウトすると、そのツール呼び出しは拒否される- コードの実行時間に上限がある(Claudeが完了を待つなら10分、バックグラウンドなら最長2時間)
Code Modeは、各ユーザーが環境変数CLAUDE_CODE_EXPERIMENTAL_CODE_MODEを1にして有効にします。組織全体で禁止したいときは管理設定でこの変数を0に設定します。
Code Modeとは何か、どう有効にするかは、ConvikaのブログにあるCode Modeの解説記事に書いてあります。この記事ではチームで運用するときに必要なことだけを扱います。
コード内のツール呼び出しには何が適用されるか
Claudeがコードを実行すると、コード内のツール呼び出しごとにdenyとaskの権限ルールとPreToolUseフックが適用されます。ツール名もBashやReadのままで、通常のセッションと変わらないため、Bash、Read、Edit用に書いたルールやフックは、マッチャーを変えなくてもそのまま効きます。
実際にClaude Code v2.1.327をautoモードで試しました。Markdownファイルが3つあるディレクトリで、公式ドキュメントのプロンプト例をそのまま送りました。
Read every Markdown file in this project and list the links that point to local files that don't exist.
会話に表示されたのはSearched for 1 pattern, read 3 files, ran 7 shell commandsの1行だけでした。
Ctrl+Oで詳細を開くと、折りたたまれたCodeという行が1つあり、中身は30行のコードでした。その下に、このコードから実行された11回のツール呼び出しが、通常と同じツール名で並んでいました。内訳はBash(find . -type f …)が1回、各ファイルのReadが3回、リンク1件ごとのBash(test -e './docs/missing.md')のような存在確認が7回です。フックを設定していれば、この1回のコード実行で、PreToolUseフックは合計12回実行されます。内訳はBashが8回、Readが3回、コードを実行するREPLツール(後述)が1回です。
ルールとフック以外にどんなチェックが入るかは、権限モードによって変わります。
| 権限モード | ルールとフック以外のチェック | チームで気をつけること |
|---|---|---|
| autoモード | 分類器は実行前にコードを一度レビューするだけで、個々のツール呼び出しは確認しない | 検索結果から取得したパスのように実行時に決まる値は分類器から見えないので、必ず止めたい呼び出しにはルールかフックを残す |
| その他の権限モード | コードはレビューなしで実行され、確認が必要なツール呼び出しのたびに権限プロンプトが表示される | 必ず止めたい呼び出しはルールかフックで止め、権限プロンプトへの応答を待っている時間も実行時間に数えられる点に注意する |
autoモードの分類器がコードを読む時点では、パスも引数もまだ決まっていません。そのため、実行時の値によって止めるかどうかが決まる呼び出しは分類器に任せられず、denyとaskの権限ルールかPreToolUseフックで決定論的に止める必要があります。
シェルコマンドを検査するフックは複合コマンドを分割して扱う
シェルコマンドを許可したりブロックしたりするPreToolUseフックを使っているチームは、最初にそのフックを直してください。Code Modeではappディレクトリでのgit pushがcd 'app' && git pushという形でフックに渡されることがあります。コマンドがgit pushで始まるかどうかだけを検査しているフックは、これを通してしまいます。Bashルールは複合コマンドを分割して個々のコマンドを判定するので、フックでも同じように分割して判定してください。
次のスクリプトは、コマンドを&&、||、;、|、&、改行、$(、バッククォート、丸括弧で分割し、個々のコマンドを検査します。先頭のVAR=valueと、サブコマンドの前に置くgitのオプション(-Cなど)は読み飛ばすので、git -C app pushや/usr/bin/git -c push.default=current pushもブロックできます。.claude/hooks/check-bash-parts.shに保存して実行権限を付けてください。実行にはjqが必要です。
#!/bin/bash
# Bash用のPreToolUseフック。複合コマンドのどこかにgit pushがあればブロックする
input=$(cat)
command=$(jq -r '.tool_input.command // empty' <<<"$input")
# シェルの区切り文字、コマンド置換の$(とバッククォート、丸括弧で分割して、1行1コマンドにする
nl=$'\n'
for sep in '&&' '||' ';' '|' '&' '$(' '`' '(' ')'; do
command=${command//"$sep"/$nl}
done
while IFS= read -r part; do
read -ra words <<<"$part"
i=0
# 先頭のVAR=valueを読み飛ばす
while [[ ${words[i]:-} == [A-Za-z_]*=* ]]; do i=$((i + 1)); done
[[ ${words[i]:-} == git || ${words[i]:-} == */git ]] || continue
i=$((i + 1))
# サブコマンドの前に置くgitのオプションを読み飛ばす。-Cと-cは値を取る
while [[ ${words[i]:-} == -* ]]; do
[[ ${words[i]} == -C || ${words[i]} == -c ]] && i=$((i + 1))
i=$((i + 1))
done
if [[ ${words[i]:-} == push ]]; then
echo "Blocked: git push is not allowed in this project. Found in: $part" >&2
exit 2
fi
done <<<"$command"
exit 0
フックが終了コード2を返すと、ツール呼び出しは拒否されます。標準エラー出力に書いた1行は、理由としてClaudeに渡されます。手元のbash 3.2で入力を変えて実行した結果は次のとおりです。
tool_input.command | 終了コード |
|---|---|
git push | 2 |
cd 'app' && git push | 2 |
npm test; git -C app push origin main | 2 |
FOO=bar /usr/bin/git -c push.default=current push | 2 |
echo "$(git push)" | 2 |
git commit -m 'no push yet' && git log --oneline | 0 |
git status && git stash push -m wip | 0 |
.claude/settings.jsonには次のように登録します。"onFailure": "block"を付けておくと、スクリプトが見つからないときやクラッシュしたときにもツール呼び出しは拒否されます。この設定は、Code Modeを使わないセッションでも同じように働きます。
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "\"${CLAUDE_PROJECT_DIR}\"/.claude/hooks/check-bash-parts.sh",
"timeout": 30,
"onFailure": "block"
}
]
}
]
}
}
Bashルールとフックが検査するのはコマンドの文字列
Code Modeのドキュメントにも注意書きがあるとおり、Bashルールはコマンドの文字列にマッチするだけなので、denyに書いたコマンドでも、Claudeが別の書き方をすれば実行できてしまいます。これはCode Modeに限った話ではありません。
権限のドキュメントによると、denyとaskの権限ルールはセキュリティ境界ではなく、Claudeが普通に書くコマンドを止めるためのものです。ドキュメントの例では、Bash(git push *)はgit push origin mainにはマッチしますが、git -C . push origin mainにはマッチしません。ここで紹介したフックも、コマンドの文字列で判定している点は同じです。コマンドの文字列に依存しない制限が必要な場合は、サンドボックスを使ってください。シェルコマンドがアクセスできるファイルと接続先のホストを、OSレベルで制限できます。
コードそのものはREPLにマッチするフックで検査する
Claudeが書いたコードそのものを検査したいときは、REPLにマッチするPreToolUseフックを書きます。REPLはコードを実行するツールの名前で、コードはtool_input.codeに入っています。コードの中身はCtrl+Oで詳細を開かないと見えないので、実行されたコードをチームで記録しておきたい場合にもこのフックが役立ちます。
次のスクリプトはコードをセッションごとのファイルに追記し、git pushという文字列か.envというファイル名を含むコードをブロックします。保存先は.claude/hooks/check-repl-code.shです。
#!/bin/bash
# REPL用のPreToolUseフック。Code Modeのコードを毎回ログに残し、git pushか.envを含むコードをブロックする
input=$(cat)
code=$(jq -r '.tool_input.code // empty' <<<"$input")
session=$(jq -r '.session_id // "unknown"' <<<"$input")
log_dir="${CODE_MODE_LOG_DIR:-$HOME/.claude/code-mode-log}"
mkdir -p "$log_dir"
printf '// %s\n%s\n\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$code" >>"$log_dir/$session.js"
if grep -qE 'git[^;&|`]*[[:space:]]push|\.env([^A-Za-z]|$)' <<<"$code"; then
jq -n '{
hookSpecificOutput: {
hookEventName: "PreToolUse",
permissionDecision: "deny",
permissionDecisionReason: "This code names git push or a .env file. Leave both out and run the code again."
}
}'
fi
exit 0
このスクリプトは、判定をhookSpecificOutputとして出力し、終了コード0で終わります。"deny"を返した場合はpermissionDecisionReasonがClaudeに渡されます。設定はPreToolUseの配列に、Bashのエントリと並べて追加します。
{
"matcher": "REPL",
"hooks": [
{
"type": "command",
"command": "\"${CLAUDE_PROJECT_DIR}\"/.claude/hooks/check-repl-code.sh",
"timeout": 30
}
]
}
tool_input.codeに次の1行を渡したところ、スクリプトは"deny"の判定を出力しました。
await $`cd app && git push origin main`;
rgでファイルを検索するだけの1行を渡した場合は、何も出力せずに正常終了しました。このフックが検査できるのは実行前のコードの文字列だけです。実行時に決まる値を使ったコマンドは対象外なので、コード全体はREPLのフックで、そこから実行される個々のコマンドはBashのフックで検査してください。
フックが失敗するとツール呼び出しは拒否される
Code Modeを使わないセッションでは、PreToolUseフックが起動に失敗したりタイムアウトしたりしても、ツール呼び出しはフックでは止まらず通常の権限の確認に進みます。拒否されるのは"onFailure": "block"を設定している場合だけです。Code Modeでは逆に、PreToolUseフックが判定を返さなかった場合、onFailureが未設定でも呼び出しは拒否されます。パスを間違えたまま誰も気づいていなかったフックがあると、Code Modeを有効にした日から影響が出ます。
チームのメンバーから「ツール呼び出しが拒否された」と報告を受けたら、そのメンバーに、どのエラーメッセージが出たかをClaudeに尋ねてもらってください。メッセージは次の2種類です。
| エラーメッセージ | 原因 | 対処 |
|---|---|---|
the hook failed | コード内のツール呼び出しで、フックが次のいずれかの状態になった ・起動できなかった ・強制終了された ・終了コードが126、127、または129以上だった ・HTTPエラーか無効な出力を返した | フックのパス、実行権限、出力するJSONを確認して修正する |
the hook did not finish | 次のどちらかの呼び出しでフックがタイムアウトした ・コード内のツール呼び出し ・そのセッションでClaudeが一度でもコードを実行したあとの、通常のツール呼び出し | フックのtimeoutを長くする |
失敗してもツール呼び出しを止めたくないフックもあるはずです。commandかhttpのフックに"onFailure": "continue"を設定しておくと、フックが失敗したりタイムアウトしたりしても呼び出しは続行されます。
もう1つ注意が必要なのが終了コードです。commandフックの終了コードが2でも上の表の値(126、127、129以上)でもない場合、たとえば1の場合は、呼び出しは続行されます。これも拒否させたい場合は"onFailure": "block"を設定してください。スクリプト自身の判断でブロックするときは、スクリプトから終了コード2を返します。
チームで配布しているPreToolUseフックは、ポリシーを強制するフックと、記録や通知だけを行うフックの2種類に分けてください。ポリシーを強制するフックには"onFailure": "block"と、処理が終わるのに十分な長さのtimeoutを設定します。記録や通知だけを行うフックには"onFailure": "continue"を設定します。
{
"type": "command",
"command": "\"${CLAUDE_PROJECT_DIR}\"/.claude/hooks/notify-slack.sh",
"timeout": 60,
"onFailure": "continue"
}
UserPromptSubmitフックはコードの出力に対しても実行される
バックグラウンド実行ができるセッションでは、UserPromptSubmitのcommand、http、mcp_toolの各フックがコードの出力に対しても実行されます。たとえばシークレットを含むプロンプトをブロックするフックがあると、同じパターンを含むテストのログもブロックされてしまいます。このときClaudeは、コードの出力の代わりにフックのブロック理由を報告します。
コードの出力を通すには、入力のsourceがpoll_eventのときはブロックしないようにフックを変更してください。
#!/bin/bash
# UserPromptSubmitフック。AWSのアクセスキーを含むプロンプトをブロックし、Code Modeのコードの出力は通す
input=$(cat)
# Code Modeのセッションで実行されたコードの出力は、sourceがpoll_eventの入力として渡される
if [[ $(jq -r '.source // empty' <<<"$input") == poll_event ]]; then
exit 0
fi
prompt=$(jq -r '.prompt // empty' <<<"$input")
if grep -qE 'AKIA[0-9A-Z]{16}' <<<"$prompt"; then
jq -n '{
decision: "block",
reason: "The prompt holds an AWS access key. Remove it and send the prompt again.",
hookSpecificOutput: { hookEventName: "UserPromptSubmit", suppressOriginalPrompt: true }
}'
fi
exit 0
入力に"source": "poll_event"を入れて実行したところ、このスクリプトは何も出力せず終了コード0で終わりました。キーを含むプロンプトを渡した場合はブロックの判定を出力しました。
実行時間の上限:完了を待つなら10分、バックグラウンドなら最長2時間
時間のかかるビルドやテストをコードから実行するとき、Claudeは完了を待つか、実行をバックグラウンドに回します。どちらになるかで実行時間の上限が変わります。
| 実行方法 | 会話への影響 | 実行時間の上限 |
|---|---|---|
| 完了を待つ | Claudeが応答するのはコードの実行が終わったあと | 10分で打ち切られる。権限プロンプトへの応答を待っている時間も含む |
| バックグラウンド | 実行中もClaudeと会話を続けられる | 最長2時間 |
バックグラウンドで実行させるには、セッションをautoモードかbypassPermissionsモードで開始する必要があります。これらのモードで開始したはずなのにClaudeが完了を待ってしまう場合は、現在のモードとセッションの開始方法を確認してください。
| 状況 | 対処 |
|---|---|
| 別のモードに切り替えた | 開始時のモードに戻るまでShift+Tabを押す |
別のモードで開始したか、claude --resumeの一覧からセッションを選んだ | autoモードが使える場合はいったん終了し、Code Modeを有効にしたままclaude --continue --permission-mode autoを実行する |
--toolsにツール名を渡して起動した | --toolsを外し、autoモードで起動し直す |
管理設定でpermissions.disableBypassPermissionsModeを"disable"にしているチームでは、bypassPermissionsモードで開始できません。バックグラウンド実行を使うセッションはautoモードで開始してください。
権限プロンプトに応答しないとカウントダウン後に呼び出しが拒否される
autoモードでは、コードの実行中にClaudeが次のコードを開始することがあります。このとき、先に動いていたコードはレビュー済みとして扱われなくなります。Claude Codeは、そのコードの残りの呼び出しのうちレビューが必要なものについて、実行してよいかをその都度ユーザーに尋ねます。IDEを接続していない場合、この権限プロンプトにはカウントダウンの行が付きます。
Claude Code will automatically block this request in 1:59, to avoid holding up an unattended session
カウントダウンが終わるまでに応答しないと、その呼び出しは拒否されます。それ以降に同じ確認が必要になった呼び出しも、権限プロンプトなしで拒否されます。権限プロンプトをもう一度表示させるにはClaudeにメッセージを送ってください。長時間の実行を任せて席を離れると、戻ったときにはすでに呼び出しが拒否されている、ということが起こりえます。初めて長時間の実行を任せる前に、この動作をチームに伝えておいてください。
組織でCode Modeを禁止する場合と許可する場合
組織の全員にCode Modeを使わせたくない場合は、管理設定のenvでCLAUDE_CODE_EXPERIMENTAL_CODE_MODEを0に設定します。JSONでは文字列として書きます。
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0"
}
}
サーバー管理設定やMDMで配布する場合も同じキーを使います。ファイルで配布する場合の置き場所はOSごとに次のとおりです。
| OS | ファイルの置き場所 |
|---|---|
| macOS | /Library/Application Support/ClaudeCode/managed-settings.json |
| LinuxとWSL | /etc/claude-code/managed-settings.json |
| Windows | C:\Program Files\ClaudeCode\managed-settings.json |
この設定を配布した時点でCode Modeのセッションを使っているユーザーは、Claude Codeを終了するまでそのままCode Modeを使い続けられます。次に起動したときからCode Modeは無効になり、設定が0になっている間はCode Modeのセッションを再開できません。無効になったあとに起動すると、画面の上部にCode Mode (experimental) isn't availableと表示され、同じ行に理由としてyour organization's settings don't allow itが続きます。
一方、管理設定からユーザーのCode Modeを有効にすることはできません。有効にするのは各ユーザー自身です。次のいずれかでCLAUDE_CODE_EXPERIMENTAL_CODE_MODEを1に設定します。
- シェルの環境変数
~/.claude/settings.json--settingsで渡すファイル
設定したあと最初のセッションを始めると確認画面が表示され、有効にするかどうかを各自が選びます。選択肢はNo, start without it(デフォルト)とYes, turn on Code Modeの2つです。この確認画面には、autoモードでの違いについて次の説明があります。
In auto mode, the safety check reads each piece of JavaScript once, before it runs.
It doesn't check each tool call that the code then makes,
so it can't see values that the code works out as it runs.
プロジェクトの設定ファイルに書いたCLAUDE_CODE_EXPERIMENTAL_CODE_MODEは無視されます。リポジトリをクローンしただけでCode Modeが有効になることはありません。
0と1が両方ある場合は0が優先されます。シェルの環境変数、ユーザー設定、--settingsで渡すファイル、管理設定のどれか1つでも0になっていれば、他の場所の設定にかかわらずCode Modeは無効のままです。管理設定に1が書かれている環境では、シェルの環境変数で設定した1が無視されます。その場合は~/.claude/settings.jsonに書いてください。
Code Modeが起動しない構成
Code Modeの要件は次のとおりです。
- Claude Code v2.1.323以降のネイティブビルド
- ClaudeのサブスクリプションまたはConsoleアカウント
- Claude Opus 5.5、Sonnet 5.5、Haiku 5.5、Fable 5.2のいずれかのモデル
- ターミナルで対話的に使う
claudeセッション - Git for Windows(Windowsの場合)
次の環境ではCode Modeを使えません。
-pでの実行とAgent SDK- VS Codeパネル、Desktopアプリ、クラウドセッション
- HIPAA構成またはゼロデータ保持を有効にしている組織
Code Modeのセッションの中ではRemote Control、Claude in Chrome、computer useも使えません。
Code Modeが無効の状態で起動した場合は、画面の上部にCode Mode (experimental) isn't availableという行が表示され、同じ行に理由が続きます。理由は/statusでも確認できます。次の表に、表示される理由のうちチーム共通の設定が原因になるものをまとめました。
| 理由に含まれる文字列 | 原因になるチームの構成 | 対処 |
|---|---|---|
it only works directly with the Anthropic APIまたはit only works with the Anthropic API | ゲートウェイ、クラウドプロバイダー(Amazon Bedrock、Claude Platform on AWS、Google CloudのAgent Platform、Microsoft Foundry)、カスタムのANTHROPIC_BASE_URL | これらを経由させる設定を削除する |
it doesn't work with an API key helper | apiKeyHelper、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_CUSTOM_HEADERS内のAuthorizationまたはX-Api-Keyヘッダー | 削除してから、サインインするかANTHROPIC_API_KEYを設定する |
OpenTelemetry is on | OpenTelemetryエクスポート | エクスポートなしで作業できる場合は、環境変数CLAUDE_CODE_ENABLE_TELEMETRYとENABLE_BETA_TRACING_DETAILEDを削除する |
it needs settings that Claude Code downloads from Anthropic | DISABLE_TELEMETRYなど、機能フラグの取得をオフにする変数 | その環境変数を削除する |
it doesn't yet work with the plugin | 理由に名前が出ているプラグイン | /pluginを実行して無効にする。組織が有効にしたプラグインの場合は、管理者に無効化を依頼する |
it doesn't yet work with an installed mod | ツール呼び出しをチェックするmod | そのmodをオフにする |
it can't be used together with agent teams yet | v2.1.326より前のバージョンでのエージェントチーム | v2.1.326以降に更新するか、環境変数CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMSを削除する |
it doesn't work in background jobs | --remote-control、または分割ペインで動くエージェントチームのチームメイト | --remote-controlを付けずに、フォアグラウンドで起動する。チームメイトをCode Modeで実行するにはインプロセス表示モードを使う |
this launch's tool options | 起動時のオプションやルールが次のいずれかに当てはまる ・ --restrictedを付けている・ --toolsにREPLが入っていない・ --disallowedToolsかdenyルールにREPLが入っている | --restrictedなしで起動し、--toolsにREPLを追加して、--disallowedToolsとdenyルールからREPLを削除する |
your organization's settings don't allow it | 管理設定でCLAUDE_CODE_EXPERIMENTAL_CODE_MODEが0になっている | 管理者に問い合わせる |
エージェントチームをv2.1.326以降で使う場合、チームメイトはデフォルトのインプロセス表示モードではCode Modeで実行され、分割ペインの表示モードではCode Modeが無効のまま起動します。
監査のためにOpenTelemetryをエクスポートしているチームや、すべてのリクエストをゲートウェイ経由にしているチームは、現時点ではその構成とCode Modeのどちらかを選ぶ必要があります。Code Modeを選ぶ場合は、「コードそのものはREPLにマッチするフックで検査する」の節で紹介したフックを入れておけば、実行されたコードをログに残せます。
Code ModeではCIの実行時間が増える
ドキュメントによると、Code Modeが向いているのは、多数のファイルに同じ変更を繰り返す作業と、互いに独立した複数のコマンドを同時に実行する作業です。バックグラウンドに回せば、こうした作業を長時間任せられます。たとえば40個のパッケージを順に編集し、1つ終わるたびにコミットしてpushするセッションでは、pushのたびにチームのワークフローが動きます。Code Modeは-pでは使えないので、セッション自体がCIのジョブとして動くわけではありません。増えるのは、ターミナルのセッションからpushするたびに動くCIのジョブです。
GitHubホストランナーの料金は1分あたりの単価で計算され、1分未満の端数はジョブごとに1分に切り上げられます。pushが増えればその分だけ請求が増えます。
Skipboxは定額のGitHub Actionsランナーです。ジョブはアカウント専用のマシンで動き、料金は月6,000 円の定額で実行時間は無制限なので、1回のバックグラウンド実行の間に40回pushしても請求は変わりません。
| 月の実行時間(4 vCPU) | GitHub | Skipbox(Sプラン) | 毎月の差額 |
|---|---|---|---|
| 10,000分 | 参考値:2026年11月10日の為替レート・1ドル=158.22円。米ドルの料金を、このレートで円に換算した概算です。 | 6,000 円 | 参考値:2026年11月10日の為替レート・1ドル=158.22円。米ドルの料金を、このレートで円に換算した概算です。 |
| 20,000分 | 参考値:2026年11月10日の為替レート・1ドル=158.22円。米ドルの料金を、このレートで円に換算した概算です。 | 6,000 円 | 参考値:2026年11月10日の為替レート・1ドル=158.22円。米ドルの料金を、このレートで円に換算した概算です。 |
| 30,000分 | 参考値:2026年11月10日の為替レート・1ドル=158.22円。米ドルの料金を、このレートで円に換算した概算です。 | 6,000 円 | 参考値:2026年11月10日の為替レート・1ドル=158.22円。米ドルの料金を、このレートで円に換算した概算です。 |
GitHubの金額は、GitHub Teamに含まれる無料分を引いたあとの請求額です。
専用のマシンにはDockerのレイヤー、パッケージのキャッシュ、ビルドの成果物がジョブのあとも残ります。そのため2回目以降のpushで動くジョブは、依存パッケージのインストールやイメージの取得をやり直さずに済みます。ワークフローの変更はruns-onの1行だけです。
jobs:
test:
runs-on: skipbox # ubuntu-latestから書き換える
移行の手順は次の3つです。
- GitHubアカウントでSkipboxにログインする
- SkipboxのGitHubアプリをインストールして、使うリポジトリを選ぶ
runs-onを書き換えてpushする
クレジットカードの登録は不要です。無料トライアルの期間は、最初のジョブを実行してから7日間です。その前にジョブの実行時間の合計が3,000分に達した場合は、そこで終了します。
エージェントを使うとCIがどれだけ増えるかはAIコーディングエージェントとGitHub Actionsの請求に、pushごとの待ち時間を縮める方法はAIコーディングエージェントのCIにまとめてあります。
チームでCode Modeを有効にする前のチェックリスト
- 誰に許可するかを決める。まだ誰にも許可しない場合は、管理設定で禁止すれば以降の手順は不要
- Code Modeの要件を、チーム共通の構成と照らし合わせる
- v2.1.323以降である(エージェントチームを使う場合はv2.1.326以降)
- ゲートウェイやクラウドプロバイダーを経由していない
- APIキーヘルパー、OpenTelemetryエクスポート、
DISABLE_TELEMETRYを使っていない - ツール呼び出しをチェックするmodがない
denyルールにREPLがない
- シェルコマンドを検査する
PreToolUseフックをすべて、複合コマンドを分割して扱うように書き直す - すべての
PreToolUseフックにonFailureと余裕のあるtimeoutを設定する。ポリシーを強制するフックは"block"、記録や通知だけを行うフックは"continue" - 実行されたコードを記録したい、あるいは検査したい場合は、
REPLにマッチするPreToolUseフックを追加する - プロンプトをブロックする
UserPromptSubmitフックをすべて、sourceがpoll_eventの入力を通すように変更する - autoモードでも必ず止めたい呼び出しには
denyとaskの権限ルールを残す。コマンドの文字列に頼らずに制限したいものにはサンドボックスを使う - 次の3点をチームに伝える
- バックグラウンド実行にはautoモードでの開始(
--permission-mode auto)が必要なこと - 完了を待つ実行とバックグラウンド実行で、実行時間の上限が違うこと
- 権限プロンプトに応答しないと呼び出しが拒否されること
- バックグラウンド実行にはautoモードでの開始(
- Code Modeのセッションからのpushで動くワークフローの
runs-onをskipboxに書き換えて、長時間の実行でCIの請求が増えないようにする - 各ユーザーがシェルか
~/.claude/settings.jsonでCLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1を設定する。Code Modeのセッションを再開するときも設定したままにする
よくある質問
Code ModeでもPreToolUseフックは動きますか?
動きます。Bashなど通常と同じツール名で、コード内のツール呼び出しごとに実行されます。ただしフック側で直すところが2つあります。複合コマンドの扱いと、フックが失敗したときの設定です。
Code Modeを組織全体で禁止するにはどうしますか?
管理設定でCLAUDE_CODE_EXPERIMENTAL_CODE_MODEを0にします。JSONの書き方と、すでにCode Modeを使っているユーザーがどうなるかは「組織でCode Modeを禁止する場合と許可する場合」の節を見てください。
リポジトリの設定でCode Modeを有効にできますか?
できません。有効にできるのは各ユーザー自身だけで、リポジトリに置いた設定でも管理設定でも有効にはできません。
the hook failedやthe hook did not finishと表示されるのはなぜですか?
コード内のツール呼び出しに対して、PreToolUseフックが判定を返せなかったからです。the hook failedはフックの失敗、the hook did not finishはタイムアウトを指します。原因の一覧と対処は「フックが失敗するとツール呼び出しは拒否される」の節の表にあります。
autoモードはCode Modeのツール呼び出しを1つずつレビューしますか?
いいえ。分類器がレビューするのは実行前のコード全体だけです。必ず止めたい呼び出しには、権限ルールかフックを使ってください。
Code Modeのコードは何分まで実行できますか?
Claudeが完了を待つ実行は10分、バックグラウンド実行は最長2時間です。バックグラウンドで実行させるには、セッションをautoモードかbypassPermissionsモードで開始します。
OpenTelemetryのエクスポート、ゲートウェイ、Amazon Bedrock、claude -pと一緒にCode Modeは使えますか?
いいえ。どれとも併用できません。Code Modeが動く条件と、起動しないときに表示される理由ごとの対処は「Code Modeが起動しない構成」の節にあります。
Code ModeでGitHub Actionsの請求は増えますか?
pushが増えれば、その分だけ請求も増えます。pushのたびにワークフローが動き、GitHubホストランナーはジョブごとに分単位で課金されるからです。Skipboxならpushが何回あっても月6,000 円の定額で、移行はruns-onをskipboxに書き換えるだけです。
Skipboxを試すのに料金はかかりますか?
かかりません。クレジットカードの登録は不要です。無料トライアルの期間は最初のジョブを実行してから7日間で、その前にジョブの実行時間の合計が3,000分に達した場合はそこで終了します。
出典
最後の1件はGitHubのドキュメント、それ以外はClaude Codeのドキュメントです。括弧の中は参照した項目で、いずれも2026年11月18日時点の内容です。
- Code Modeでコードからツール呼び出しを実行する
- フックリファレンス(
PreToolUse、UserPromptSubmit、onFailure、timeout) - 権限の設定(複合コマンド、Bashルールがマッチしない形式)
- 権限モード(autoモード)
- 管理設定のデプロイ
- 設定リファレンス(Claude Codeが
envで無視する変数) - サンドボックス化されたBashツール
- エージェントチーム(表示モード)
- GitHub Actionsランナーの料金
2026年11月18日 更新