背景

この連載では、Claude Codeの公式ドキュメントを1ページずつ読み解いていきます。公式ドキュメントは情報が網羅されている分、「結局どの機能を、どんな場面で使えばいいのか」は自分で考える必要があり、読むのに意外と時間がかかります。そこで、私が実務で使うために読み込んだ内容を「使う場面→実例コード」の順に整理して残していくことにしました。専門家の解説というより、一次情報を読んだ記録です。推測や動作を確認していない部分には、その都度そう書きます。

1. これは一言でいうと何か

このページの核は、Claude Code が agentic ループで動くという点です。タスクを渡すと、Claude は「コンテキストの収集 → アクションの実行 → 結果の検証」という 3 フェーズを、必要な回数だけ繰り返します。ツールを使って自分でファイルを読み、編集し、テストを走らせて確認する——この自律的な反復が、単発のコード生成や補完との違いです。このループは、推論するモデルとアクションを実行するツールの 2 要素で駆動され、その両者を束ねて言語モデルをコーディングエージェントに変える土台を、ページは agentic ハーネスと呼んでいます。本記事はその内部モデルと、うまく任せるための操作を扱います。

2. この理解が効く場面

このページは「使う機能」ではなく「動きの理解」です。理解が効くのは次のような場面です。

• 大きめの変更を任せるとき：ログインバグを修正して のように目的だけ渡す委譲スタイルが成り立つのは、Claude が自分で関連ファイルを検索・読解し、複数ファイルにまたがる編集を行い、テストで検証するからです。この前提を知っていると、指示の粒度を「どのファイルを読むか」ではなく「何を・どんな制約で」に寄せられます。
• 長いセッションで挙動が崩れてきたとき：会話が進むとコンテキストウィンドウ（会話履歴やファイル内容を保持する領域）が満杯になり、Claude は自動でコンパクト化（古い出力の整理・要約）します。このとき序盤の指示は失われることがあります。仕組みを知っていれば、永続的なルールを CLAUDE.md（毎セッションで読ませたい規約や指示を書くマークダウンファイル）に置く、という判断ができます。
• 破壊的な操作が不安なとき：チェックポイントと権限モードという 2 つの安全機構を知っていれば、任せてよい範囲を自分で調整できます（実例は次章）。

意識しなくてよいケース：一問一答の単純な調べ物や、1 ファイル内の小さな補完だけなら、ここまでの内部モデルを気にする必要はありません（根拠：ページ自身が「コードベースに関する質問はコンテキスト収集だけで済むこともある」とループの軽重に触れているため。粒度の判断は私見です）。

3. コード・コマンドの実例と解説

前提

このページはインストールや認証の手順を扱いません。第 1 回（クイックスタート）で claude が起動でき、プロジェクト内でセッションを開始している状態を前提とします。

なお、Claude が使う組み込みツールは、ページ上で大きく 5 つに分類されています。ファイル操作（読み取り・編集・作成）、検索（パターンや正規表現でのコード探索）、実行（シェルコマンド・テスト・git）、ウェブ（検索・ドキュメント取得）、コード インテリジェンス（型エラー表示や定義ジャンプ。専用プラグインが必要）です。以下のコマンドは、これらのツールを Claude に自律的に使わせるうえでの「操縦桿」にあたります。

権限モードを切り替える

Shift+Tab

権限モードを順に切り替えます。既定では Claude はファイル編集やシェルコマンドの前に毎回確認します。切り替えると「自動受け入れ編集」「Plan Mode（読み取り専用ツールだけを使い、実行前に承認できるプランを作る）」などに変わります。任せる範囲を広げたいとき、逆に慎重に進めたいときに使います。

変更を巻き戻す

Esc Esc

Esc を 2 回押すと、直前のファイル変更を巻き戻せます。Claude はファイルを編集する前にスナップショットを取っているため、すべてのファイル編集は可逆です。ただしこのチェックポイントはセッション内ローカルで git とは別物、かつファイル変更のみが対象です。データベースや API など外部への副作用は巻き戻せません（だから Claude は外部に影響するコマンドの前に確認します）。

コンテキストの中身を確認する

/context

いまコンテキストウィンドウを何が消費しているかを表示します。セッションが長引いて応答が鈍い・指示を忘れていそう、と感じたときの確認に使います。MCP（外部サービスと接続する仕組み）のツール定義ごとのコストは /mcp で確認できます。

具体的に指示する

チェックアウトフローは期限切れのカードを持つユーザーに対して壊れています。
src/payments/ で問題を確認してください。特にトークン更新。
最初に失敗するテストを書いて、その後修正してください。

対象ファイル、制約、進め方（先に失敗するテストを書く）を最初に添えた例です。ページによれば、曖昧なプロンプトでも動きはしますが、こうして具体的に書くほど操舵の手間が減り、最初の試みで成功しやすくなります。

複雑な問題では、Shift+Tab を 2 回押して Plan Mode に入り、コードを読ませてプランを作らせてから実装させる方法も紹介されています（例：src/auth/ を読んで（中略）プランを作成してください）。この他のヒントや /model（モデル切り替え）、/init・/doctor などのコマンドは公式参照とします。

4. まとめと次回予告

• Claude Code の中身は「収集 → 実行 → 検証」を繰り返す agentic ループ。だから目的だけ渡す委譲が成り立ちます。
• 実務で効くレバーは、権限モード（Shift+Tab）、巻き戻し（Esc 2 回）、コンテキスト確認（/context）の 3 つです。
• 長いセッションでは、会話履歴に頼らず永続的なルールを CLAUDE.md に置くのが定石です。

次回予告：具体的なタスクを手順で追う「一般的なワークフロー」を取り上げます。

関連ページ（本記事で触れた概念の詳細）：CLAUDE.md・自動メモリ →「メモリ」、権限モードの詳細 →「権限」、セッションの再開・フォーク →「セッションを管理する」、スキル・MCP・フック・subagent →「Claude Code を拡張する」。

---

本記事は執筆時点の公式ドキュメント（Claude Code の仕組み）に基づきます。最新の情報は公式ドキュメントをご確認ください。