Claude CodeとLaravel Boostの違い — 役割分担とMCP連携

Claude CodeとLaravel Boostは何が違うのか

結論から言うと、両者は競合しません。Claude Codeはどんな言語・フレームワークでも動く汎用のコーディングエージェントで、Laravel Boostはその上にLaravel固有の知識を積む拡張レイヤーです。Laravel公式のインストールガイドも、Laravel Boostを「AIコーディングエージェントとLaravelアプリケーションの間のギャップを埋めるツール」と説明しており、Claude Codeを置き換えるものではありません。

Claude Codeはファイルの読み書き・コマンド実行・計画立案を担う実行基盤です。一方のLaravel Boostは、MCPサーバー・AIガイドライン・Agent Skillsという3つの仕組みで、Claude CodeにLaravelプロジェクト固有のコンテキストを渡します。役割を分けて理解すると、導入判断も設定トラブルの切り分けも早くなります。

Claude CodeとLaravel Boostがそれぞれ担う範囲

Claude Codeは、コードベースを読み、編集を提案し、テストやビルドコマンドを実行するCLIエージェントです。CLAUDE.md(設定によってはAGENTS.mdも)に書かれた指示を毎セッション読み込み、MCP(Model Context Protocol)を通じて外部ツールに接続する仕組みを持ちますが、Laravelのバージョンやパッケージ構成については何も知りません。

Laravel Boostは、その空白を埋める専用パッケージです。Composerでインストールし、php artisan boost:installを実行すると、プロジェクトのcomposer.jsonを解析してインストール済みパッケージを検出し、バージョンに応じたガイドラインとMCPツールをAIエージェント向けに生成します。つまりLaravel Boostは「Laravelアプリの中身を知っている案内役」で、Claude Codeは「その案内をもとに実際に手を動かす実行役」という分担です。

Laravel Boostが追加する3つの仕組み

MCPサーバーが提供する9つのツール

Laravel Boostはphp artisan boost:mcpで起動するMCPサーバーを内蔵しています。Claude Codeがこのサーバーに接続すると、以下のツールを呼び出せるようになります。

これらはClaude Codeが標準では持たない、Laravelアプリの「今の状態」を見るための手段です。マイグレーションを当てる前にスキーマを確認する、エラーログを読んでから修正案を出す、といった作業をClaude Codeが自律的にこなせるようになります。

このうちSearch Docsツールは、Boostが17,000件超のLaravelエコシステム情報をベクトル化して持つドキュメンテーションAPIを叩きます。対応範囲はパッケージごとに決まっており、一覧に無いパッケージは検索対象外です。

対象外のパッケージについては、Claude CodeがSearch Docsツールを介さず、通常のWeb検索や公式サイトの参照で情報を補う形になります。

ガイドラインはCLAUDE.mdでなくAGENTS.mdに書かれる

Laravel Boostのboost:installは、選択したエージェントに応じてガイドラインファイルを自動生成します。Laravel・Livewire・Inertia・Pest・Tailwind CSSなど、Laravelエコシステムの主要パッケージごとにコーディング規約を記述したものです。ここでClaude Codeユーザーが誤解しやすいのは書き込み先です。Boostのソースコード(ClaudeCodeエージェント定義)を見ると、Claude Code向けのガイドライン出力先は既定でAGENTS.mdであり、プロジェクトのCLAUDE.md本体ではありません。

ここで注意したいのが読み込みの既定挙動です。Claude Codeの既定設定(claude-md-or-agents-md)では、CLAUDE.mdが存在する場合AGENTS.mdは読み込まれず無視されます。つまりBoostがAGENTS.mdにガイドラインを生成しても、プロジェクトに./CLAUDE.mdがあるだけでは自動的に反映されません。両方を読み込ませるには、/configまたはsettings.jsonでclaude-md-and-agents-mdに明示的に変更する必要があります。

チームが手書きで管理している./CLAUDE.mdとBoostが生成するAGENTS.mdは別ファイルとして保存されているため上書きの心配はありませんが、設定を変更しない限りBoostのガイドラインがセッションに渡らない点は見落としやすい落とし穴です。設定変更後は両方とも起動時にコンテキストウィンドウへ読み込まれるため、合計サイズは/contextコマンドで確認しておくと安心です。

公式ドキュメントは、これらの生成ファイルを.gitignoreに加えても構わないとしています。boost:installやboost:updateのたびに再生成される前提のファイルだからです。手書きの指示を書き足したい場合は、.ai/guidelines/ディレクトリにMarkdownファイルを追加すれば、Boostの規約と一緒に読み込まれます。

