Claude Codeの権限モード完全ガイド|Manual・Plan・acceptEdits・Autoなど6モードの使い分け

Claude Code
Claude Code 基本設定

Claude Codeの権限モード完全ガイド|Manual・Plan・acceptEdits・Autoなど6モードの使い分け

ステータスバーの「manual mode on」「accept edits on」といった表示、意味を正確に説明できますか?Claude Codeには6段階の権限モードがあり、Shift+Tabで切り替えられます。この記事では全モードの違い、切り替え方、目的別の選び方を、公式ドキュメントに基づいて一枚の地図として整理します。

スポンサーリンク

権限モードとは:どれだけ「確認なし」で進めるかの設定

Claude Codeがファイルを編集したり、コマンドを実行したり、ネットワークにアクセスしようとするとき、通常は一度立ち止まってあなたに確認を求めます。権限モード(Permission Mode)は、この「立ち止まって聞く」頻度をコントロールする設定です。

モードによってセッションの進み方が変わります。Manualモードは1つ1つの操作を確認しながら進み、より緩いモードほど長く中断なく作業させ、まとめて結果を報告させられます。神経を使う作業ほど確認を多く、信頼できる方向性の作業ほど確認を減らす——これが選び方の基本軸です。

6つのモード一覧:確認なしで実行される範囲

モード設定値確認なしで実行される範囲向いている場面
Manual(既定)default読み取りのみ初めて触るリポジトリ・慎重に進めたい作業
acceptEditsacceptEdits読み取り+ファイル編集+mkdirtouchmv等の基本コマンドレビュー前提でコードを反復修正するとき
Planplan読み取りのみ(書き込み・実行は一切不可)変更前にコードベースを調査・計画したいとき
Autoautoほぼすべて(AIによる安全性判定つき)長時間タスク・確認疲れを減らしたいとき
don’t askdontAsk事前承認済みのツールのみロックダウンされたCI・スクリプト環境
bypass permissionsbypassPermissionsすべて(安全チェックなし)隔離されたコンテナ・VM専用
ℹ 「Manual」という名前について

すべての操作を確認する既定モードは、CLI・VS Code拡張・JetBrainsプラグイン・デスクトップアプリで「Manual」と表示されます(設定値としてはdefaultのまま)。CLIではmanualという別名でも指定できます(Claude Code v2.1.200以降)。「manual mode」で検索して辿り着いた方は、これがAuto Modeの対極にある「確認ありの標準モード」だと理解してください。

切り替え方:Shift+Tabのサイクル

CLIでの基本操作はShift+Tabです。既定では次の順でサイクルします。

default(Manual) → acceptEdits → plan

ステータスバーには、現在のモードが次のように表示されます。

表示モード
⏸ manual mode onManual(v2.1.203以降で表示。それ以前は無表示)
⏸ plan mode onPlan
⏵⏵ accept edits onacceptEdits
⏵⏵ auto mode onAuto
⏵⏵ don't ask ondon’t ask
⏵⏵ bypass permissions onbypass permissions

AutoモードとbypassPermissionsモードは、条件を満たしたときだけサイクルに追加されます。

  • Auto:アカウントがAuto Modeの利用条件を満たしている場合にサイクルへ登場します
  • bypassPermissions--permission-mode bypassPermissions--dangerously-skip-permissionsで起動した場合にサイクルへ登場します
  • don’t ask:サイクルには登場しません。--permission-mode dontAskで明示的に起動する必要があります

起動時に指定する

claude --permission-mode plan

既定モードとして固定する

~/.claude/settings.json(個人設定)または.claude/settings.json(プロジェクト設定)に記述します。

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}
⚠ auto modeの既定化はユーザー設定のみ有効

defaultMode: "auto".claude/settings.json(プロジェクト設定)や.claude/settings.local.jsonには効きません。Claude Code v2.1.142以降は、リポジトリが自分自身にAuto Modeを付与できないよう、これらのファイルからのauto指定を無視します。既定化したい場合は~/.claude/settings.json(個人設定)に書いてください。Auto Modeの詳しい要件はAuto Modeの設定ガイドで解説しています。

各モードの詳細

acceptEdits:レビュー前提の反復編集向け

ファイル編集と、mkdirtouchrmmvcpsedといった基本的なファイル操作コマンドを確認なしで実行します。作業ディレクトリ内のパスに限定され、それ以外へのコマンドは通常どおり確認が必要です。「エディタやgit diffで後からまとめて確認したい」というスタイルに向いています。

Plan:変更前に調査だけさせる

読み取り・検索・調査コマンドの実行はできますが、書き込みは一切できません。Claudeが計画を提示したあと、次の4つから進め方を選べます。

  • Yes, and use auto mode:承認してAuto Modeで開始
  • Yes, manually approve edits:承認して1つずつ確認しながら編集
  • No, keep planning:Planモードのまま計画を練り直す

