第1部：AI駆動開発の深化 Step 2 / 36

AIエージェントの活用

Claude Code の Plan Mode や Cursor の Agent Mode を使うと、AIが自律的に複数のファイルを編集し、複雑なタスクを完遂できます。効果的な使い方を学びましょう。

AIエージェントとは

通常のAIとエージェントの違い

通常のAI（チャット）

  • ・1回の指示 → 1回の応答
  • ・ユーザーが都度確認・実行
  • ・ファイル操作は手動
  • ・細かい制御が可能

AIエージェント

  • ・1つの目標 → 自律的に複数ステップ実行
  • ・AIが計画→実行→確認を繰り返す
  • ・ファイル作成・編集を自動実行
  • ・効率的だが監視が必要

Claude Code の Plan Mode

Plan Mode の起動方法

# 方法1: コマンドで起動
claude --plan

# 方法2: チャット中に切り替え
> /plan

# 方法3: 指示の中で依頼
> 以下の機能を実装する計画を立ててください（まだ実行しないで）

Plan Mode の流れ

1

計画立案

AIがタスクを分析し、実行計画を提示します

2

ユーザー確認

計画を確認し、承認または修正を指示します

3

自律実行

承認後、AIが計画に沿って自動的にファイルを編集します

4

結果報告

完了後、何を行ったかを報告します

Plan Mode 向けの指示例

【目標】
プロジェクトにユーザープロフィール機能を追加してください。

【要件】
- プロフィール編集画面（名前、自己紹介、アバター）
- バックエンドAPI（GET /users/me/profile, PUT /users/me/profile）
- アバター画像のアップロード機能

【既存コード】
- backend/app/models/user.py にUserモデルあり
- frontend/src/features/auth/ に認証機能あり

【お願い】
1. まず計画を立ててください
2. 計画を承認したら実行してください
3. 各ステップで何を行ったか報告してください

Cursor の Agent Mode

Agent Mode の起動方法

# Composer (Cmd+I / Ctrl+I) を開く
# 右上のドロップダウンで "Agent" を選択

# または、チャットパネルで
# @agent と入力してから指示を書く

Note: Agent Mode は複数ファイルの同時編集、ターミナルコマンドの実行、エラーの自動修正などを自律的に行います。

効果的な使い方

○ 向いているタスク
  • ・新機能の追加（複数ファイルにまたがる）
  • ・リファクタリング（パターンの一括適用）
  • ・テストコードの生成
  • ・バグ修正（原因調査から修正まで）
△ 注意が必要なタスク
  • ・本番環境への操作
  • ・機密情報を含むファイルの編集
  • ・大規模なデータベース変更
  • ・取り消しが難しい操作

エージェント活用のコツ

1. ゴールを明確に

曖昧な指示だとAIも迷います。完了条件を明確にしましょう。

✗ 「ユーザー機能を良くして」
○ 「ユーザーがプロフィール画像を変更できるようにして」

2. スコープを限定

一度に変更する範囲を絞ると、問題が起きても対処しやすいです。

✗ 「アプリ全体をリファクタリング」
○ 「backend/app/api/ のエラーハンドリングを統一」

3. チェックポイントを設ける

長い作業は中間確認を入れることで、軌道修正しやすくなります。

「まずモデルを作成したら一度見せて」
「APIができたらテストして結果を報告して」

4. Git を活用

作業前にコミットしておけば、問題が起きても戻せます。

「作業前に現状をコミットして」
「各機能が完成したらコミットして」

実践例：認証機能の追加

エージェントへの完全な指示

【目標】
既存のNext.js + FastAPIアプリにJWT認証を追加してください。

【現状】
- backend/app/models/user.py は未作成
- 認証機能は一切ない状態

【要件】
1. バックエンド
   - User モデル（email, hashed_password, created_at）
   - POST /auth/register（新規登録）
   - POST /auth/login（ログイン、JWTトークン返却）
   - GET /auth/me（現在のユーザー情報）

2. フロントエンド
   - /login ページ
   - /register ページ
   - 認証状態の管理（Context or Zustand）
   - 認証が必要なページの保護

【制約】
- パスワードは bcrypt でハッシュ化
- JWT の有効期限は 24 時間
- 既存の frontend/src/lib/api.ts を使用

【進め方】
1. まず全体の計画を立ててください
2. バックエンドから順に実装
3. 各ステップ完了後に動作確認できるようにしてください
4. 最後に簡単な動作テストを行ってください

重要：エージェントが作業中でも、不安な点があれば「ちょっと待って」と言って確認できます。完全に任せきりにせず、適度に監視しましょう。

まとめ

  • ✓ エージェントは自律的に動く - 計画→実行→確認を自動で行う
  • ✓ Claude Code は /plan で起動 - 計画を確認してから実行させる
  • ✓ Cursor は Agent モードで - Composer から Agent を選択
  • ✓ ゴールとスコープを明確に - 曖昧な指示は避ける
  • ✓ 適度に監視する - 完全に任せきりにしない
大規模プロジェクトでのAI活用 次へ：複雑なタスクの分解術