Chapter 3: ユースケース大全 ── 開発・自動化・チーム活用

2026/04/26

Chapter 3: ユースケース大全 ── 開発・自動化・チーム活用

Claude Codeは「AIアシスタントにコードを書いてもらう」ツールではない。それはむしろ、開発ワークフロー全体を再設計するプラットフォームだ。本章では、日常的なコーディング支援から自動化、QA、そしてエンタープライズ規模のチーム活用まで、実際の現場で機能するユースケースを体系的に紹介する。

Category 1: 日常の開発ワークフロー

開発者がClaude Codeを使い始めてまず気づくのは、「ファイルをまたいだ変更が自然に動く」という点だ。従来のAIコーディングツールは単一ファイルの補完に留まることが多かったが、Claude Codeはプロジェクト全体を把握した上で、複数ファイルにまたがる整合性のある変更を実施できる。

機能実装：複数ファイルをまたぐ変更

たとえば、既存のECサイトに「クーポンコード適用機能」を追加するケースを考えよう。この変更は必然的に複数の層に影響する。

「クーポンコード機能を追加してください。
- CouponServiceクラスを新規作成（割引計算ロジック）
- CartServiceの合計計算でCouponServiceを呼ぶ
- APIエンドポイント /api/cart/apply-coupon を追加
- フロントエンドのCartコンポーネントにクーポン入力欄を追加
- 対応するユニットテストも一緒に書いてください」

このプロンプト一つで、Claude Codeは services/CouponService.ts、services/CartService.ts、api/routes/cart.ts、components/Cart.tsx、そして各テストファイルを同時に生成・編集する。重要なのは、型定義の整合性やインポートパスの正確さも自動で維持される点だ。手作業なら数時間かかる「ファイル間の繋ぎ込み作業」が数分で完了する。

バグ修正：エラーログを貼り付けて対話する

バグ修正の場合、最もシンプルかつ効果的なアプローチはエラーログをそのまま貼り付けることだ。

以下のエラーが本番で発生しています。修正してください。

TypeError: Cannot read properties of undefined (reading 'userId')
    at OrderController.createOrder (src/controllers/OrderController.ts:47:32)
    at Layer.handle [as handle_request] (node_modules/express/lib/router/layer.js:95:5)
    at next (node_modules/express/lib/router/route.js:137:13)

リクエストボディ: { "items": [{"productId": "abc123", "qty": 2}] }
ユーザーは未ログイン状態でチェックアウトを試みていました。

Claude Codeはスタックトレースからファイルと行番号を特定し、OrderController.ts の該当箇所を自律的に読み込む。未ログインユーザーのケースでは req.user が undefined になることを推測し、認証チェックの追加または適切なエラーレスポンスの返却を提案・実装する。「なぜそのバグが起きているか」の説明も添えてくれるため、単なる修正ではなく理解の深化にもつながる。

リファクタリング：ドメイン設計の改善

技術的負債の返済もClaude Codeが得意とする領域だ。

「UserService.tsが肥大化しています（現在1200行）。
認証・プロフィール管理・通知設定の3つの責務が混在しているので、
ドメインサービスとして分割してください。
既存のテストは壊さず、インターフェースの後方互換性も維持してください。」

Claude Codeはまず既存コードを分析し、責務の境界を特定する。その後、AuthService、UserProfileService、NotificationPreferenceService を段階的に抽出しながら、既存の呼び出し元コードも同時に更新する。1200行のモノリシックなサービスクラスが、疎結合な3つのクラスに整理される作業を、整合性を保ちながら自動で進められるのは大きな価値だ。

テスト生成：カバレッジの空白を埋める

「src/utils/priceCalculator.ts のテストカバレッジが32%しかありません。
既存のテストを確認した上で、未カバーのブランチを中心に
Jestのテストケースを追加してください。
特に税率計算の境界値（0%、8%、10%）とNull入力の扱いを重点的にお願いします。」

コードカバレッジレポートのURLやファイルパスを添えると、Claude Codeは実際に未テストの分岐を特定し、意味のあるテストケースを生成する。「テストを増やす」のではなく「カバレッジの穴を塞ぐ」というタスク指定が精度を高めるコツだ。

依存ライブラリ更新：安全なバージョンアップ

「package.jsonの依存ライブラリを最新安定版に更新してください。
メジャーバージョンアップがある場合はBreaking Changesを調べて、
必要なコード修正も一緒に行ってください。
更新後はnpm testを実行して全テストが通ることを確認してください。」

