第0章この本の使い方

Claude Codeを使い始めて、CLAUDE.mdの書き方に迷っているエンジニアが対象だ。

「プロジェクトごとにどうルール化すればいいか分からない」「既存のCLAUDE.mdが機能していない」「スキルが増えすぎて管理できない」、こういう悩みを抱えている人に向けて書いた。

逆に「Claude Codeって何？」という段階なら、まず既刊の「Claude Code実践ガイド」を読んでほしい。
基本操作、MCP設定、Hooksの使い方を一通り押さえてから本書に進む方が理解が早い。

前作「Claude Code実践ガイド」は、Claude Codeの基本機能をゼロから説明した入門書だ。
ツールの使い方、設定方法、MCP連携、開発フローを一通り網羅している。

本書はその次のステップで、「CLAUDE.mdをどう設計するか」に特化している。
62スキル、50コマンド、13MCPサーバーを構築してきた現場での試行錯誤をパターン化した。

前作を読んでいなくても本書は読めるが、「なぜCLAUDE.mdが必要なのか」「どうやってスキル化するのか」の基礎は前作で押さえておく方が効率的だ。

最初から順番に読む必要はない。
自分のプロジェクトに近い章から読み始めて、必要なパターンを抜き出して使えばいい。

例えばNext.jsプロジェクトのテンプレートが欲しいなら第2章から入る。
HooksとCLAUDE.mdの連携が知りたいなら第3章を先に読む。
「CLAUDE.mdが無視される」問題に悩んでいるなら第5章を参照する。

各章は独立しているから、順番を気にせず必要な部分だけ拾い読みできる。

コードは全て実際に動いている構成から抜粋している。
コピペしてそのまま使えるし、プロジェクトに合わせてカスタマイズもできる。

1つ注意点がある。
本書のパターンは「正解」ではなく「現時点での最適解」だ。
Claude Codeは頻繁にアップデートされるし、MCPサーバーも日々増えている。

だから「このパターン通りにやれば完璧」ではなく、「このパターンを参考に自分のプロジェクトに合わせて調整する」というスタンスで読んでほしい。

各章の最後に「アンチパターン」も載せている。
実際に失敗した構成、機能しなかったルール、トークンを無駄にした設定を記録した。
同じ失敗を繰り返さないために、まずアンチパターンから読むのもいい。

それでは、自分のプロジェクトに近い章から読み進めてほしい。