読み込み中

パーミッションモード

レッスン 45 分
読み込み中

パーミッションモード

パーミッションモードを使えば、Claudeに何を実行させてよいかを一度決めておくだけで、その都度確認のために作業を止める必要がなくなります。アクションを一つずつ承認していく代わりに、作業内容に合ったモードを選び、自分が安心できる信頼レベルでClaudeに作業させることができます。

これらのモードのうちいくつかはすでに目にしたことがあるはずです。shift-tabを押すたびに、manual(手動)、accept edits(編集を承認)、plan(計画)のモードを切り替えています。これらは日常的で、手作業が中心の作業をカバーします。残りのモードこそが、ハンズオフなClaude Codeの真価が発揮される場面であり、そこで頼りになるのがautoです。

6つのパーミッションモード

全体像は以下の通りです。各モードは、何が自由に実行され、何にあなたの承認が必要かについて、それぞれ異なる線引きをしています。

  • Manualは確認なしで読み取りのみを行います。それ以外はすべて先に確認を求めます。
  • Accept editsは読み取り、ファイル編集、一般的なファイルシステム関連のbashコマンドを確認なしで実行します。これは、事後にレビューするコードを反復して作成する際に使うものです。
  • Planは調査と変更の提案を行いますが、何も編集しません。読み取りは自由に実行され、autoモードが利用可能な場合は、auto用の分類器がClaudeが探索のために実行するコマンドを確認し、承認されたものは確認なしで実行できるようにします。
  • Autoはすべてを受け入れますが、別の分類器モデルがほとんどのアクションを実行前にレビューします。
  • Don't askは、作業ディレクトリ内でのファイル読み取りと、事前承認済みのツールを許可します。確認を求めるはずのものはすべて自動的に拒否されます。
  • Bypass permissionsはすべてのチェックをスキップします。これはdangerously-skip-permissionsフラグに相当します。隔離されたコンテナまたは仮想マシン内でのみ実行してください。

shift-tabによる切り替え

モードごとにコマンドを覚える必要はありません。shift-tabを押せば、日常的に使うモードであるmanual、accept edits、plan、autoを順に切り替えられます。画面下部のステータスバーには常に現在のモードが表示されるので、見るだけでClaudeに何が許可されているかが正確にわかります。

autoモードの仕組み

Autoはハンズオフなモードです。Claudeは自律的に動作しますが、ほとんどのアクションが実行される前に、別の分類器モデルがそれらをレビューします。この分類器が守っているのは意図です。あなたが実際に求めた範囲を超えてエスカレートする動きを見張っています。

ブロックするよう設計されている動作の例は次の通りです。

  • 本番環境へのデプロイやマイグレーション
  • 強制プッシュ、またはダウンロードしたコードをそのままシェルにパイプする行為
  • 機密データを外部のエンドポイントへ送信すること
  • セッション開始前から存在していたファイルを取り返しのつかない形で破壊すること

そして、日常的な作業は通過させます。プロジェクト内でのローカルな編集、ロックファイルからの依存関係のインストール、読み取り専用のリクエスト、そして作業中のリポジトリのどのブランチへのプッシュも、デフォルトブランチを含めて通過します。例外は、productionやgh-pagesのように、デプロイ先であることを示す名前が付けられた他のブランチです。そこへのプッシュについては、分類器が独自の基準で判断します。

分類器にできないこと

分類器がチェックするのは意図であり、正しさではありません。コードが実際に動作するかどうかまでは検証できません。そのため、Claudeに認証機能のリファクタリングを依頼し、その結果壊れた認証コードが書かれても、分類器はそれを通過させます。壊れていることと危険であることは別だからです。

だからこそ、autoモードにはテストを実行するstop hookを組み合わせます。この2つは連携して機能します。

  • autoモードは、Claudeが実行中に「しようとしていること」を監視します。
  • stop hookは、Claudeが完了した時点でコードが実際に動作することを確認します。

一方はほとんどのアクションの前に意図を守り、もう一方はその後に正しさを守ります。autoモードのガードレールはまだ発展途上なので、現在のブロックリストと許可リストについてはドキュメントを確認してください。

無人実行のためのDon't ask

Don't askは、確認プロンプトを承認する人が誰もいない場合、たとえばCIパイプライン、スケジュールされたジョブ、夜間のバッチ処理などで選ぶべき適切なモードです。Claudeは、作業ディレクトリ内でのファイル読み取りなど、Manualモードでも確認不要な操作に加え、事前承認済みのツールについても引き続き実行します。それ以外の、本来であれば確認を求めるはずのものはすべて自動的に拒否されます。それこそがこのモードの主眼です。パイプラインは、誰もいないところで承認を待ってハングすることなく、動き続けます。

作業内容にモードを合わせる

パーミッションモードはいくつかあり、shift-tabを切り替えることで日常的に使うモードにたどり着けます。まとめると次の通りです。

  • Autoはハンズオフなモードです。分類器がほとんどのアクションの前に意図をチェックし、stop hookがその後に正しさをチェックします。
  • Don't askは、承認する人が誰もいない無人のパイプラインをカバーします。
  • Bypass permissionsは、隔離されたコンテナとVM内でのみ使用します。

自分がしている作業に合ったモードを選び、そのレベルでClaudeを動かしてください。