Claude CodeのYOLOモードについてお探しですね。

広告

Claude Codeを使いこなすための「Planモード」と「YOLOモード」完全ガイド

Claude Codeは、ターミナル上で直接コードを編集・実行してくれる非常に強力なAIエージェントです。

でも、いざ使ってみると「勝手に関係ないファイルまで書き換えられて怖い思いをした」という人や、逆に「一つひとつのコマンドで承認を求められて全然進まない」と困っている人も多いんです。

この記事では、Claude Codeを安全に使いこなすための鍵となる「Planモード」と「YOLOモード」の違いを分かりやすく解説します。

この2つのモードをうまく使い分けられれば、危険を避けながら開発スピードをぐっと上げることができますよ。

「Planモード」と「YOLOモード」って何が違うの?

Claude Codeを思い通りに動かすには、まずAIの「考える」と「実行する」という2つのプロセスを分けて理解する必要があります。

多くの人がつまずくのは、この2つをごちゃ混ぜにしてAIに任せてしまうからなんです。

そこで重要になるのが、Claude Codeの権限管理モードの切り替え。

特に性質が真逆な「Planモード」と「YOLOモード」の違いを知っておくと、安全な自動化への第一歩が踏み出せます。

**Planモードは「読み取り専用の調査・計画モード」**です。

このモードでは、Claude Codeはファイルを読んだり、コード全体を検索して状況を把握したりはできますが、ファイルを編集したりコマンドを実行したりといった「システムを変更する操作」は一切できません。

あなたから与えられたタスクに対して、「どのファイルをどう修正すべきか」「どんな手順で進めるべきか」という設計書を作ることに専念します。

複雑な作業に取りかかる前に、AIの考えている方向性が自分の意図と合っているかを確認するための「安全地帯」みたいなものですね。

一方で**YOLOモード（Bypass Permissions）は、すべての権限チェックをスキップして、AIに完全な自律実行を許可するモード**です。

「You Only Live Once（人生一度きり＝やっちゃえ！）」の頭文字から名付けられた通り、起動時に「–dangerously-skip-permissions」オプションをつけることで発動します。

このモードのClaude Codeは、ファイルの作成から編集、コマンド実行まで、いちいち承認を求めずに最後まで一気にタスクを完了させようとします。

うまく使えば、あなたがコーヒーを淹れている間に面倒なリファクタリングを終わらせてくれる、最強の相棒になります。

YOLOモードが「危険」と言われる本当のワケ

圧倒的な生産性を誇るYOLOモードですが、公式のオプション名に「dangerously（危険に）」とついている通り、何も考えずに使うと大惨事を招く可能性があります。

その理由は、大規模言語モデル（LLM）が持つ「与えられたタスクを何が何でも前に進めようとする性質」にあります。

LLMは立ち止まって全体を見渡したり、空気を読んで既存のシステム構成を尊重したりすることは、明確に指示されない限りしません。

例えば、「新しい認証機能を追加して」という大雑把な指示を出したとします。

人間のエンジニアなら、既存のデータベース設計や互換性を考えながら慎重に作業しますよね。

でも、ルールが何も設定されていない状態でYOLOモードのAIに任せると、目的達成のために既存のセッション管理を根本から書き換えたり、勝手に「不要」と判断した処理を削除したりして、周りのコードを壊しながら突き進んでしまうことがあるんです。

さらに、エラーが出ればそれを解決しようと次々に新しいライブラリをインストールして、気づいたときにはプロジェクトの構造が原型をとどめていない…なんてことも。

こういった暴走は、AIが優秀じゃないから起こるわけじゃありません。

AIが判断するための「プロジェクト固有のルール」が伝えられていないことが原因なんです。

人間がいちいちチェックしないYOLOモードでは、AIの行動を制御するものがなければ、結果は文字通りギャンブルになってしまいます。

AIの自律実行による事故を防ぐには、正しく動けるような環境とルールを事前に用意しておく必要があるんですね。

安全に自動実行させるための「ガードレール」の作り方

YOLOモードの危険性を取り除いて、安心してタスクを丸投げするには、プロジェクト内に強固な「ガードレール」を設置する必要があります。

このガードレールとなるのが、Claude Codeに読み込ませる設定ファイルと、自動的に品質をチェックするツールです。

ガードレール1：「CLAUDE.md」と「Rules」で行動指針を明確にする

プロジェクトのルートディレクトリに置く「CLAUDE.md」には、使用技術や絶対に守るべき優先順位など、プロジェクトの基本情報を書きます。

さらに、セキュリティ規約、コーディングスタイル、テストの命名規則といった細かいルールは、「.claude/rules/」ディレクトリの中に個別のマークダウンファイルとして分けて定義します。

ファイルパスでスコープを設定すれば、AIが該当するファイルを編集するときだけ必要なルールが読み込まれるようになり、「やってはいけないこと（例：本番環境で危険な書き方をしない、など）」を確実にAIに守らせることができます。

ガードレール2：LinterやテストでAIの出力を自動チェック

どんなに丁寧にルールを書いても、複雑な作業の中でAIが指示を見落とすことはあります。

そこで、AIがルール違反のコードを書いた瞬間にLinterを走らせて、エラーとして弾く仕組みを用意しましょう。

AIは出力されたエラーメッセージを読み取って、自分のミスに気づいて修正します。

この「ルールによる事前制御」と「Linterによる事後検証」の二重構造があって初めて、YOLOモードはギャンブルから信頼できる自動運用に変わるんです。

効率が劇的に変わる！2つのモードの最適な使い分け方

ガードレールの準備ができたら、いよいよ実際の開発で2つのモードを組み合わせて使います。

AIの「思考」と「実行」を分離して、最も安全かつ効率的にタスクを進める黄金のワークフローはこんな感じです。

ステップ1：Planモードで設計と計画を作ってもらう

まずは読み取り専用のPlanモードでClaude Codeを起動して、「〇〇の機能を実装するための設計方針と作業手順を計画して」と指示します。

AIはコード全体を調べて、変更が必要なファイルと具体的な修正内容をリストアップしてくれます。

この段階ではシステムに一切変更が加えられないので、仮にAIの認識が間違っていても被害はゼロです。

ステップ2：人間が計画をレビューして軌道修正

AIが出してきた計画案に目を通して、自分の意図と合っているか、アーキテクチャのルールに反していないかを確認します。

もしズレがあれば、「その方針じゃなくて、既存の〇〇の仕組みを再利用する形で計画を修正して」とフィードバックします。

人間が介入して品質を担保するのは、この「計画の承認」のタイミングだけに絞るのがポイントです。

ステップ3：YOLOモードで完全自動実行

計画が完璧に仕上がったら、万が一に備えてGitでコミット（チェックポイントの作成）をした後、AIをYOLOモードで再起動します。

さっき作った計画書を参照させて、「この計画に沿って最後まで実装して、テストもパスさせて」と指示を出します。

あとはAIがルールとLinterの監視下で、黙々とコードを書いて、テストを走らせて、エラーを修正する工程を全自動で完了させてくれます。

まとめ

このように、Planモードで方向性を完全に固めてから、しっかりしたルールのもとでYOLOモードに実行を任せるという段階的なアプローチを取ることで、Claude Codeの本当の力を引き出すことができます。

設定の手間を惜しまず、AIが安全に走れる道幅を定義してあげれば、あなたの開発体験は劇的に変わるはずです。

ぜひ試してみてください！

広告