Claude Code 大全
ある日の Twitter/X のタイムライン。
「
/compactで context rot が悪化したので/clear派に戻った」 「サブエージェント に渡すと意外と速い、並列ワークツリー で 4 本走らせてる」 「MCP で Chrome 繋いだら開発体験変わった」 「hooks に型チェック仕込んで、変な編集止めてる」
このひと続きの言葉が、ひとつの物語として読めるだろうか。 本書はそのための地図帳である。
「コーディングエージェント」という言葉が、もう日常になった。 Cursor、GitHub Copilot Workspace、Cline、Aider、Codex、Devin ── そして本書の主役 Claude Code。
ところが「で、結局あいつらは中で何をしてるの？」と訊かれて即答できる人は少ない。 ターミナルにテキストを入れたら、なぜか数十ファイルが書き換わって、テストが緑になっている。 この “なぜか” の正体を、本書は最後まで追いかける。
この本でやること
技術書としての完璧さは追わない。代わりに 「Claude Code 界隈の会話・ブログ・X ポストが、構造として読める」 を一貫したゴールにする。
読者が抱えがちな疑問は、たいてい次の 三つの層 に分かれる。本書はこの三層に正面から答える形で、第Ⅰ部 15 章と第Ⅱ部 22 章を組んでいる。
疑問① 原理が分からない ── そもそも LLM はなぜ “動ける” のか？ → 第Ⅰ部 (第1-15章) が答える。agentic loop、function calling、context window、sub-agent、MCP ── これらを 比喩と構造図で根本から腑に落とす。
疑問② コマンドが多すぎる ── /init /compact /agents /hooks って何が違う？
→ 第Ⅱ部 (公式コマンド逐次解説) が答える。公式コマンド 1 つ = 1 章 で、「そもそも何を解くコマンドか」から逐次解説する。
疑問③ 大全として網羅したい ── 後で引きたい → 第Ⅱ部は 辞書としても引ける ように設計してある。各章末に「読めるブログ」と「関連コマンド」を添え、第Ⅰ部の該当章への参照を張る。
章マップ
第Ⅰ部の各章は 15-20 分で読める 通読型、第Ⅱ部の各コマンド章は 5-10 分で引ける リファレンス型 ── 二つの読み方を一冊に同居させた。
最初の一読目は 第Ⅰ部だけを順に通読 するのがおすすめ。第Ⅱ部は、業務で /compact や /hooks に出くわしたタイミングで、その章だけ引きに来ても良い。
こんな人向け
- Claude Code / Cursor / Codex を業務で使っているが、中で何が起きているか気持ち悪い 人
- 公式ドキュメントを読んでも、コマンド間の関係や設計判断の理由 が腑に落ちない人
- AI コーディング系のブログや X ポストで、未定義の用語が次から次へ出てきて疲れた 人
- チームに Claude Code を導入したいが、hooks / permissions / sub-agent の設計判断 をどう説明するか悩んでいる人
逆に、「LLM 研究の最先端アーキテクチャ」を求めている研究者向けではない。 本書は エージェントを実際に使う側の人 のための、なるべく腑に落ちる教科書として書いた。
前提知識
- ターミナルでコマンドを打った経験
- Git のだいたいの感覚（branch、PR、commit）
- LLM (ChatGPT 等) を一度は触ったことがある
数式は出てこない。出てきても全部、言葉で補足する。
本書のスタンス
私はこの本を「使い方マニュアル」ではなく 「内部の構造図」 として書いた。 コマンドの引数を暗記してもらうことには関心がない。 代わりに、なぜそのコマンドが存在するのか、なぜその設計になっているのか ── そこに踏み込む。
Claude Code は速いペースで変わり続けるツールだ。引数や見た目は来年違うかもしれない。 だが 「agentic loop」「context window」「tool call」「sub-agent」「MCP」 という骨格は、もっと長く生き残る。
骨格を腑に落とした読者は、来年の Claude Code も、別のエージェントも、自分の頭で読めるようになる。 それがこの本の願いだ。
それでは始めよう
最初の章で問うのは、最も基本的な質問 ── そもそも「エージェント」とは何か だ。