Agent Skills — .claude/skills/に直接インストールされる

Laravel Boostはこのほかに、livewire-development・pest-testing・tailwindcss-developmentなど、パッケージ単位のAgent Skillsをcomposer.jsonの内容から自動選択してインストールします。ガイドラインがセッション開始時に常に読み込まれるのに対し、Skillsは該当する作業のときだけ読み込まれる点が異なります。

Claude Code向けのSkillsインストール先は.claude/skills/です。これはClaude Code自身が手書きのプロジェクトSkillを置く場所とまったく同じディレクトリで、Claude CodeのSkillsもAgent Skills(agentskills.io)というオープン規格に準拠しているため、Boostが生成したSkillファイルは追加設定なしにそのまま認識されます。裏を返すと、既に同名(pest-testingなど)の手書きSkillを.claude/skills/配下に置いている場合は、boost:install実行時に上書きされないか確認しておく必要があります。

Claude CodeにLaravel Boostを導入する手順

導入はComposerでのインストールと、MCPサーバーの登録の2段階です。Boostが対応するのはPHP 8.1以上でLaravel 10〜13系のアプリケーションです。

composer require laravel/boost --dev
php artisan boost:install

boost:installを実行すると、使用中のIDE・AIエージェントを自動検出し、どの機能(MCP・ガイドライン・Skills)を有効にするか選択するインタラクティブな画面が出ます。Claude Code向けにMCPサーバーを有効化した場合、設定はプロジェクトルートの.mcp.jsonに直接書き込まれます。これはClaude Codeの用語で言う「projectスコープ」(gitで管理してチームと共有する設定)にあたり、チームメンバー全員が同じMCP接続を得られます。

MCPサーバーが自動検出で有効化されない、あるいは接続されない場合は、次のコマンドで手動登録できます。公式ドキュメントが例示するこの手動コマンドは-s localを指定しており、boost:installが書き込むprojectスコープとは異なり、実行した自分のマシンにだけ有効な設定になります。

claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp

登録後は/mcpでサーバーがconnectedと表示されているかを確認します。claude mcp addのオプション(スコープ指定や認証まわり)はLaravel Boost固有ではなく、MCPサーバー全般に共通する構文です。同じ型はAuth0やBrowserbaseのMCPサーバーを導入するときにも登場します。

Laravelエコシステム以外のパッケージがバージョンアップした場合に備え、php artisan boost:updateでガイドラインとSkillsを最新化しておくと、Claude Codeが参照する情報も古くなりません。composer.jsonのpost-update-cmdにこのコマンドを登録すれば、依存パッケージの更新に合わせて自動実行できます。

使い分け早見表

よくあるつまずき

Boostが生成したAGENTS.mdを手動編集してからboost:updateを実行すると、再生成によって変更が失われることがあります。独自ルールは.ai/guidelines/配下のファイルに分けておくと、更新のたびに上書きされる心配がありません。

また、boost:install時にClaude Codeへの対応が自動検出されなかった場合、MCPサーバーが登録されないまま気づかずに使い続けているケースも見られます。この状態でもClaude Code自体は問題なく動くため、Application InfoやDatabase Schemaといったツールが呼び出せていないことに、エラーが出るまで気づきにくい点には注意が必要です。導入直後は/mcpで接続状態を確認する一手間を挟むと安全です。

もう一つ紛らわしいのが、Laravel Boost自身が提供するmcp-developmentスキルです。これはBoostのMCPツールを使うためのスキルではありません。公式の一覧では対応パッケージが「MCP」とだけ示されており、Boostが接続するAIエージェント向けのMCPツールではなく、開発者自身がLaravel向けのMCPサーバーを実装する側のためのスキルと見られます。混同しないようにします。

導入そのものが選択肢に入らないケースもあります。Laravel Boostが対応するのはPHP 8.1以上、Laravel 10〜13系のアプリケーションに限られます。Laravel 9系以前のレガシーなプロジェクトでは、Boostを導入する前にフレームワーク自体のアップグレードが必要です。この場合、Claude Codeは通常のMCPサーバー登録や手書きのCLAUDE.mdだけで運用することになります。

まとめ

Claude CodeとLaravel Boostは、汎用エージェントとフレームワーク特化の情報レイヤーという別の役割を持つツールです。Laravel Boostを導入すると、MCPツールでアプリの実態を、ガイドラインとSkillsでLaravel固有の作法を、Claude Codeに渡せるようになります。既存のCLAUDE.mdやMCP構成と衝突しないよう、Boostが自動生成するファイルと手書きの指示を分けて管理するのが実務上のポイントです。