はじめに

「AIエージェント」という言葉をよく聞くようになりましたが、「ChatGPTと何が違うの?」と思っている人も多いのではないでしょうか。

自分もClaude Codeを使い始めるまでは、正直よくわかっていませんでした。実際に使ってみてから初めて「これは確かに違う」と実感しました。

この記事では、AIエージェントとは何かという概念の整理から、実際にどう使うかの具体的な話まで踏み込んで書きます。


この記事でわかること

  • 生成AIとAIエージェントの違い
  • 代表的なAIエージェントの種類
  • Claude Codeの具体的な使い方とコード例
  • AIエージェントを使った実際の開発フロー
  • AIエージェントの限界と注意点

生成AIとAIエージェントの違い

まず整理しておきます。

生成AIは、人が入力した内容に対して「答えを生成する」AIです。ChatGPT・Claude・Geminiなどが代表例で、基本的な流れは「質問→回答→終わり」です。

AIエージェントは、目標を与えられると「自分で考えながら複数のステップを実行する」AIです。ただ答えるだけでなく、必要なら調べて・ファイルを操作して・コードを実行して、目的を達成しようとします。

項目 生成AI AIエージェント
動き方 質問に答えるだけ 自律的に複数の作業を実行
ファイル操作 できない できる
状況の判断 人間が次の指示を出す 自分で次のステップを判断
イメージ 優秀な相談相手 優秀なアシスタント

一番わかりやすい違いは「ファイルを触れるかどうか」と「次に何をするか自分で判断できるかどうか」です。


代表的なAIエージェント

Claude Code(Anthropic)

ターミナル上でClaudeと対話しながら開発を進めるAIエージェントです。プロジェクト全体のファイル構成を読み込んだ状態で作業するため、「このControllerを直して」という指示に対してプロジェクトの文脈を理解した回答が返ってきます。

自分が毎日使っているメインのAIエージェントです。

OpenAI Operator

OpenAIが提供するAIエージェントで、Webブラウザを操作しながらフォーム入力・検索・手続きの実行といった作業を自律的に行えます。

AutoGPT / Manus

AutoGPTは目標設定から自律的にタスクを分解して実行し、AIエージェントブームの火付け役とも言われています。Manusは複数の作業を連携して処理できる点が特徴で、ビジネス用途での活用が広がっています。


Claude Codeの具体的な使い方

ここからが実践的な内容です。自分が毎日使っているClaude Codeを例に、具体的な使い方を解説します。

インストール

npm install -g @anthropic-ai/claude-code

起動

cd your-laravel-project
claude

プロジェクトのディレクトリに移動してから起動します。これだけでClaude Codeがプロジェクト全体を読み込みます。

基本的な使い方

起動後は自然な言葉で指示するだけです。

# エラー調査
このエラーを調べて解決策を教えて
SQLSTATE[42S02]: Base table or view not found: 1146 Table 'db.products' doesn't exist

# 機能の実装
商品管理のCRUD機能を作って。テーブルはproductsで、name・price・stockカラムを持つ

# リファクタリング
UserControllerが長すぎるのでServiceクラスに切り出して

# コードレビュー
このコードの改善点を教えて

知っておくと便利なスラッシュコマンド

Claude Codeには / から始まるコマンドがあります。

/init     # プロジェクトを分析してCLAUDE.mdを自動生成
/compact  # 長い会話を圧縮してコンテキストを確保
/clear    # 会話履歴をリセット
/diff     # Claude Codeが変更したファイルの差分を確認
/help     # 使えるコマンドの一覧を表示

特に /init は最初に一度やっておくと、プロジェクトの構成を分析して CLAUDE.md を自動生成してくれます。


CLAUDE.mdでプロジェクトを「記憶」させる

プロジェクトのルートに CLAUDE.md を作成すると、Claude Codeが毎回起動時に自動で読み込んでくれます。「このプロジェクトはこういう構成です」を毎回説明しなくて済むようになります。

Laravelプロジェクトでの例:

# プロジェクト概要
Laravel 11を使った予約管理システムです。

## 環境
- PHP 8.2 / Laravel 11
- MySQL 8.0
- Docker(Laravel Sail)

## よく使うコマンド
- `sail up -d` でローカル環境起動
- `sail artisan migrate` でマイグレーション実行
- `sail artisan test` でテスト実行

## コーディングルール
- ControllerにはロジックをなるべくServiceクラスに書く
- バリデーションはFormRequestクラスを使う
- テストはFeatureとUnitを用途によって使い分ける

## ディレクトリ構成
- app/Http/Controllers/ → コントローラー
- app/Services/         → ビジネスロジック
- app/Models/           → モデル

これを書いておくだけで、指示の精度が大きく変わります。


実際の開発フロー:エラー調査の場合

以前はエラーに詰まると、エラーメッセージをコピーして検索して複数のページを読み比べて——という流れで、原因がわからないエラーに2〜3時間かかることがありました。

今の流れはこうです。

# エラーメッセージをそのままターミナルに貼り付ける
Call to a member function products() on null

# Claude Codeの回答例
このエラーはUserモデルにproducts()リレーションが定義されていないか、
$userがnullの状態でproducts()を呼び出している可能性があります。

app/Models/User.php を確認します...

User.phpにproducts()リレーションが定義されていません。
以下を追加してください:

public function products()
{
    return $this->hasMany(Product::class);
}

プロジェクト全体を知った状態でエラーを分析してくれるので、「どこを見ればいいか」の方向性が数分で出ます。


実際の開発フロー:新機能実装の場合

# 指示の例
お問い合わせフォーム機能を実装したい。
nameとemailとmessageカラムを持つcontactsテーブルで、
バリデーションはFormRequestを使って、送信後は管理者にメールを送る処理も入れて。

# Claude Codeの動き
→ プロジェクト構成を確認
→ Migration・Model・FormRequest・Controller・Mailクラスを順番に作成
→ Routeに追加して実装内容をサマリー出力

「一から全部書く」のではなく「方向性を伝えて土台を出してもらい、自分で確認・修正する」という流れが効率的です。


ファイルを直接指定して相談する

@ファイルパス の形式でファイルを指定すると、そのファイルを読んだ上で回答してくれます。

@app/Http/Controllers/UserController.php を確認して改善点を教えて

@app/Models/User.php とリレーションが正しく設定されているか確認して

「どのファイルを直せばいいか自分ではわからない」というときも、ファイルを指定して「このファイルに問題はある?」と聞く使い方ができます。


AIエージェントの限界と注意点

便利な一方で、使っていて感じた限界も正直に書きます。

提案が常に正しいとは限らない

生成されたコードは必ず自分で確認が必要です。動いているように見えても、ロジックが意図と違っていたり、セキュリティ上の問題が潜んでいることがあります。

# Claude Codeが書いたコードを確認する習慣
/diff で変更点を確認してから受け入れる

ビジネス要件はわからない

「このユーザー層にとって最適な実装は何か」「セキュリティとUXのどちらを優先すべきか」——こういった判断はAIには難しいです。技術的な実装は任せられますが、「何を作るか」の判断は人間の仕事として残ります。

基礎知識がないと使いこなせない

Laravelの基礎を知らないと、Claude Codeが出したコードの良し悪しを判断できません。AIを使いこなすためにも、基礎学習の価値はむしろ上がっていると感じています。


まとめ

AIエージェントとは、生成AIをさらに一歩進化させた「目標を達成するために自律的に動くAI」です。

生成AIが「答えを作るAI」なら、AIエージェントは「一緒に仕事を進めるAI」と言えます。

Claude Codeを毎日使う立場から言うと、最も変化したのはエラー調査です。以前は何時間もかかっていたことが、プロジェクト全体を理解した状態での分析によって数分で方向性が出るようになりました。

AIエージェントは道具です。使いこなすためには基礎知識が必要ですが、うまく活用できれば開発の質とスピードが確実に上がります。


関連記事