Claude Codeはnpm outdatedの結果を解析し、安全に更新できるものとBraking Changesを含むものを区別する。必要に応じてマイグレーションガイドを参照しながら、コードの修正まで行う。最後に npm test を実行して問題がないことを確認する、という一連のサイクルを自律的に完結させる。

Category 2: 自動化・定期実行（/loopを活用）

Claude Codeの /loop 機能は、定期的なタスクをエージェントが自律実行する仕組みだ。「15分ごとにCIの状態を確認して失敗したらSlackに通知する」といったことが、数行のコマンドで実現できる。

# 朝のPRレビュー自動チェック（1時間ごと）
/loop 1h /review-pending-prs

# CI失敗の継続監視と失敗時通知（15分ごと）
/loop 15m /check-ci-and-notify-on-failure

# 週次依存ライブラリ監査（7日ごと）
/loop 7d /audit-dependencies

これらの自動化がどのように連携するかを、朝の開発開始時のシナリオで可視化しよう。

sequenceDiagram
    participant Dev as 開発者（出社）
    participant CC as Claude Code
    participant GH as GitHub
    participant CI as CI/CD
    participant Slack as Slack

    Note over CC: /loop が夜間も稼働中
    CC->>GH: オープン中のPRを取得
    GH-->>CC: 5件のPR
    CC->>CC: 各PRのコード差分を分析
    CC->>GH: レビューコメントを投稿
    CC->>CI: ビルドステータスを確認
    CI-->>CC: 2件が失敗
    CC->>CC: 失敗ログを分析
    CC->>Slack: "PR #142, #156 がCIで失敗。原因: 型エラー in UserService.ts"

    Note over Dev: 出社・Slackを確認
    Dev->>CC: 「#142のCI失敗を修正して」
    CC->>CC: エラー内容を把握済み（ループで収集）
    CC->>GH: 修正コミットをプッシュ
    CI-->>CC: ビルド成功
    CC->>Slack: "PR #142 CI 通過しました"

このシーケンスが示すように、/loop による自動化の真価は「開発者が作業を開始する前に、状況把握と初期処理を完了させておく」点にある。朝イチで「今日何を優先すべきか」がSlackに整理されている状態は、開発チームの生産性を大きく変える。

カスタムの /loop ターゲットは、プロジェクトルートの CLAUDE.md に定義できる。たとえば /review-pending-prs の実体は「72時間以上レビュー待ちのPRを取得し、コード品質・テストカバレッジ・コーディング規約への準拠を確認してコメントする」という詳細なプロンプトとして記述する。

Category 3: QA・Computer Useとの組み合わせ

Claude CodeにComputer Use（ブラウザ操作能力）が統合されたことで、E2Eテストの自動化が新たな次元に達した。従来のE2Eテストフレームワーク（PlaywrightやCypress）が「事前に書いたシナリオを実行する」ものだとすれば、Claude Code + Computer Useは「振る舞いを理解した上でテストを設計・実行・改善する」という質的に異なるアプローチを提供する。

ログインページのバグ対応フロー

具体的なシナリオで説明しよう。本番環境でログインページの異常動作が報告された。

「ログインページで以下の問題が報告されています：
- 正しいパスワードを入力しても「認証エラー」になる（再現率30%）
- 発生条件不明

ブラウザでログインページを開いて動作を確認し、
バグを特定して修正してください。」

Claude Codeはブラウザを起動し、ログインフォームに複数のパターンでテスト入力を行う。特殊文字を含むパスワード（p@ssw0rd!）を入力した際に再現することを発見し、スクリーンショットを取得する。ネットワークタブを確認すると、パスワードのURLエンコードが二重になっていることが判明。auth/login.ts の該当箇所を修正し、再びブラウザで動作を確認して修正が効いていることを検証する。この「発見→修正→確認」のループを人間の介在なしに完結させる。

flowchart TD
    A[バグ報告受信] --> B[ブラウザでログインページを開く]
    B --> C[複数パターンでログイン試行]
    C --> D{エラー再現?}
    D -->|No| E[入力パターンを変えて再試行]
    E --> C
    D -->|Yes| F[スクリーンショット取得]
    F --> G[ネットワークログ・コンソール確認]
    G --> H[根本原因を特定]
    H --> I[コードを修正]
    I --> J[ブラウザで再検証]
    J --> K{修正確認?}
    K -->|No| H
    K -->|Yes| L[修正内容をPRとして提出]

