# Claude CodeのCode Modeをチームで使う前に：フック、権限ルール、実行時間の上限、管理設定

> Code Modeでも、ツール呼び出しにはdenyとaskの権限ルールとPreToolUseフックが適用されます。違うのは、(1)autoモードの分類器がコード全体を一度レビューするだけで個々のツール呼び出しは確認しないこと、(2)フックが失敗するかタイムアウトすると呼び出しが拒否されること、(3)実行時間に上限があること（バックグラウンド実行で最長2時間）の3点です。Code Modeを有効にする前に直しておきたいフックの例と、組織単位で禁止する管理設定を解説します。Code Modeではpushが増えてCIの実行時間が延びますが、Skipboxなら料金は月6,000 円の定額です。

Claude CodeのCode Modeをチームで許可する前に、フック、権限ルール、管理設定のどこを見直すべきかをまとめました。Code Modeは、ClaudeがJavaScriptのコードを書き、1ステップで多数のツール呼び出しを実行する実験的な機能です。デフォルトでは無効で、今後のリリースで仕様が変わったり機能ごと削除されたりする可能性があります。

先に結論を書くと、コード内のツール呼び出しにはこれまでどおり`deny`と`ask`の権限ルールも`PreToolUse`フックも適用されます。ただし次の3点が変わります。

1. autoモードの分類器はClaudeが書いたコードをレビューするだけで、コード内のツール呼び出しを1つずつ確認することはない
2. `PreToolUse`フックが失敗するかタイムアウトすると、そのツール呼び出しは拒否される
3. コードの実行時間に上限がある（Claudeが完了を待つなら10分、バックグラウンドなら最長2時間）

Code Modeは、各ユーザーが環境変数`CLAUDE_CODE_EXPERIMENTAL_CODE_MODE`を`1`にして有効にします。組織全体で禁止したいときは管理設定でこの変数を`0`に設定します。

