Claude Code autoMode設定の使い方 信頼先と分類器ルールを定義

Claude Code セキュリティ 7分で読めます

Claude CodeのAutoモードは、ツール呼び出しを分類器に通し、取り消せない操作や環境の外へ向かう操作だけを止めることで、日常的な確認プロンプトを減らす仕組みです。ただし初期状態の分類器が信頼するのは作業ディレクトリと現在のリポジトリに設定されたリモートだけなので、社内のGitHub組織への push やチームのクラウドバケットへの書き込みは止まります。この記事では、2026年11月7日に確認した公式ドキュメント「Configure auto mode」と「Choose a permission mode」を基に、autoMode設定ブロックで分類器に信頼先を教える方法を整理します。

Autoモード設定の役割と読み込み先

Autoモードの有効化・切り替え(CLIではShift+Tabやclaude --permission-mode auto)は権限モードの話で、この記事で扱うautoModeブロックは「分類器に何を信頼させるか」の設定です。権限ルールのdenyと、内容を絞ったaskは分類器より先に評価されるため、Autoモード中でも従来どおり拒否・確認されます。

分類器はClaude自身と同じCLAUDE.mdを読みます。「force push しない」のようなプロジェクトの決まりはCLAUDE.mdに書けば、Claudeと分類器の両方に効きます。組織をまたぐ信頼先はautoModeブロックに書き、次のスコープから読み込まれます。

スコープ置き場所用途
開発者個人~/.claude/settings.json個人の信頼インフラ
組織全体管理設定(managed settings)全開発者に配る信頼インフラ
自動化--settingsフラグ、Agent SDK のインラインJSON実行ごとの上書き

注意点として、プロジェクト設定の.claude/settings.jsonと.claude/settings.local.jsonに書いたautoModeは読まれません。リポジトリ自身が許可ルールを持ち込めないようにするためで、.claude/settings.local.jsonにある場合は~/.claude/settings.jsonへ移します。各スコープの項目は足し合わされ、個人は追加できても管理設定の項目は消せません。どんな場合でも実行させたくない操作は、分類器ではなく管理設定のpermissions.denyで止めるよう公式は案内しています。

autoMode.environmentで信頼先を定義する

多くの組織で必要なのはautoMode.environmentだけです。分類器はここに書かれていない送り先を「外部」、つまり情報流出の候補とみなします。項目は正規表現やツールパターンではなく、新しく入ったエンジニアにインフラを説明するときのような自然文で書きます。既定の項目を残したまま追加するには、配列に文字列"$defaults"を入れます。その位置に既定項目が差し込まれます。

{
  "autoMode": {
    "environment": [
      "$defaults",
      "Source control: github.example.com/acme-corp and all repos under it",
      "Trusted cloud buckets: s3://acme-build-artifacts, gs://acme-ml-datasets",
      "Trusted internal domains: *.corp.example.com, api.internal.example.com",
      "Key internal services: Jenkins at ci.example.com, Artifactory at artifacts.example.com"
    ]
  }
}

claude auto-mode defaultsが表示する既定項目は3種類です。組織名、主な用途、クラウド、リポジトリの公開範囲、ホストの隔離状況などを書く文脈の枠、信頼するリポジトリ・ソース管理・社内ドメイン・バケット・社内サービス・社内パッケージレジストリを書く信頼の枠、個人情報などの置き場所や本番扱いの接続先、保護したいIaC範囲を書く機密性の枠です。信頼の枠はリポジトリ関係以外は「未設定」が既定なので、書くまで何も信頼されません。機密性の枠は、名前にprodやproductionを含むホストを機密な接続先とみなすような広い推定で最初から働きます。

一度に全部埋める必要はありません。公式は、まずソース管理の組織と主要な社内サービスを足して「自社リポジトリへの push が止まる」というよくある誤検知を解消し、次に社内ドメインとバケット、残りはブロックが起きるたびに足す、という段階的な導入を勧めています。

/auto-mode-setupで下書きを作る

セッション内で/auto-mode-setupを実行すると、プロジェクトと最近のセッションを基にClaude Codeがenvironmentの項目(場合によっては後述のルール項目も)を下書きし、受け入れると~/.claude/settings.jsonへ書き込みます。読み取る対象は、そのプロジェクトのCLAUDE.md・README.md・設定ファイル・gitリモート、既存のautoModeとpermissions.allow、そして最近のセッションでClaudeが実行したコマンドに含まれるホスト・バケット・コマンド名です。あなたのメッセージは読みません。シェル履歴の先頭語と、ホーム配下のリポジトリのリモートは、任意のスキャンとして選んだ場合だけ加わります。