このフローにより、「再現条件の特定」という最も時間のかかるデバッグフェーズが自動化される。エンジニアは原因と修正方針が判明した状態から作業を引き継げる。

フォーム入力・ドロップダウン選択・ファイルアップロード・レスポンシブデザインの確認など、従来なら手動でしかテストできなかった操作を、Claude Codeは自然言語の指示から自律的に実行できる。

Category 4: チーム・エンタープライズ活用

個人の生産性向上を超えて、Claude Codeはチーム・組織レベルの開発プロセスを変革する。その中核にあるのがAgent Teamsだ。

Agent Teams：並行実行による高速化

複数のClaude Codeインスタンスが並行して異なるタスクを担当し、最後に統合するモデルは、大規模な開発タスクに対して特に効果的だ。

graph TD
    PM[プロジェクトマネージャー Agent<br/>タスク分解・進捗管理]

    PM --> FE[フロントエンド Agent<br/>Reactコンポーネント実装]
    PM --> BE[バックエンド Agent<br/>APIエンドポイント実装]
    PM --> QA[QA Agent<br/>テスト実装・品質確認]
    PM --> DOC[ドキュメント Agent<br/>API仕様書・README更新]

    FE --> INT[統合 Agent<br/>コンフリクト解決・最終レビュー]
    BE --> INT
    QA --> INT
    DOC --> INT

    INT --> PR[PRの作成・提出]

    style PM fill:#4A90D9,color:#fff
    style INT fill:#7B68EE,color:#fff
    style FE fill:#5CB85C,color:#fff
    style BE fill:#5CB85C,color:#fff
    style QA fill:#F0AD4E,color:#fff
    style DOC fill:#5BC0DE,color:#fff

たとえば「新規ユーザー登録フローを実装する」という大きなタスクを受けたとき、プロジェクトマネージャーAgentがタスクを分解する。フロントエンドAgentは登録フォームのコンポーネントを、バックエンドAgentはユーザー作成APIを、QA Agentはそれぞれのテストを、ドキュメントAgentはAPI仕様書を並行して実装する。従来なら数日かかる作業が、並行実行により数時間で完了する。

ドキュメント自動同期

PRがマージされるたびにドキュメントが古くなる問題は、多くのチームが抱える慢性的な課題だ。Claude Codeはこれを自動化する。

# .github/workflows/doc-sync.yml に設定
# PRマージ時に自動実行

「マージされたPRの変更内容を確認し、
以下のドキュメントを最新の状態に更新してください：
- README.mdの機能説明セクション
- docs/api-reference.mdのエンドポイント一覧
- CHANGELOG.mdへの変更履歴追記
更新後、doc-update/[PR番号] ブランチでPRを作成してください。」

リリースノート自動生成

「v2.3.0のリリースノートを作成してください。
前回リリース(v2.2.0)からのコミット履歴を分析して、
- エンドユーザー向けの新機能（非技術的な言葉で）
- バグ修正の概要
- 破壊的変更（もしあれば）
を整理してください。GitHub Releasesのフォーマットで出力してください。」

コミットメッセージから意味を読み取り、技術者向けの記述をエンドユーザーが理解できる言葉に変換する作業は、従来リリース担当者が1〜2時間かけて行っていた。Claude Codeはこれを数分で、かつ一貫したフォーマットで実施する。

エンタープライズ環境では、Agent Teamsに役割ベースのアクセス制御を組み合わせることで、セキュリティポリシーへの準拠を保ちながら自動化の恩恵を受けることができる。「このAgentはstaging環境のみ触れる」「承認なしに本番DBへの変更は不可」といった制約をCLAUDE.mdに明示することで、安全な自動化が実現する。

まとめ

Claude Codeのユースケースは、「コードを書いてもらう」という単純な活用から、「開発プロセス全体をオーケストレーションする」というより高次の使い方まで広がっている。重要なのは、ツールの能力に合わせて思考のスケールを広げることだ。「この関数を直して」ではなく「このサービス全体の品質を改善して」と問えるようになったとき、Claude Codeは真の力を発揮する。

次章では、これらのユースケースを高い精度で実行し続けるための、コンテキストウィンドウ管理という最重要スキルを解説する。