Code Modeとは何か、どう有効にするかは、Convikaのブログにある[Code Modeの解説記事](https://convika.com/ja/blog/claude-code-code-mode/)に書いてあります。この記事ではチームで運用するときに必要なことだけを扱います。

- シェルコマンドを検査するフックは、複合コマンドを分割して検査するように直す必要がある
- フックの失敗時は、`onFailure`が未設定でも呼び出しが拒否される
- 組織全体での禁止は、管理設定の1行で済む
- バックグラウンド実行でpushが増えても、CIの料金はSkipboxなら月6,000 円の定額

## コード内のツール呼び出しには何が適用されるか

Claudeがコードを実行すると、コード内のツール呼び出しごとに`deny`と`ask`の[権限ルール](https://code.claude.com/docs/ja/permissions)と[`PreToolUse`フック](https://code.claude.com/docs/ja/hooks#pretooluse)が適用されます。ツール名も`Bash`や`Read`のままで、通常のセッションと変わらないため、`Bash`、`Read`、`Edit`用に書いたルールやフックは、マッチャーを変えなくてもそのまま効きます。

実際にClaude Code v2.1.327をautoモードで試しました。Markdownファイルが3つあるディレクトリで、公式ドキュメントのプロンプト例をそのまま送りました。

```text
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ルール](https://code.claude.com/docs/ja/permissions#compound-commands)は複合コマンドを分割して個々のコマンドを判定するので、フックでも同じように分割して判定してください。

次のスクリプトは、コマンドを`&&`、`||`、`;`、`|`、`&`、改行、`$(`、バッククォート、丸括弧で分割し、個々のコマンドを検査します。先頭の`VAR=value`と、サブコマンドの前に置くgitのオプション（`-C`など）は読み飛ばすので、`git -C app push`や`/usr/bin/git -c push.default=current push`もブロックできます。`.claude/hooks/check-bash-parts.sh`に保存して実行権限を付けてください。実行には`jq`が必要です。

```bash
#!/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を使わないセッションでも同じように働きます。

```json
{
  "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に限った話ではありません。

[権限のドキュメント](https://code.claude.com/docs/ja/permissions#bash-rule-limits)によると、`deny`と`ask`の権限ルールはセキュリティ境界ではなく、Claudeが普通に書くコマンドを止めるためのものです。ドキュメントの例では、`Bash(git push *)`は`git push origin main`にはマッチしますが、`git -C . push origin main`にはマッチしません。ここで紹介したフックも、コマンドの文字列で判定している点は同じです。コマンドの文字列に依存しない制限が必要な場合は、[サンドボックス](https://code.claude.com/docs/ja/sandboxing)を使ってください。シェルコマンドがアクセスできるファイルと接続先のホストを、OSレベルで制限できます。

## コードそのものはREPLにマッチするフックで検査する

Claudeが書いたコードそのものを検査したいときは、`REPL`にマッチする`PreToolUse`フックを書きます。`REPL`はコードを実行するツールの名前で、コードは`tool_input.code`に入っています。コードの中身は`Ctrl+O`で詳細を開かないと見えないので、実行されたコードをチームで記録しておきたい場合にもこのフックが役立ちます。

次のスクリプトはコードをセッションごとのファイルに追記し、`git push`という文字列か`.env`というファイル名を含むコードをブロックします。保存先は`.claude/hooks/check-repl-code.sh`です。

```bash
#!/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`のエントリと並べて追加します。

```json
{
  "matcher": "REPL",
  "hooks": [
    {
      "type": "command",
      "command": "\"${CLAUDE_PROJECT_DIR}\"/.claude/hooks/check-repl-code.sh",
      "timeout": 30
    }
  ]
}
```

`tool_input.code`に次の1行を渡したところ、スクリプトは`"deny"`の判定を出力しました。

```javascript
await $`cd app && git push origin main`;
```

`rg`でファイルを検索するだけの1行を渡した場合は、何も出力せずに正常終了しました。このフックが検査できるのは実行前のコードの文字列だけです。実行時に決まる値を使ったコマンドは対象外なので、コード全体は`REPL`のフックで、そこから実行される個々のコマンドは`Bash`のフックで検査してください。

## フックが失敗するとツール呼び出しは拒否される

Code Modeを使わないセッションでは、`PreToolUse`フックが起動に失敗したりタイムアウトしたりしても、ツール呼び出しはフックでは止まらず通常の権限の確認に進みます。拒否されるのは`"onFailure": "block"`を設定している場合だけです。Code Modeでは逆に、`PreToolUse`フックが判定を返さなかった場合、[`onFailure`](https://code.claude.com/docs/ja/hooks#block-the-action-when-a-hook-fails)が未設定でも呼び出しは拒否されます。パスを間違えたまま誰も気づいていなかったフックがあると、Code Modeを有効にした日から影響が出ます。

チームのメンバーから「ツール呼び出しが拒否された」と報告を受けたら、そのメンバーに、どのエラーメッセージが出たかをClaudeに尋ねてもらってください。メッセージは次の2種類です。

| エラーメッセージ | 原因 | 対処 |
|---|---|---|
| `the hook failed` | コード内のツール呼び出しで、フックが次のいずれかの状態になった<br>・起動できなかった<br>・強制終了された<br>・終了コードが126、127、または129以上だった<br>・HTTPエラーか無効な出力を返した | フックのパス、実行権限、出力するJSONを確認して修正する |
| `the hook did not finish` | 次のどちらかの呼び出しでフックがタイムアウトした<br>・コード内のツール呼び出し<br>・そのセッションでClaudeが一度でもコードを実行したあとの、通常のツール呼び出し | フックの[`timeout`](https://code.claude.com/docs/ja/hooks#common-fields)を長くする |

失敗してもツール呼び出しを止めたくないフックもあるはずです。`command`か`http`のフックに`"onFailure": "continue"`を設定しておくと、フックが失敗したりタイムアウトしたりしても呼び出しは続行されます。

もう1つ注意が必要なのが終了コードです。`command`フックの終了コードが2でも上の表の値（126、127、129以上）でもない場合、たとえば1の場合は、呼び出しは続行されます。これも拒否させたい場合は`"onFailure": "block"`を設定してください。スクリプト自身の判断でブロックするときは、スクリプトから終了コード2を返します。

チームで配布している`PreToolUse`フックは、ポリシーを強制するフックと、記録や通知だけを行うフックの2種類に分けてください。ポリシーを強制するフックには`"onFailure": "block"`と、処理が終わるのに十分な長さの`timeout`を設定します。記録や通知だけを行うフックには`"onFailure": "continue"`を設定します。

```json
{
  "type": "command",
  "command": "\"${CLAUDE_PROJECT_DIR}\"/.claude/hooks/notify-slack.sh",
  "timeout": 60,
  "onFailure": "continue"
}
```

## UserPromptSubmitフックはコードの出力に対しても実行される

バックグラウンド実行ができるセッションでは、[`UserPromptSubmit`](https://code.claude.com/docs/ja/hooks#userpromptsubmit)の`command`、`http`、`mcp_tool`の各フックがコードの出力に対しても実行されます。たとえばシークレットを含むプロンプトをブロックするフックがあると、同じパターンを含むテストのログもブロックされてしまいます。このときClaudeは、コードの出力の代わりにフックのブロック理由を報告します。

コードの出力を通すには、入力の`source`が`poll_event`のときはブロックしないようにフックを変更してください。

```bash
#!/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を接続していない場合、この権限プロンプトにはカウントダウンの行が付きます。

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

カウントダウンが終わるまでに応答しないと、その呼び出しは拒否されます。それ以降に同じ確認が必要になった呼び出しも、権限プロンプトなしで拒否されます。権限プロンプトをもう一度表示させるにはClaudeにメッセージを送ってください。長時間の実行を任せて席を離れると、戻ったときにはすでに呼び出しが拒否されている、ということが起こりえます。初めて長時間の実行を任せる前に、この動作をチームに伝えておいてください。

## 組織でCode Modeを禁止する場合と許可する場合

組織の全員にCode Modeを使わせたくない場合は、[管理設定](https://code.claude.com/docs/ja/managed-settings)の`env`で`CLAUDE_CODE_EXPERIMENTAL_CODE_MODE`を`0`に設定します。JSONでは文字列として書きます。

```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モードでの違いについて次の説明があります。

```text
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`は[無視されます](https://code.claude.com/docs/ja/settings-reference#variables-claude-code-ignores-in-env)。リポジトリをクローンしただけで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` | 起動時のオプションやルールが次のいずれかに当てはまる<br>・`--restricted`を付けている<br>・`--tools`に`REPL`が入っていない<br>・`--disallowedTools`か`deny`ルールに`REPL`が入っている | `--restricted`なしで起動し、`--tools`に`REPL`を追加して、`--disallowedTools`と`deny`ルールから`REPL`を削除する |
| `your organization's settings don't allow it` | 管理設定で`CLAUDE_CODE_EXPERIMENTAL_CODE_MODE`が`0`になっている | 管理者に問い合わせる |

[エージェントチーム](https://code.claude.com/docs/ja/agent-teams)を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分あたりの単価](https://docs.github.com/ja/billing/reference/actions-runner-pricing)で計算され、1分未満の端数はジョブごとに1分に切り上げられます。pushが増えればその分だけ請求が増えます。

Skipboxは定額のGitHub Actionsランナーです。ジョブはアカウント専用のマシンで動き、料金は月6,000 円の定額で実行時間は無制限なので、1回のバックグラウンド実行の間に40回pushしても請求は変わりません。

| 月の実行時間（4 vCPU） | GitHub | Skipbox（Sプラン） | 毎月の差額 |
|---|---|---|---|
| 10,000分 | 約 16,140 円 | 6,000 円 | **約 10,140 円** |
| 20,000分 | 約 35,120 円 | 6,000 円 | **約 29,120 円** |
| 30,000分 | 約 54,110 円 | 6,000 円 | **約 48,110 円** |

GitHubの金額は、GitHub Teamに含まれる無料分を引いたあとの請求額です。

専用のマシンにはDockerのレイヤー、パッケージのキャッシュ、ビルドの成果物がジョブのあとも残ります。そのため2回目以降のpushで動くジョブは、依存パッケージのインストールやイメージの取得をやり直さずに済みます。ワークフローの変更は`runs-on`の1行だけです。

```yaml
jobs:
  test:
    runs-on: skipbox # ubuntu-latestから書き換える
```

移行の手順は次の3つです。

1. GitHubアカウントでSkipboxにログインする
2. SkipboxのGitHubアプリをインストールして、使うリポジトリを選ぶ
3. `runs-on`を書き換えてpushする

**GitHub Actions を月額固定・使い放題に** Skipbox は、アカウント専用のマシンで GitHub Actions のジョブを動かします。何分動かしても月 6,000 円。ジョブが終わっても Docker のレイヤーと依存パッケージのキャッシュが残るので、次のジョブはすぐ始まります。

4 vCPU のランナーを月 20,000分 使うと、GitHub 約 35,120 円 → Skipbox 6,000 円。毎月 約 29,120 円お得。

移行は `runs-on: skipbox` に 1行書き換えるだけです。

[7日間無料で試す](https://app.skipbox.dev/sign-in?ref=g-claude-code-code-mode-hooks-permissions-ja)

クレジットカードの登録は不要です。無料トライアルの期間は、最初のジョブを実行してから7日間です。その前にジョブの実行時間の合計が3,000分に達した場合は、そこで終了します。

エージェントを使うとCIがどれだけ増えるかは[AIコーディングエージェントとGitHub Actionsの請求](https://skipbox.dev/ja/guides/ai-coding-agents-github-actions-cost)に、pushごとの待ち時間を縮める方法は[AIコーディングエージェントのCI](https://skipbox.dev/ja/guides/ci-for-ai-coding-agents)にまとめてあります。

## チームでCode Modeを有効にする前のチェックリスト

1. 誰に許可するかを決める。まだ誰にも許可しない場合は、管理設定で禁止すれば以降の手順は不要
2. Code Modeの要件を、チーム共通の構成と照らし合わせる
   - v2.1.323以降である（エージェントチームを使う場合はv2.1.326以降）
   - ゲートウェイやクラウドプロバイダーを経由していない
   - APIキーヘルパー、OpenTelemetryエクスポート、`DISABLE_TELEMETRY`を使っていない
   - ツール呼び出しをチェックするmodがない
   - `deny`ルールに`REPL`がない
3. シェルコマンドを検査する`PreToolUse`フックをすべて、複合コマンドを分割して扱うように書き直す
4. すべての`PreToolUse`フックに`onFailure`と余裕のある`timeout`を設定する。ポリシーを強制するフックは`"block"`、記録や通知だけを行うフックは`"continue"`
5. 実行されたコードを記録したい、あるいは検査したい場合は、`REPL`にマッチする`PreToolUse`フックを追加する
6. プロンプトをブロックする`UserPromptSubmit`フックをすべて、`source`が`poll_event`の入力を通すように変更する
7. autoモードでも必ず止めたい呼び出しには`deny`と`ask`の権限ルールを残す。コマンドの文字列に頼らずに制限したいものにはサンドボックスを使う
8. 次の3点をチームに伝える
   - バックグラウンド実行にはautoモードでの開始（`--permission-mode auto`）が必要なこと
   - 完了を待つ実行とバックグラウンド実行で、実行時間の上限が違うこと
   - 権限プロンプトに応答しないと呼び出しが拒否されること
9. Code Modeのセッションからのpushで動くワークフローの`runs-on`を`skipbox`に書き換えて、長時間の実行でCIの請求が増えないようにする
10. 各ユーザーがシェルか`~/.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でコードからツール呼び出しを実行する](https://code.claude.com/docs/ja/code-mode)
- [フックリファレンス](https://code.claude.com/docs/ja/hooks)（`PreToolUse`、`UserPromptSubmit`、`onFailure`、`timeout`）
- [権限の設定](https://code.claude.com/docs/ja/permissions)（複合コマンド、Bashルールがマッチしない形式）
- [権限モード](https://code.claude.com/docs/ja/permission-modes)（autoモード）
- [管理設定のデプロイ](https://code.claude.com/docs/ja/managed-settings)
- [設定リファレンス](https://code.claude.com/docs/ja/settings-reference#variables-claude-code-ignores-in-env)（Claude Codeが`env`で無視する変数）
- [サンドボックス化されたBashツール](https://code.claude.com/docs/ja/sandboxing)
- [エージェントチーム](https://code.claude.com/docs/ja/agent-teams)（表示モード）
- [GitHub Actionsランナーの料金](https://docs.github.com/ja/billing/reference/actions-runner-pricing)

2026-11-18 更新 · https://skipbox.dev/ja/guides/claude-code-code-mode-hooks-permissions
