🤖

Claude Codeの3つのモード完全ガイド|初心者が知るべき使い分けと実践的ワークフロー

に公開

はじめに

Claude Codeを使い始めて最初に戸惑うのが、「モードって何?」「どう使い分ければいいの?」という疑問じゃないでしょうか。

実は、Claude Codeには3つのモードがあって、それぞれ役割が違います。この使い分けを理解すると、安全かつ効率的にコーディングできるようになるんですよね。

この記事では、各モードの仕様を詳しく解説しつつ、「こういう時はこのモード」という実践的な使い分け方を紹介します。Claude Codeを使い始めたばかりの方は、ぜひ参考にしてください。

Claude Codeの3つのモードとは?

Claude Codeには、以下の3つのモードがあります。

  1. Ask before edits: 編集前確認モード - デフォルトの安全モード
  2. Edit automatically: 自動編集モード - ファイル編集を自動承認するモード
  3. Plan mode: 実装プラン作成モード - 実装プランを先に作成するモード

それぞれ、Shift+Tabキーで切り替えることができます。ただし、Plan modeだけはShift+Tabを2回押す必要があるので注意です。

各モードの詳細解説

1. Ask before edits: 編集前確認モード

特徴

  • Claude Codeのデフォルトモード
  • ファイルを編集するたびに確認を求められる
  • すべての変更を手動で承認する必要がある

いつ使う?

  • 初めて触るコードベース
  • 重要なファイルを変更する時
  • 慎重に作業を進めたい時
  • Claude Codeに慣れていない時

メリット

  • 一番安全(意図しない変更を防げる)
  • 各ステップを確認しながら進められる
  • 学習段階では「Claudeが何をしようとしているか」が分かる

デメリット

  • 確認の手間がかかる
  • 連続作業では効率が悪い
  • 小さな変更でも毎回止まる

2. Edit automatically: 自動編集モード

操作方法
Shift+Tabを1回押すと切り替わります。
もう一度押すとAsk before editsに戻ります。

特徴

  • ファイル編集を自動的に承認
  • コマンド実行やMCPツールは依然として確認が必要
  • ファイル変更のみをスキップする

いつ使う?

  • 既に方針が決まった実装作業
  • テストコードの追加
  • リファクタリングの実行
  • 同じパターンの修正を複数ファイルに適用する時

メリット

  • 作業効率が大幅に向上
  • 信頼できる範囲の作業をスムーズに進められる
  • いつでもShift+TabでAsk before editsに戻せる

デメリット

  • 意図しない変更に気づきにくい
  • Git管理していないと危険
  • 慣れないと不安を感じる

実際の使用例

例:既存の関数に型定義を追加する作業

Ask before edits:
1. 関数Aの変更確認 → 承認
2. 関数Bの変更確認 → 承認
3. 関数Cの変更確認 → 承認
(面倒...)

Edit automatically:
Claudeに「すべての関数に型定義を追加して」と指示
→ 自動で全ファイルを編集(確認不要)
→ 最後にdiffで確認すればOK

3. Plan mode: 実装プラン作成モード

操作方法:
Shift+Tabを2回素早く押すと起動します。
解除するにはもう一度Shift+Tabを押します。

特徴

  • まず実装プランだけを作成(ファイルに触らない)
  • プランを確認・承認してから実行に移る
  • "読み取り専用"状態で分析・計画に専念

いつ使う?

  • 複雑な機能追加
  • 大規模なリファクタリング
  • アプローチを確認してから実行したい時
  • プロジェクトの初期段階

メリット

  • 実装前に全体像を把握できる
  • アプローチが適切か判断できる
  • 失敗のリスクを減らせる
  • "think hard"や"ultrathink"と組み合わせると深い分析が可能

デメリット

  • プラン作成に時間がかかる
  • 小さな変更には不向き
  • プラン承認後、自動的にEdit automaticallyになる仕様(賛否両論)

実際の使用例

例:新しいログイン機能を追加する

1. Plan modeを起動(Shift+Tab 2回)
2. 「ログイン機能を追加して。think hardで計画を立てて」
3. Claudeが以下のようなプランを提示:
   - Step 1: 認証用のAPIエンドポイント作成
   - Step 2: フロントエンドのログインフォーム実装
   - Step 3: セッション管理の実装
   - Step 4: テストコード追加
4. プランを確認してOKなら承認
5. 自動的に実装が開始される

実際の使い分け:シーン別ガイド

シーン1:初めてのコードベースを触る

推奨モード:Ask before edits

理由

  • どんな構造か分からない段階では慎重に
  • Claudeの変更内容を一つずつ確認して学習
  • 意図しない破壊的変更を防ぐ

シーン2:既存コードのバグ修正

推奨モード:Ask before edits → Edit automatically

ワークフロー

  1. Ask before editsでバグの原因を調査
  2. 修正方針が決まったらEdit automaticallyに切り替え
  3. 修正を実行
  4. テストで動作確認

