マルチエージェントClaude Code の仕組み｜考えて動いて確かめる流れ
この記事の要点
- Claude Code は「情報を集める→手を動かす→結果を確かめる」を、終わるまで繰り返して仕事を進める
- 考えるのはモデル、手を動かすのは道具。Claude Code はその2つをつなぐ外側の仕組み
- 会話はパソコンに保存され、ファイルの変更は Esc 2回で戻せる。長く覚えさせたいことは CLAUDE.md に書く
Claude Code に「このエラーを直して」と頼むと、こちらが細かく指示しなくても、ファイルを探し、読み、直し、テストを動かして結果まで確かめてくれます。チャットのAIと何が違うのかが分かると、頼み方も、止めどころも見えてきます。
この記事では、公式ドキュメント「How Claude Code works」（2026年11月5日確認）にもとづいて、Claude Code の中で何が起きているのか を、使う側に必要なところだけに絞って整理します。
結論：3つの動きを、終わるまで繰り返している
Claude Code は、①必要な情報を集める、②手を動かす、③結果を確かめる、の3つを繰り返して仕事を進めます。 公式ではこれを「エージェントの繰り返し（agentic loop）」と呼んでいます。
3つははっきり分かれているわけではなく、混ざり合いながら進みます。質問に答えるだけなら①だけで終わり、バグ直しなら①〜③を何周も回り、大きな書き換えなら③の確かめに時間をかけます。1つ動くたびに分かったことから次の一手を決める ので、何十もの作業をつなげ、途中で方向を直しながら進められます。
考えるのはモデル、手を動かすのは道具
この繰り返しを支えているのは、考える「モデル」と、手を動かす「道具（ツール）」の2つです。 Claude Code そのものは、その2つの外側にある仕組みで、モデルに道具を渡し、モデルが見る情報を整える役をしています。
| 役割 | 担当 | 中身 |
|---|---|---|
| 考える | モデル（Claude） | コードや文章を読み、何をどう変えるかを決める |
| 手を動かす | 道具 | ファイルの読み書き・検索・コマンド実行・ウェブ検索など |
| つなぐ | Claude Code | 道具を渡し、見せる情報を整え、結果をモデルに返す |
道具が無ければ、AIは文章で答えることしかできません。道具があるから「読む・直す・動かす」ができ、その結果がまた次の判断の材料になります。モデルは用途に合わせて選べ、作業中に /model で切り替えられます。選び方は Claude Code のモデルの選び方 で、道具の全体像は Claude Code ツール一覧 でまとめています。
「テストを直して」と頼んだ時の流れ
公式ドキュメントの例を、そのまま流れにすると次のようになります。
- テストを動かして、どれが失敗しているかを見る
- エラーの内容を読む
- 関係するファイルを探す
- そのファイルを読んで中身を理解する
- ファイルを直す
- もう一度テストを動かして確かめる
どのファイルを読むか、どのコマンドを動かすかは、こちらが指定しなくても Claude が決めます。 頼む側は「何をしたいか」と「どこが関係しそうか」を伝えるだけで足ります。
Claude Code に見えているもの
claude を起動したフォルダの中身と、そのパソコンで自分が使えるコマンドが、Claude Code の見える範囲です。 公式では次のものが挙げられています。
- フォルダの中のファイル：起動したフォルダとその下。ほかの場所は許可を出せば読める
- ターミナル：自分が打てるコマンドはだいたい動かせる（ビルド・git・パッケージ管理など）
- git の状態：今のブランチ、まだ記録していない変更、最近の記録
- CLAUDE.md：毎回読ませたい決まりや前提を書いておくファイル
- 自動の記憶：作業中に Claude が覚えた好みなど。MEMORY.md の最初の200行（または25KB）が毎回読み込まれる
- 自分で足した機能：MCP でつないだ外部サービス、スキル、サブエージェントなど
開いているファイルだけを見る補完のAIと違い、プロジェクト全体を見渡して、複数のファイルをまとめて直せる のが大きな違いです。
会話と記憶はどう残るか
会話はパソコンの中に保存され、あとから続きを再開できます。 やりとりや道具の結果は、ホームフォルダの中の .claude → projects の下に、そのまま読める形で書き込まれます。保存場所の全体は .claude フォルダの中身 で説明しています。
一方で、新しく始めた会話は、前の会話の中身を覚えていません。 毎回まっさらな状態から始まるので、ずっと守ってほしい決まりは CLAUDE.md に書いておきます。続きから再開する方法は Claude Code の会話の再開 にまとめています。
会話が長くなった時
AIが一度に見られる量（コンテキスト）には限りがあります。いっぱいに近づくと、Claude Code は会話を要約して詰め直します。この時、最初のほうに出した細かい指示は抜け落ちることがあります。 大事な決まりは会話ではなく CLAUDE.md に書く、/context で何が場所を取っているかを見る、の2つが基本です。くわしくは コンテキストウィンドウの仕組み を見てください。
失敗しても戻せる仕組みと、勝手に動かさない仕組み
安全のための仕組みは2つあります。ファイルの変更を戻す「チェックポイント」と、何を確認なしでしてよいかを決める「権限」です。
- チェックポイント：Claude はファイルを直す前に、元の中身を控えておきます。Esc を2回押すと前の状態に戻せます。ただし戻せるのはファイルの変更だけで、データベースや外部サービスへの操作、公開作業などは戻せません
- 権限のモード：Shift+Tab で切り替えます。毎回確認する、ファイルの編集だけ任せる、計画だけ立てさせる、危ない操作だけ止める自動のモード、などがあります
戻せない操作ほど、権限で止めておくのが考え方の基本です。モードの違いは Claude Code の権限モード で、元に戻す操作は 巻き戻し（rewind）の使い方 で説明しています。
仕組みを知ると変わる、頼み方の3つのコツ
この流れを知っておくと、「全部を指示しない」「途中で口をはさむ」「確かめ方を渡す」の3つがうまくなります。
- 任せる、指図しない：仕事を同僚に頼むつもりで、目的と関係しそうな場所だけ伝える。読むファイルや動かすコマンドは Claude が決める
- 途中で向きを変える：Esc ですぐ止められる。止めずに一言送ると、いまの作業が終わったところで読んで方向を直す
- 確かめ方を渡す：「このテストが通れば完了」のように終わりの判定を伝えると、③の確かめが正確になる
最初の一言は完璧でなくてかまいません。違っていたら「そこではなく、こっちが原因」と返せば、やり直さずに続きから直してくれます。頼み方の型は Claude Code のベストプラクティス でもまとめています。
よくある質問
チャットのAIと Claude Code は、何が一番違いますか？
道具を持っているかどうかです。チャットは文章で答えるのが中心ですが、Claude Code はファイルを読み書きし、コマンドを動かし、その結果を見て次を決めます。だから「直して、確かめるところまで」を任せられます。
Claude Code は、どこで動いているのですか？
初期設定は自分のパソコンの中です。ほかに、Anthropic が用意したクラウドの環境で動かす方法や、自分のパソコンで動かしながらブラウザやスマホから操作する方法（リモートコントロール）もあります。どこで動かしても、考えて動いて確かめる流れは同じです。
前の会話で決めたことを、新しい会話でも守らせたいです
新しい会話は前の中身を覚えていないので、CLAUDE.md に書いておきます。毎回の会話の始めに読み込まれます。書き方は CLAUDE.md の書き方 を見てください。
まとめ
- Claude Code は 情報を集める→手を動かす→確かめる を、終わるまで繰り返す
- 考えるのはモデル、手を動かすのは道具。Claude Code はその2つをつなぐ仕組み
- 会話は保存され、ファイルの変更は Esc 2回で戻せる。ずっと守らせたい決まりは CLAUDE.md へ
出典
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。
