2026年4月15日

Claude Code YOLOモード(--dangerously-skip-permissions)完全ガイド【2026年最新】:安全な使い方・5つの権限モード・Docker設定まで徹底解説

Claude Code YOLOモードとは?--dangerously-skip-permissionsを使いこなす完全ガイド【2026年最新】

室谷室谷代表取締役
今回はClaude CodeのYOLOモード、つまり--dangerously-skip-permissionsフラグについて話しましょう。これ、.AI(ドットエーアイ)コミュニティでも毎週のように質問が来るんですよね・・・
テキトー教師テキトー教師DotAI 認定講師
ですね。講座でコミュニティのメンバーさんに「YOLOモードって何ですか?」って聞かれると、毎回30分は話してしまいます(笑)。

危険という印象が先行しすぎていて、本当に使うべき場面が伝わっていないことが多い。
室谷室谷代表取締役
名前からして怖いんですよ。--dangerously-skip-permissionsって、「危険にも権限をスキップする」という意味ですから。

でもAnthropicがこの名前を意図的に選んだのには理由があって・・・
テキトー教師テキトー教師DotAI 認定講師
「無意識に使えないようにしてある」というのがポイントですよね。毎回この長いフラグを打ち込まないと有効にならない。

-yみたいな短縮形は存在しない。
室谷室谷代表取締役
そうなんですよ。意識的に選択しないと使えない設計になっている。

うちのMYUUUのエンジニアも最初は「怖くて使えない」って言ってたけど、適切な環境を整えたうえで使うと生産性が別次元になりますね。

YOLOモードとは何か:bypassPermissionsモードの仕組み

Claude Code公式ドキュメントのPermissionsページ:権限システムの全体像とbypassPermissionsモードの説明(公式サイトより)

テキトー教師テキトー教師DotAI 認定講師
まず基本から整理しますね。--dangerously-skip-permissionsフラグを付けてClaude Codeを起動すると、Anthropicが「bypassPermissionsモード」と呼ぶ状態になります。

このモードでは、Claudeが提案するすべてのアクションが確認なしに即実行されます。
室谷室谷代表取締役
通常だと、ファイルを書き換えるたびに「これ実行しますか?」って聞いてくるじゃないですか。10ファイルのリファクタリングをしたら30回以上承認を求めてくる。

あのクリックの積み重ねが地味にキツい。
テキトー教師テキトー教師DotAI 認定講師
飛び越えられるのは具体的に言うと、ファイルの編集・作成、Bashコマンドの実行、MCPツールの呼び出し、Web fetchのリクエスト、サブエージェントの起動、こういったものすべてです。

実際のコマンドはこうなります:

bash
# 基本的な使い方(headlessモード)
claude --dangerously-skip-permissions -p "認証モジュールをJWTに書き換えて"

# セッション名を付けて再開可能にする
claude --dangerously-skip-permissions --resume refactor-sprint "リファクタリングを続けて"

# CI/CDパイプラインに組み込む(JSON出力形式)
claude --dangerously-skip-permissions -p "lintエラーを全部直して" --output-format stream-json
室谷室谷代表取締役
-pフラグは非インタラクティブモードで、プロンプトを直接渡してそのまま実行します。これを--dangerously-skip-permissionsと組み合わせると、完全に人の手を離れた自動実行になる。
テキトー教師テキトー教師DotAI 認定講師
ここで大事なのが「何がスキップされて、何がスキップされないか」という点です。スキップされないものもちゃんとあります。
室谷室谷代表取締役
Claudeのコア安全トレーニング(明らかに有害な命令は拒否する)は変わらない。それに加えて、設定ファイルで指定したネットワーク制限、.git/や.claude/(一部を除く)、.vscode/、.idea/、.husky/へのWRITEは引き続き確認を求めます。
テキトー教師テキトー教師DotAI 認定講師
あとPreToolUseフックも依然として動作します。これを使えば「YOLOモード中でもこのコマンドだけはブロックする」という設定が可能です。