シーン3:新機能の追加(複雑)

推奨モード:Plan mode

ワークフロー

  1. Plan modeで全体設計を確認
  2. プラン承認後に実装
  3. 動作確認してコミット

具体例

例:ユーザープロフィール編集機能

1. Plan mode起動
2. 「ユーザープロフィール編集機能を追加。
   ultrathinkで詳細な計画を立てて」
3. Claudeが以下を提示:
   - データベーススキーマ変更の必要性
   - 必要なAPIエンドポイント
   - フロントエンドのコンポーネント構成
   - セキュリティ考慮事項
4. プラン確認後、実装開始

シーン4:テストコード追加

推奨モード:Edit automatically

理由

  • テストコードは比較的安全
  • 既存コードを壊すリスクが低い
  • 大量のテストを一気に追加できる

シーン5:リファクタリング

推奨モード:Plan mode → Edit automatically

ワークフロー

  1. Plan modeでリファクタリング計画を確認
  2. 影響範囲を把握
  3. 承認後、Edit automaticallyで実行
  4. テストで動作確認

実用的なワークフロー例

推奨ワークフロー:小さく回す

1. Plan modeで30分以内に完了する機能を計画
2. プラン承認後、Edit automaticallyで実装
3. 動作確認
4. Gitにコミット
5. 次の機能へ

なぜ30分以内?

  • スコープを小さく保つ
  • 問題が起きても影響範囲が限定的
  • コンテキストを失いにくい
  • 頻繁にコミットできる

マルチタスクワークフロー(上級者向け)

セッション1(Plan mode)
次の機能の計画を立てる

セッション2(Edit automatically)
前回計画した機能を実装中

このサイクルを並行で回すと効率的

よくある疑問・注意点

Q1:Shift+Tabを押す回数がよく分からなくなる

A: 画面下部に現在のモードが表示されます。確認しながら切り替えましょう。

Ask before edits → Shift+Tab(1回) → Edit automatically
Edit automatically → Shift+Tab(1回) → Plan mode
Plan mode → Shift+Tab(1回) → Ask before edits

Q2:Plan mode終了後、勝手にEdit automaticallyになるのが怖い

A: これは仕様です(2025年1月時点)。Plan mode承認時に明示的に選択肢が出ますが、基本的に自動実行モードになります。

対策

  • 重要な変更の場合、Plan承認後すぐにShift+TabでAsk before editsに戻す
  • Gitで細かくコミットしておく
  • 最悪rollbackできる準備をしておく

Q3:Edit automaticallyで意図しない変更が入ったらどうする?

A: 以下の対処法があります

  1. Escapeキーで中断

    • 実行中ならEscapeで止められる
    • コンテキストは保持される
  2. "undo"コマンド

    • 直前の変更を戻せる
    • Cursorのcheckpoint機能に似てる
  3. Gitでrevert

    • 最終手段だが確実
    • こまめにコミットしておくべき理由

Q4:どのモードが一番おすすめ?

A: 状況次第ですが、初心者なら

  1. 最初はAsk before editsでClaudeの動きを学ぶ
  2. 慣れてきたらEdit automaticallyで効率化
  3. 複雑な機能を追加する時だけPlan mode

この順番で使いこなしていくと良いですね。

Q5:モード切り替えのタイミングは?

A: 作業中でも自由に切り替えられます。

例

1. Plan modeで計画立案
2. 途中で「この部分だけ先に実装したい」
3. Shift+TabでAsk before editsに切り替え
4. 特定の部分だけ実装
5. また Plan modeに戻って続きを計画

柔軟に使い分けるのがコツです。

まとめ

Claude Codeの3つのモードは、それぞれ明確な役割があります。

モード 起動方法 主な用途 安全性 効率性
Ask before edits デフォルト 慎重な作業・学習 ⭐⭐⭐ ⭐
Edit automatically Shift+Tab(1回) 信頼できる範囲の実装 ⭐⭐ ⭐⭐⭐
Plan mode Shift+Tab(2回) 複雑な機能の計画 ⭐⭐⭐ ⭐⭐

初心者へのアドバイス

  1. 最初はAsk before editsでClaudeの動きを理解する
  2. Gitで頻繁にコミット(どのモードでも必須)
  3. Plan modeは"think hard"や"ultrathink"と組み合わせる
  4. 小さなスコープ(30分以内)で作業を回す
  5. 不安ならすぐにAsk before editsに戻す

最も重要なこと

どのモードを使っても、Gitで管理しておくことが最大の安全策です。いつでもロールバックできる状態を保ちましょう。

Claude Codeは強力なツールですが、モードの使い分けを理解すると、さらに安全かつ効率的に使えるようになります。ぜひ、この記事を参考に、自分に合ったワークフローを見つけてください!


参考リンク

Discussion