一行要約

Claude Code の用語定義集。紛らわしい対(subagent と agent team、CLAUDE.md と auto memory、permission mode と permission rule、command の3つの意味)を明示的に区別しているのが実用的な価値。

要点

混同しやすい対

区別
subagent / agent teamssubagent は単一セッション内で走り、親にだけ報告する。agent team はそれぞれが完全に独立したセッションで、直接話しかけられる
CLAUDE.md / auto memoryCLAUDE.md は自分が書く。auto memory は Claude が自分のために書く
permission mode / permission rulemode はセッションの基準線。rule はその上に重ねる細粒度の制御
output style / CLAUDE.mdoutput style は system prompt を改変する(既定の system prompt のソフトウェアエンジニアリング固有の部分を切る)。CLAUDE.md は system prompt の後の user メッセージとして届く
Remote Control / Claude Code on the webRemote Control はコードとファイルは自分のマシンのまま、インターフェースだけがリモート。web はクラウドのサンドボックスで走る
sandboxing / permission rulesandbox は OS レベルの隔離で、permission rule とは別のレイヤ
turn / session / agentic loopturn はClaude の1回の完全な応答(間に任意個のツール呼び出しを含む)。session は多数の turn からなる。agentic loop は 1つの turn の中で起きること

command という語は3つの無関係な意味を持つ:

  1. プロンプトで /name と打って起動する再利用可能な指示
  2. claude mcp add のような claude CLI のサブコマンド
  3. stdio MCP サーバ設定の command フィールド(サーバを起動する実行可能ファイル)

主要な定義(抜粋)

agentic harness — 言語モデルを有能なコーディングエージェントに変えるツール・context 管理・実行環境

Claude Code is the harness; Claude is the model inside it. Claude Code が harness であり、Claude はその中にいるモデルである。

agentic loop — gather context → take action → verify results → 完了まで繰り返す。hooks / skills / MCP といった拡張点は、このループの特定のフェーズに刺さる。

verification loop — セッションが「本当に終わった」と分かる仕組み。テストスイート、ビルド、スクリーンショット比較のようなClaude 自身が走らせられるチェックを与え、通るまで反復させる。

A verification loop is the prerequisite for /goal, unattended runs, and dynamic workflows: without one, the only thing deciding the agent is finished is the agent itself. 検証ループは /goal、無人実行、動的 workflow の前提条件である。それがなければ、エージェントが完了したと判断するのはエージェント自身だけになる。

auto mode — 別の分類器モデルがバックグラウンドで行動を審査する。

It never sees tool results, so injected instructions cannot influence its decisions. これは tool result を一切見ないため、注入された指示がその判断に影響することはない。

checkpoint — 送信したプロンプトごとに作られる復元点。git とは別で、Bash ツール経由の変更は追跡しない。

compaction古いツール出力が先に消され、次に会話が要約される。 プロジェクトルートの CLAUDE.md と auto memory は生き残ってディスクから再読み込みされる。

bundled skills/batch/code-review/debug/loop など。組み込みコマンドが固定ロジックを実行するのに対し、bundled skill は詳細なプロンプトを与えて Claude に統率させるので、エージェントを起こしたりコードベースに適応したりできる。

channel — 実行中のセッションにイベントを push する MCP サーバ。双方向にできる — Claude が受信イベントを読んで同じチャネルで返信する。Telegram / Discord / iMessage が research preview に含まれる。

settings layers(優先度の高い順): managed policy → コマンドライン引数 → .claude/settings.local.json.claude/settings.json~/.claude/settings.json配列はレイヤ間でマージされ、スカラーは上位が下位を上書きする。

project trust — ディレクトリの設定をロードする前に受け入れるダイアログ。ホームディレクトリだけは例外で、trust はそのセッション限りで、起動のたびにプロンプトが再表示される。

teleport/teleport でクラウドセッションをローカル端末に引き込む。逆方向は --cloud

dispatch — Claude モバイルアプリからコーディングタスクを送ると、デスクトップアプリで Claude Code セッションが起動する電話起点のタスクルータ。

surface — Claude Code にアクセスするあらゆる場所(CLI / VS Code / JetBrains / Desktop / claude.ai)。すべて同じエンジンを共有する。 ただしクラウドセッションはリポジトリの新しいクローンから始まり、自分のマシンの ~/.claude/ は読まないSlack と Chrome 拡張は surface ではなく、surface に接続する統合。

非推奨・改名された用語

旧称現在の呼び方備考
Headless modeNon-interactive mode同じ -p フラグ、同じ挙動
Custom commandsSkills.claude/commands/ のファイルは動き続ける
Slash commandsCommands製品文言から “Slash” が落ちた

そのまま使える具体例

用語から該当ドキュメントを引く索引:

agentic loop / agentic harness / turn / tool     → how-claude-code-works
CLAUDE.md / auto memory / rules                  → memory
context window / compaction                      → context-window
skill / bundled skills                           → skills
subagent / worktree isolation                    → sub-agents
agent teams                                      → agent-teams
hook                                             → hooks-guide, hooks
MCP / MCP server / MCP Tool Search / connector   → mcp
permission mode / plan mode / auto mode          → permission-modes
permission rule / managed settings / settings layers → permissions
non-interactive mode / bare mode                 → headless
sandboxing / prompt injection / project trust    → claude-code-sandboxing, how-we-contain-claude
verification loop                                → claude-code-best-practices

原典で言及されている関連文書