下書きは丸ごと受け入れるか破棄するかの二択で、個別の修正は保存後に設定ファイルを直接編集します。保存時、environmentは既定項目を書き出したうえで"$defaults"なしで書かれ、ルールの配列には"$defaults"が付きます。続けて、Autoモードでは無視されるBash(*)のようなpermissions.allowルールの削除も提案されます。

このコマンドはPro、Max、Ultra、Team、EnterpriseプランとClaude ConsoleのAPIキーで使え、必要なバージョンはプランごとに異なります(Pro・Max・Ultra・Teamはv2.1.228以降、ネイティブWindowsはv2.1.233以降、EnterpriseとConsoleのAPIキーはv2.1.283以降)。Unknown commandと出る場合は、新しいセッションを開く、claude --versionで版を確認する、といった対処が公式に挙がっています。クラウドセッションでは使えないため、手元のターミナルで実行します。

allow・soft_deny・hard_denyを上書きする

分類器の組み込みルールは3つの配列で差し替えられます。いずれも自然文のルールの配列です。

ここでいう明示的な意図は、Claudeがこれから行う操作そのものをユーザーが具体的に指示した場合だけです。公式の例では「リポジトリを片付けて」は force push の許可になりませんが、「このブランチを force push して」は許可になります。

{
  "autoMode": {
    "allow": [
      "$defaults",
      "Deploying to the staging namespace is allowed: staging is isolated from production and resets nightly"
    ],
    "soft_deny": [
      "$defaults",
      "Never modify files under infra/terraform/prod/: production infrastructure changes go through the review workflow"
    ],
    "hard_deny": [
      "$defaults",
      "Never send repository contents to third-party code-review APIs"
    ]
  }
}

最も重要な注意は"$defaults"の扱いです。これを入れずに配列を設定すると、そのセクションの既定ルールがまるごと置き換わります。soft_denyなら force push、curl | bash、本番デプロイなどの組み込みルールが、hard_denyなら組み込みのデータ流出ルールが消えます。各セクションは独立しているため、environmentだけを設定しても他の3つは既定のままです。

シェルコマンドについては、Bash(npm test)のような狭い許可ルールはAutoモードでも分類器より先に通ります。autoMode.classifyAllShellをtrueにすると、Autoモード中はBashとPowerShellの許可ルールをすべて止め、全シェルコマンドを分類器に判定させます。網羅性と引き換えに待ち時間と分類器呼び出しが増えます。

設定の確認とブロックへの対処

設定を保存したら、claude auto-modeサブコマンドで実際に効いている内容を確認します。

claude auto-mode defaults    # 組み込みのルールをJSONで表示
claude auto-mode config      # 自分の設定を反映した実効ルールを表示
claude auto-mode critique    # 自作ルールの曖昧さ・重複・誤検知の恐れを指摘
claude auto-mode reset       # ~/.claude/settings.json の autoMode を削除して既定に戻す

defaultsには--labelで規則名の先頭を渡して1件だけ表示する使い方もあります。設定ファイルを開かずに編集したい場合は、/permissionsのAuto modeタブから項目を追加でき、変更は~/.claude/settings.jsonに保存されます(v2.1.246以降)。

ブロックされるとAuto mode: [Data Exfiltration]のような通知が出ます。角括弧の中は一致した規則名です。/permissionsのRecently blockedタブで行を選び、説明文ではなく実際のコマンドを確かめてからrで承認すると、Claudeが再試行できます。この承認は許可ルールを追加しないので、恒常的に通したい場合は次のように使い分けます。

同じ送り先で何度も止まるのは、分類器に文脈が足りないサインです。environmentに足すか/auto-mode-setupで下書きを作り、claude auto-mode configで反映を確かめてください。なお push や PR 作成の前に必ず人の確認を挟みたい場合は、permissions.askに"Bash(git push *)"や"Bash(gh pr create *)"を入れる方法が公式に示されています。ただしgit -C <dir> pushのような書き方には一致しないため、コマンド全体を検査したい場合はPreToolUseフックを使います。

参照した一次情報は、Claude Code公式の「Configure auto mode」と「Choose a permission mode」です。必要なバージョンや提供条件は更新されるため、設定前に最新版を確認してください。