0か100かではないんですよね。

Claude Codeの5つの権限モード:YOLOは最終手段

室谷室谷代表取締役
YOLOモード一本に頼るのは、実は中級者の落とし穴なんですよ。Claude Codeには5つの権限モードがあって、YOLOはその最終手段に過ぎない。
テキトー教師テキトー教師DotAI 認定講師
整理すると、こういう構造です。
モードファイル編集BashコマンドMCPツール最適なユースケース
Default種類ごとに1回確認毎回確認毎回確認初心者・慣れないコードベース
Accept Edits自動承認毎回確認毎回確認日常開発・コード修正中心の作業
Plan Modeブロックブロックブロックコードレビュー・設計検討
Auto安全チェック後に自動承認安全チェック後に自動承認安全チェック後に自動承認普段の開発(リサーチプレビュー)
Don't Ask事前承認分のみ事前承認分のみ事前承認分のみロックダウン環境
bypassPermissions(YOLO)全自動全自動全自動CI/CD・Docker・信頼済みセッション

Claude Code 権限モード比較図:DefaultからYOLOまでの5つのモードと安全性のスペクトラム(公式サイトより)

室谷室谷代表取締役
大多数のケースはAccept Editsで十分なんですよね。Shift+Tabを押すだけで切り替えられる。

ファイル編集は自動承認でBashコマンドだけ確認、という使い方が現実的には一番バランスが良いと思っています。
テキトー教師テキトー教師DotAI 認定講師
受講生さんがよくやる間違いが「毎回確認が面倒だからYOLO一択」なんです。でも実際は、settings.jsonに許可ルールを書いておくだけで9割の場面は解決します。
室谷室谷代表取締役
そのsettings.jsonの権限設定、これが意外と知られていないんですよね。

settings.jsonで細かく制御する:YOLOより安全で速い方法

テキトー教師テキトー教師DotAI 認定講師
settings.jsonを使うと、特定のコマンドだけを自動承認にできます。「npm run系は全部OK、でもgit pushだけは確認」みたいな設定が可能です。

設定の例はこうなります:

json
{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(bun run *)",
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(git log *)",
      "Bash(git add *)",
      "Read",
      "Edit(/src/**)",
      "Edit(/tests/**)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(sudo *)",
      "Bash(curl *)",
      "Read(./.env*)",
      "Read(./secrets/**)",
      "Edit(./.env*)"
    ],
    "ask": [
      "Bash(git push *)",
      "Bash(git commit *)",
      "Edit(/package.json)"
    ]
  }
}
室谷室谷代表取締役
この設定、MYUUUのプロジェクトでも近いものを使ってます。allow、deny、askの3階層で制御できる。

評価順はdeny→ask→allowで、最初にマッチしたルールが優先されます。
テキトー教師テキトー教師DotAI 認定講師
ルールの書き方のポイントをいくつか。Bash(npm run *)のように書くと「npm run」で始まるすべてのコマンドに適用されます。

