Claude Codeシリーズチュートリアル4：Claude Codeの使用シーンとは？

典型的な使用シーン

使用シーンを4つに分類し、頻度の高い順に並べています。

第1類：コードの理解

これはおそらく最もよく使われるものです。他人のプロジェクトを引き継いだり、古いモジュールを見たり、ドキュメントのないリポジトリを開いたりしたときに、直接質問します。

具体的な方法：

claude "このプロジェクトは何をするものですか？エントリポイントはどこですか？"——package.json、ディレクトリ構造、重要なファイルを読み、概要を提供します。
関数を開き、ロジックを説明させたり、フローを図示させたりします（テキストで）。
APIリクエストがフロントエンドからデータベースに至るまでの完全なパスを追跡させます。

ここで行っているのは、本質的には「コードを読む雑用」を手伝ってもらうことです。自分でgrepを何度も行い、頭の中でパズルを組み立てる必要はありません。Claudeがパスを整理し、あなたが判断します。

この類のシーンで代替されるものは、コードベースを手動で検索・メモ・呼び出しグラフを作成することです。

第2類：コードの記述・修正

これは最も議論される類ですが、実際には最も多く使われるわけではありません。コードを書くシーンは通常次のようになります：

新機能の生成：「userモジュールにメールアドレス変更用のインターフェースを追加し、メール形式を検証し、単体テストを書いてください。」
ファイルをまたがるリファクタリング：「これら3つのファイル内のすべてのmoment()をdayjs()に置き換えてください。他のロジックは変更しないでください。」
移行とアップグレード：「このVue 2コンポーネントをVue 3 Composition APIスタイルに書き換えてください。」

生成されるコードが一回で正しいとは限りませんが、ファイルをまたがる変更を一度にすべて実行でき、ファイルごとにdiffを確認して受け入れ・拒否ができます。

この類のシーンで代替されるものは、反復的なコードの手動記述、ファイルをまたがる参照の手動検索・置換です。

第3類：デバッグと修正

バグが発生した場合の一般的なワークフローは、エラーを見て、ファイルを特定し、原因を推測し、修正を試し、うまくいかなければ戻って確認する、というものです。Claude Codeはエラースタック全体を受け取り、プロジェクトコードと組み合わせて自己定位できます。

典型的な使い方：

失敗したテストの出力を渡すと、関連コードを読み、修正案を提示し、修正後にテストを再実行して合格するか確認します。
CIエラーが発生したら、ログを貼り付け、修正させ、修正後にgit diffで変更を確認します。

ここでの役割は、どちらかというと「一次調査員」です。考えるのはあなたですが、ファイルを調べたり、差分を比較したり、検証コマンドを実行するのはClaudeです。

この類のシーンで代替されるものは、テストの繰り返し実行、エラーログの読み込み、コード差分の手動比較です。

第4類：その他の自動化

この類のシーンは最も目立ちませんが、積み重なると最も時間を節約できます。

例：

Gitコミットメッセージの作成：claude "現在のgit diffに基づいてConventional Commits形式のコミットメッセージを作成してください"
PR説明の生成：現在のブランチとmainの差分を比較させ、今回の変更の概要とテスト説明を生成させます。
リリースノートの作成：Claude Codeに直近1週間のコミット履歴を読み取らせ、CHANGELOGを生成させます。
環境問題の解決：「この依存関係のインストールでエラーが出ました。ターミナル出力を見て原因を調べてください。」

これらの共通点は、複雑ではないが煩雑であることです。自分でやるにはウィンドウを切り替えたり多くの入力を要しますが、Claudeに任せれば数秒で完了します。

この類のシーンで代替されるものは、テキストの手動編集、規範的なドキュメントの作成、環境設定の問題の検索です。

一枚の「地図」

これら4つの類を日常のワークフローに当てはめると、次のような地図になります：

見慣れないプロジェクトを入手
    │
    ▼
[コードの理解] ─── 構造、エントリポイント、重要なロジックを把握
    │
    ▼
新機能の作成やモジュールの修正を開始
    │
    ▼
[コードの記述・修正] ─── 実装の生成、ファイルをまたがるリファクタリング
    │
    ▼
テストを実行し、バグが発生
    │
    ▼
[デバッグと修正] ─── エラーの分析、特定、修正、再実行
    │
    ▼
コミットの準備
    │
    ▼
[その他の自動化] ─── コミットメッセージ、PR説明、リリースノートの作成
    │
    ▼
コミットして完了

この4つの領域すべてを使う必要はありません。コードの理解だけを使うチームもいれば、テスト作成やPR発行だけを使う人もいます。最も悩まされている部分から始めてください。

2つの判断基準

Claude Codeに任せるべきかどうか迷ったときは、次の2つの質問を自分に問いかけてみてください：

1. これは「機械的」な作業で「創造的」な作業ではないですか？

100箇所の参照修正、フォーマットされた出力の生成、ボイラープレートコードの作成——これらを自分で行うと時間がかかりますが、考え方はすでにできています。Claudeに任せるのに適しています。

2. この作業の「検証コスト」は高くありませんか？

修正が何度もジャンプ、テストの実行、ログの確認を必要とする場合、人間が試行錯誤するのは遅くなります。Claude Codeは「修正→実行→確認→再修正」のサイクルを自分で完了できるため、負担が大幅に軽減されます。