Claude Codeの真価を引き出すCLAUDE.mdの書き方とAgent Teams（クラスター）完全ガイド

Claude Code環境に最適なVPSを確認する※ 初期費用0円・最低利用期間なし・解約もWebで完結

「Claude Codeを使い始めたのに、セッションを再起動するたびにルールを一から教え直している」——その根本解決策がCLAUDE.mdだ。CLAUDE.mdの書き方のベストプラクティスから「Agent Teams（クラスター）」の実践法まで解説する。

なぜClaude Codeはセッションをまたいで「忘れてしまう」のか？

LLMは本質的にステートレスだ。セッションを再起動した瞬間、前回の会話は完全に消滅する。CLAUDE.mdがその唯一の恒久的解決策になる。

大規模言語モデルは推論時にパラメータが完全に固定されており、過去の対話を記憶する仕組みを持たない。インフラ12年の私でも、最初は「npmではなくpnpmを使うこと」「TerraformのstateはS3に保存すること」を毎回入力し直す羽目になった。CLAUDE.mdはリポジトリのルートに置く単一のMarkdownファイルで、Claudeが起動時に自動読み込みする「プロジェクト専用オンボーディングドキュメント」として機能する。

完璧なCLAUDE.mdを書くためのベストプラクティスとは？

CLAUDE.mdは「Less is More」が鉄則。AIがコードを読んでも推測できないプロジェクト固有の情報だけを60行未満に絞って記述する。

含めるべきは「特殊なビルドコマンド」「デフォルトから意図的に逸脱したルール（ESModule強制など）」「アーキテクチャ上の意思決定の背景」の3点。LinterやFormatterが自動修正する事項や、頻繁に変更されるコードスニペットの直書きは避ける。スニペットは@docs/git-instructions.mdのような参照ポインタに置き換えるプログレッシブ・ディスクロージャーでコンテキストウィンドウを節約できる。

ゼロから書くより/initコマンドが最速だ。プロジェクトルートで実行すると既存コードベースを静的解析し、技術スタック・ビルドシステム・テストフレームワークを自動検出してスターターを生成する。モノレポではグローバル（~/.claude/CLAUDE.md）→ルート（./CLAUDE.md）→サブディレクトリ（./frontend/CLAUDE.md等）の3層で管理する。Claude Codeは階層を遡って複数ファイルを結合して読み込み、最も近い設定を優先しながら上位の文脈も理解する。

「クラスター拡張」の正体：Agent Teamsで並列AI開発チームを組む方法は？

Agent Teamsとは複数のClaude Codeセッションが並列で協調稼働するAnthropicの最新機能だ。AIコーディングコミュニティで「クラスターモード」と俗称されるが、KubernetesのAKSクラスターとは別物だ。

メインセッションが「チームリード」としてタスクを分割し、UX担当・バックエンド担当・セキュリティレビュー担当などの専門エージェント（チームメイト）を動的に生成する。各チームメイトは独立したコンテキストウィンドウを持ち、互いにメッセージを交わしながら並列実行する。

MCPサーバーとSKILL.mdでClaude Codeを外部ツール対応にする方法は？

MCP（Model Context Protocol）はClaude Codeを外部ツールと接続するAnthropicのオープンスタンダードだ。

GitHub MCPならIssue解析→ブランチ作成→コミット→PRまでターミナルから完結する。PostgreSQL MCPではAIがスキーマを直接読んで検証できる。MCPサーバーはVPS上でチーム共有も可能だ。SKILL.mdはリポジトリ内ワークフローをカプセル化する仕組みで、外部連携はMCP・内部自動化はSKILL.mdと分担するのが基本だ。

MCPサーバーを動かすVPS環境を確認する（ConoHa VPS）※ 初期費用0円・最低利用期間なし・解約もWebで完結

まとめ：CLAUDE.mdとAgent Teamsで「自律型AI開発チーム」を構築する

CLAUDE.mdは60行未満・/initで自動生成・モノレポは3層管理・Agent Teamsは独立タスクにのみ・MCPで外部ツールを接続——この組み合わせで「自律型AI開発チーム」が完成する。最初の60分を投資してCLAUDE.mdを磨けば、その後の開発速度は別次元になるはずだ。

よくある質問