*はワイルドカードで、スペース後の*は単語境界を守ります。つまりBash(ls *)はls -laにマッチしますが、lsofにはマッチしないです。
室谷室谷代表取締役
ここが微妙なところで、シェルオペレーター(&&や||)も認識してくれる。Bash(safe-cmd *)という許可ルールがあっても、safe-cmd && dangerous-cmdのような組み合わせはブロックします。
テキトー教師テキトー教師DotAI 認定講師
セッションをまたいだデフォルトモードの設定もできます。
json
{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

これをプロジェクトの.claude/settings.jsonに書いておけば、そのプロジェクトを開くたびにAccept Editsモードで起動します。

室谷室谷代表取締役
設定ファイルには優先順位もあって、マネージド設定(IT部門が配布)→CLIフラグ→ローカルプロジェクト設定→共有プロジェクト設定→ユーザー設定、という順で上が優先されます。
テキトー教師テキトー教師DotAI 認定講師
チームで使う場合、.claude/settings.jsonをgitにコミットしておくと、チーム全員が同じ権限設定で動けます。これ、講座でも強調しているポイントです。

auto modeとの違い:2026年に整理されたYOLOの立ち位置

室谷室谷代表取締役
このポストで書いた通り、auto modeが来てからYOLOモードを使う理由の半分は解消されました。auto modeとYOLOモードは別物として捉えた方がいいんですよね。
テキトー教師テキトー教師DotAI 認定講師
auto modeとYOLOモードの違い、整理しておきましょう。
比較軸auto modeYOLOモード(bypassPermissions)
有効化方法Shift+Tab(対話式)--dangerously-skip-permissionsフラグ
安全チェックバックグラウンドで動作するスキップ
対話性インタラクティブに確認できる完全自律実行
向いている場面普段の開発作業CI/CD・コンテナ内の自動化
安全境界Claudeのチェッカー実行環境(コンテナ等)
室谷室谷代表取締役
auto modeのcheckは「大量ファイル削除」「機密データ流出」「悪意あるコード実行」を検知してブロックする仕組みです。YOLOはそれも含めて全部スキップする。
テキトー教師テキトー教師DotAI 認定講師
「auto modeでほぼ解決するのでは?」という声もありますよね。実際、普段の開発はauto modeで十分なことが多い。

YOLOを使うのは、コンテナやCI/CDなど環境自体がセキュリティを担保している場面に限定するのが理想的です。
室谷室谷代表取締役
そうですね。auto modeが来て「YOLOの使いどころ」がより明確になった感じがします。

YOLOモードが本当に必要な場面とは

室谷室谷代表取締役
では実際にYOLOモードが必要な場面を具体的に見ていきましょう。
テキトー教師テキトー教師DotAI 認定講師
auto modeが来てからYOLOモードを使う理由の半分は解消されました。でも残り半分——CI/CDとDockerを中心とした完全自動化ワークフロー——はYOLOモードでないと実現できないんですよね。
テキトー教師テキトー教師DotAI 認定講師
具体的に言うと、こういったユースケースです。
  • コンテナ内での大規模リファクタリング: 数十ファイルにまたがる変更を一気に処理したいとき
  • CI/CDパイプラインでの自動修正: PRのlintエラーやテスト失敗を自動で修正するワークフロー
  • テスト駆動開発のループ: 失敗するテストを書いて、通過するまでClaude自身がイテレーション
  • 大量ファイルの一括変換: APIのバージョン移行やフレームワーク置き換えなど
室谷室谷代表取締役
Anthropicのサーフェガードチームのエンジニアが16並列エージェントでRustベースのCコンパイラを書いたという話があって。その人のブログに「コンテナで実行してください、実際のマシンではなく」と一言書いてあった。

作った人たちが同じことを言ってるんですよね。
テキトー教師テキトー教師DotAI 認定講師
コンテナ内なら権限プロンプトはただの摩擦です。コンテナ境界がセキュリティを担保しているので、追加確認は不要になる。

Dockerを使ったセーフYOLOの構成

室谷室谷代表取締役
実際のDocker設定を見てみましょう。Anthropicが推奨するdevcontainerの考え方を元にした構成です。
dockerfile
FROM node:20-slim

# Claude Codeをインストール
RUN npm install -g @anthropic-ai/claude-code

# 作業ディレクトリをセット
WORKDIR /workspace

CMD ["bash"]

実行はこう:

bash
docker run --rm \
  -v $(pwd):/workspace \
  --network none \
  -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
  my-claude-container \
  claude --dangerously-skip-permissions -p "全ファイルのlintエラーを修正して"
テキトー教師テキトー教師DotAI 認定講師
--network noneが重要で、外部ネットワーク通信を完全に遮断します。--rmで実行後にコンテナを削除する。

この2つで「使い捨てで閉じた環境」が作れます。
室谷室谷代表取締役
あとgitのチェックポイント。YOLOを有効にする前に必ずgit commitかgit stashで状態を保存しておく。

何か問題があってもgit reset --hardで元に戻せる。gitが安全網の役割を担うわけです。
テキトー教師テキトー教師DotAI 認定講師
Docker + gitチェックポイント + denyルール。この3点セットが、YOLOモードを使うときのコミュニティのコンセンサスになっています。

GitHub ActionsでのCI/CD活用

室谷室谷代表取締役
GitHub Actionsへの組み込み例も見ておきましょう。
yaml
name: Claude Code Auto-Fix

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  claude-fix:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
        
      - name: Run Claude Code
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude --dangerously-skip-permissions \
            -p "lintエラーを全部修正して、テストが通るまでイテレーションして" \
            --output-format stream-json
テキトー教師テキトー教師DotAI 認定講師
GitHub Actionsのランナーはそれぞれ独立したVMで動くので、コンテナと同様に分離されています。ANTHROPICのAPIキーはSecretsで管理して、絶対にコードに直書きしない。
室谷室谷代表取締役
--output-format stream-jsonを指定しておくと、Claudeが何をしているかをパイプラインのログで追えます。後でデバッグするときに助かります。

実際に起きた事故と教訓

テキトー教師テキトー教師DotAI 認定講師
怖い話もしないといけないですよね。コミュニティで大きな話題になった事故があります。
室谷室谷代表取締役
2025年末にユーザーが「古いリポジトリのパッケージを整理して」と指示したら、Claudeがrm -rf tests/ patches/ plan/ ~/を実行してしまったケースです。末尾の~/がシェルによってホームディレクトリに展開されて、Desktopのファイルもパスワードマネージャーのデータも全部消えた・・・
テキトー教師テキトー教師DotAI 認定講師
Simon WillisonさんがこれをXで取り上げて、Hacker Newsで大反響になりましたね。
室谷室谷代表取締役
YOLO単体の問題というより「gitのチェックポイントなし」「コンテナなし」「denyルールなし」という三重の無防備状態だったのが問題で。
テキトー教師テキトー教師DotAI 認定講師
防ぎ方は明確です。settings.jsonに"deny": ["Bash(rm -rf *)"]を書く。

gitに作業状態をコミットしてからYOLOを使う。コンテナ内で実行する。

この3点さえ守れば、防げた事故です。
室谷室谷代表取締役
怖い話ではあるんですが、同時に「安全に使う方法は確立されている」という話でもあるんですよね。事故の原因が明確だから対策も明確。

YOLOモードを使うときの5つのチェックリスト

テキトー教師テキトー教師DotAI 認定講師
まとめとして、使う前に確認すべきチェックリストです。
  • コンテナまたは分離された環境の中で実行しているか
  • gitで作業前の状態をコミット済みか
  • settings.jsonで危険なコマンドをdenyに入れているか(Bash(rm -rf *)、Bash(sudo *) 等)
  • 本番のAPIキーや秘密情報がその環境に存在しないか
  • ネットワークの外部通信が必要最低限に制限されているか
室谷室谷代表取締役
5点全部Yesなら、YOLOモードは十分安全に使えます。1つでもNoなら、まず環境を整えることを優先してください。
テキトー教師テキトー教師DotAI 認定講師
Accept Editsモードや細かいsettings.jsonの設定で解決できるケースも多いので、「とりあえずYOLO」ではなく適切なモードを選ぶ習慣をつけることが大事だと思います。

YOLOモードが輝く実践的なワークフロー3選

室谷室谷代表取締役
ユースケースを具体的に3つ紹介しましょう。MYUUUで実際に使っているものも含めて。

1. テスト駆動開発ループ

テキトー教師テキトー教師DotAI 認定講師
Anthropicが公式に推奨しているパターンで、テスト駆動開発との相性が抜群です。
bash
# ステップ1: まずテストを書かせる
claude --dangerously-skip-permissions -p "このAPIエンドポイントの失敗するテストを書いて"

# ステップ2: テストをコミット
git add . && git commit -m "failing tests"

# ステップ3: テストが全部通るまでClaudeに任せる
claude --dangerously-skip-permissions -p "全テストが通るまで修正を続けて。完了したら教えて"
室谷室谷代表取締役
このパターン、夜に走らせて翌朝確認するという使い方が最高です。gitにコミットしてから走らせるから、朝起きて気に入らなければgit reset --hardで戻せる。
テキトー教師テキトー教師DotAI 認定講師
受講生さんで「1泊でAPIの実装が完成した」って報告してくれた方がいましたね。失敗するテストを夜に定義して、朝見たら全テスト通っていたと。

2. 大規模リファクタリングのバッチ処理

室谷室谷代表取締役
数十ファイルにまたがる変更もYOLOモードの得意領域です。MYUUUでも古いAPIクライアントをリライトするときに使いました。
bash
# 事前にブランチを切ってコミット
git checkout -b refactor/v2-api-migration
git commit -am "before: v1 API client"

# コンテナ内でバッチ実行
docker run --rm \
  -v $(pwd):/workspace \
  -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
  my-claude-container \
  claude --dangerously-skip-permissions -p \
    "全ファイルのv1 API呼び出しをv2形式に移行して。src/配下を全部チェックして"
テキトー教師テキトー教師DotAI 認定講師
このパターンのポイントは「スコープを明示する」こと。src/配下とかtests/配下とか、どのディレクトリを対象にするか最初に伝えておく。
室谷室谷代表取締役
そうしないと想定外のファイルまで触られることがあるので・・・

3. マルチリポジトリレポート生成

テキトー教師テキトー教師DotAI 認定講師
複数のリポジトリをまたいで情報を集約するレポート生成も、YOLOモードがないとできないパターンです。
室谷室谷代表取締役
例えば「先週の全リポジトリのコミット履歴を読んで、機能別に分類したサマリーを作って」みたいな指示。手作業だと2〜3時間かかる作業が、YOLOモードを使えば数分で終わります。
テキトー教師テキトー教師DotAI 認定講師
ログ・コミット履歴・Issueをまたいで分析するような定型業務は、CI/CDスケジュールに組み込んでおくと週次レポートが自動生成できます。これ、経営的にもかなり価値がありますよね。
室谷室谷代表取締役
「AIが仕事をするにはYOLOモードみたいな自律性が必要」という話で、理想と現実のバランスをとる仕組みがclaude code yoloの仕組みだと思っています。

企業・チームでYOLOモードを管理する方法

テキトー教師テキトー教師DotAI 認定講師
チームや組織でClaude Codeを展開しているケースも増えてきていますね。その場合、個人でYOLOモードを勝手に使われると困ることもある。
室谷室谷代表取締役
マネージド設定を使えば、組織全体でYOLOモードを無効化できます。
json
{
  "permissions": {
    "disableBypassPermissionsMode": "disable"
  }
}
テキトー教師テキトー教師DotAI 認定講師
これをITが管理するmanaged-settings.jsonに書くと、ユーザーの設定では上書きできなくなります。「絶対にYOLOモードを使わせたくない」組織向けのオプションですね。
室谷室谷代表取締役
逆に「開発環境では使っていいがステージングや本番ではダメ」という使い分けも、環境ごとに異なる設定ファイルを配布することで実現できます。
テキトー教師テキトー教師DotAI 認定講師
Claude Code EnterpriseとTeamプランでは、こういった細かい権限管理のサポートが充実しています。大規模展開を考えているならClaude Code EnterpriseとTeamプランの詳細も参考になります。

よくある質問(FAQ)

YOLOモードとauto modeの違いは?

室谷室谷代表取締役
いちばん多い質問ですね。auto modeはShift+Tabで切り替える対話型のモードで、バックグラウンドで安全チェッカーが走ります。

YOLO(bypassPermissions)はそのチェッカーもスキップする完全自律モードです。
テキトー教師テキトー教師DotAI 認定講師
auto modeは普段の開発に、YOLOはCI/CDや完全自動化シナリオに向いています。セキュリティのレベルが異なるので、目的に合ったモードを選ぶことが大事です。

settings.jsonにdefaultMode: bypassPermissionsと書くのとフラグは同じ?

テキトー教師テキトー教師DotAI 認定講師
機能的には同じです。ただ、フラグの場合はそのセッションだけ有効なのに対して、settings.jsonに書くと毎回そのモードで起動します。
室谷室谷代表取締役
セキュリティ観点から言うと、フラグを毎回打つ方が意識的な選択になるので、個人的にはフラグ形式を推奨しています。settings.jsonに書くのは、CI/CD環境など完全に制御された環境向けです。

セッション途中でYOLOモードに切り替えられる?

テキトー教師テキトー教師DotAI 認定講師
現在のバージョンでは、--dangerously-skip-permissionsフラグは起動時に指定する必要があります。セッション途中でYOLOモードに切り替えることはできないので、再起動が必要です。
室谷室谷代表取締役
これはGitHub Issueで「セッション中に切り替えられるようにしてほしい」という要望も上がっているんですが、現時点では対応されていないですね。

まとめ:YOLOモードは環境ありきで考える

室谷室谷代表取締役
まとめると、--dangerously-skip-permissionsは「環境の安全性があって初めて使えるモード」です。フラグ自体を恐れる必要はないですが、適切な環境なしに使うのは確かに危険。
テキトー教師テキトー教師DotAI 認定講師
受講生さんへのアドバイスとして言うなら、まずsettings.jsonの権限設定を覚えること。次にAccept Editsモードを使いこなすこと。

YOLOはその先の話です。
室谷室谷代表取締役
海外のコミュニティでも「Docker + gitチェックポイント + denyルール」がセットというのが共通認識になっています。この3点セットさえ守れば、YOLOモードは生産性を別次元に引き上げる強力なツールになります。
テキトー教師テキトー教師DotAI 認定講師
次回はClaude Codeのhooks機能と組み合わせた権限制御を深掘りしていきましょう。あのPreToolUseフックとYOLOモードの組み合わせが、中上級者向けの使い方としていちばん実用的ですし。
室谷室谷代表取締役
そうですね。では今回はここまでです。

あわせて読みたい

Related

関連記事

New Articles

新着記事

ガイド

Fish Audioの料金と無料で使える範囲、商用利用の条件をまとめて解説

2026年10月8日
室谷テキトー教師
ガイド

Geminiのログイン方法と料金プラン、Bardからの変更点をやさしく整理

2026年10月8日
室谷テキトー教師
ガイド

Hailuo AIとは?無料でできることと料金・使い方を解説

2026年10月8日
室谷テキトー教師
ガイド

Grammarlyの文法チェックは無料でどこまで使える?Pro料金とQuillbot比較

2026年10月8日
室谷テキトー教師
ガイド

Kimi K3とは?2.8兆パラメータの実力と料金プラン変更の現在地

2026年10月8日
室谷テキトー教師
ニュース

MAI-Code-1.1-Flashとは?Microsoftの小型コーディングモデルがオンデバイス対応

2026年10月8日
室谷テキトー教師
ガイド

Gensparkとは?できること・料金・注意点を2026年7月時点の情報で整理

2026年10月8日
室谷テキトー教師
ニュース

OpenAIの「GPT-6」とは?Intelligent UIを全ユーザーに展開

2026年10月8日
室谷テキトー教師
ニュース

Anthropicの「Claude Haiku 5.5」とは?最安・最速の小型モデルを解説

2026年10月8日
室谷テキトー教師
ガイド

OpenAI APIの使い方|APIキー取得から料金・レート制限まで

2026年10月8日
室谷テキトー教師

Join

AIプレナーになる。

入会は審査制です。いまの事業と、AIで何を動かしたいのかを聞かせてください。

参加を申請する