権限モードを使い分ける(auto・manual・accept edits・plan)

Claude Code の「権限モード」は、ファイルの編集やコマンドの実行の前に、あなたに確認するかどうかを決める設定です。この記事では、4 つのモードの違いと切り替え方、plan モードで計画を確かめてから直す手順を、編集部の検証環境の画面で説明します。

権限モードとは

Claude Code は、ファイルを読む・ファイルを編集する・コマンド(ターミナルで動かす命令)を実行する、といった操作をしながら作業を進めます。どの操作を確認なしで進めてよいかは、権限モードで変わります。

よく使うモードは次の 4 つです。何も設定していなければ、auto モードで始まります。

作業フォルダ(作業ディレクトリ)は、Claude Code を起動したフォルダです。/add-dir で、ほかのフォルダを足すこともできます。manual は、設定のファイルでは default という名前です。VS Code の拡張機能では、accept edits が「Edit automatically」と表示されます。

いまのモードを確かめて、切り替える

いまの権限モードは、入力欄の下に表示されます。

manual モードで編集の確認が出たときに「Yes, and switch to accept edits」を選んでも、accept edits モードに切り替わります。確認の画面は、第 5 回のClaude Code にファイルを直してもらうで説明しています。

plan モードで、計画を確かめてから直す

plan モードでは、Claude Code がファイルを読んで調べ、進め方の計画を書きます。あなたが承認するまで、ファイルは変えません。変更の前に調べて、進め方を先に確かめたいときに使います。

編集部では、やることリストのアプリ(todo-app)の 2 つの不具合を、plan モードで直してもらいました。

auto モードのしくみと、確認が出るとき

auto モードでは、Claude Code が操作を実行する前に、別の AI(分類器)がその操作を確かめます。依頼の範囲を超える操作などは止められ、問題がなければ、あなたへの確認なしで進みます。

公式のドキュメントでは、次のような操作を既定で止めると説明されています(一部)。

• ダウンロードしたものをそのまま実行する操作(curl | bash など)
• 機密のデータを外に送る操作
• 本番の環境へのデプロイ(公開)やマイグレーション(データベースの構造の変更)
• Git の force push(リモートの履歴を強制的に書き換えるプッシュ)や、git reset --hard など、まだコミットしていない作業を捨てる操作
• 秘密の情報を画面に出す操作

反対に、作業フォルダの中のファイル操作や、作業中のリポジトリへのプッシュなどは、既定で通します。編集部の画面では、通った操作の下に「Allowed by auto mode classifier」(auto モードの分類器が許可した)と表示されました。

auto モードでも、あなたに確認が出ることがあります。編集部の環境では、Claude Code が見た目を確かめるために撮った画像(作業フォルダの外にある /tmp/shot/after.png)を読もうとしたときに、次の確認が出ました。

画面の説明によると、auto モードは、作業フォルダの外のファイルも確認なしで読みます。この確認では、今回の読み取りを許可するかどうかと、次からどうするかをまとめて選びます。

2 を選んだあとで元に戻すときは、自分の設定のファイルから permissions.blockReadsOutsideWorkingDirectories を消します(画面の説明より)。

始めるときのモードを決める

起動するときに、--permission-mode でモードを指定できます。次の例は、plan モードで始めます。

claude --permission-mode plan

指定できる値は default(manual のこと。manual とも書けます)・acceptEdits・plan・auto などです。

いつも同じモードで始めたいときは、自分の設定のファイル ~/.claude/settings.json の permissions.defaultMode に書きます。次の例は、いつも manual モードで始める設定です。

{
  "permissions": {
    "defaultMode": "default"
  }
}

ファイルがまだなければ作ります。ほかの設定がすでに書かれているときは、その中に permissions の部分を足します。JSON では、// のコメントや最後の項目のあとのカンマはエラーになります。

次の回では、CLAUDE.md にプロジェクトのルールを書いて、Claude Code に毎回読んでもらう方法を説明します。