/planを先頭に付けたプロンプトでも一時的にPlanモードに入れます。Ctrl+Gで提案された計画をテキストエディタで直接編集することもできます。

Auto:AIの安全性判定つきでほぼ全自動

ほとんどの操作を確認なしで実行しますが、裏側で別のAI(分類器)が各操作を評価し、危険な操作は自動的にブロックします。本番デプロイ・強制削除・シークレットの書き込みなど、あらかじめ「原則ブロック」と決められた操作群があります。利用にはプラン・モデル・プロバイダーの条件があり、詳細はAuto Modeの仕組み解説をご覧ください。

don’t ask:CI・スクリプト専用のロックダウン

あらかじめ許可ルールに登録したツール以外は、確認を求めずに自動拒否します。セッションが入力待ちで止まることがないため、無人実行が前提のCIパイプラインに向いています。

bypass permissions:隔離環境専用の最終手段

安全チェックをすべて無効化し、即座に実行します。コンテナ・VMなど、host環境を壊しても被害が閉じ込められる場所以外では使わないでくださいrm -rf /rm -rf ~のようなホームディレクトリ・ルート全体を狙う削除だけは、このモードでも確認が求められる「サーキットブレーカー」として残ります。

✕ bypass permissionsとauto modeを混同しない

両方とも「確認が減る」点は同じですが、bypass permissionsには安全性判定が一切なく、Auto Modeには分類器によるチェックが常に働きます。公式ドキュメントも「bypass permissionsはプロンプトインジェクションや意図しない操作への保護を一切提供しない」と明記しています。「確認を減らしたい」だけならAuto Modeを検討してください。

常に保護される「protected paths」

bypassPermissionsモードを除くすべてのモードで、.git.claude.vscodeなどの設定ディレクトリや、.zshrc.npmrc.gitconfigなどの設定ファイルへの書き込みは自動承認されません。これはリポジトリの状態やClaude Code自身の設定が誤って壊れるのを防ぐための保護で、permissions.allowルールで個別に許可していても効きません(モードごとの扱いは下表の通りです)。

モードprotected pathsへの書き込み
default / acceptEdits / plan確認を求める
auto分類器が判定
don’t ask拒否
bypassPermissions許可

目的別の選び方まとめ

✓ 迷ったらこの基準で
  • 初めてのリポジトリ・重要な変更 → Manual(既定のまま)
  • 実装が固まっていて反復修正したい → acceptEdits
  • まず設計・調査だけしたい → Plan
  • 長時間タスクを任せたい・確認疲れを減らしたい → Auto(要件を満たしていれば)
  • CI・無人実行環境 → don’t ask
  • 使い捨てのコンテナ・VM内のみ → bypass permissions

迷ったら、まずShift+Tabで各モードを実際に切り替えて、ステータスバーの表示が変わる様子を確認してみてください。体感するのが一番早い理解の近道です。

よくある質問

Q. 「manual mode」と「auto mode」の違いを一言で言うと?

Manualは「毎回聞く」、Autoは「AIの安全性判定を挟みつつ基本的に聞かない」です。両者は権限モードのスペクトラムの両端に位置し、acceptEdits・Planはその中間的な選択肢にあたります。

Q. VS Codeやデスクトップアプリでもモード名は同じですか?

表示ラベルが異なります。VS Code拡張では「Manual」「Edit automatically」「Plan」「Auto」「Bypass permissions」という表示になり、それぞれCLIのdefaultacceptEditsplanautobypassPermissionsに対応します。挙動は同じです。

Q. モードはプロジェクトごとに記憶されますか?

デスクトップアプリのモードセレクターで選んだモードは、そのフォルダ単位で記憶され、settings.jsonのdefaultModeより優先されます(Planモードだけは例外で、そのセッション限りの適用です)。CLIの場合は起動時のフラグや設定ファイルのdefaultModeに従います。

Q. Auto Modeがサイクルに出てこないのですが?

アカウントがプラン・モデル・プロバイダーの利用条件を満たしていない可能性があります。Anthropic API・Bedrock・Vertex AI(Agent Platform)など提供元ごとに対応モデルが異なるため、プロバイダー別の有効化条件を確認してください。

まとめ

✓ この記事のポイント
  • 権限モードは6段階:Manual(既定)・acceptEdits・Plan・Auto・don’t ask・bypass permissions
  • CLIではShift+TabでManual→acceptEdits→Planをサイクル。Auto・bypassPermissionsは条件付きでサイクルに追加される
  • 「Manual」はAuto Modeの対義語にあたる、確認ありの標準モードの表示名(設定値はdefault
  • bypass permissionsは安全性判定なしの最終手段。確認を減らしたいだけならAuto Modeを検討する
  • protected pathsへの書き込みは、bypassPermissions以外のどのモードでも自動承認されない

まずはShift+Tabを押して、今自分がどのモードにいるかをステータスバーで確認してみてください。そこから、作業内容に合わせてモードを選ぶ習慣をつけるのがおすすめです。

タイトルとURLをコピーしました