ai-docs

Glossary

Properties1
tagsclaude-code, glossary, reference

原典: Glossary ／ 日本語版

一行要約

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 は Claude Code が Claude に与える指示を変え、既定のソフトウェアエンジニアリング向けの指示を置き換えうる。CLAUDE.md は既定の指示と並べてプロジェクトの context を足す。どちらも system prompt の一部ではなく、会話の中の system reminder として届く（下の定義）
Remote Control / cloud sessionRemote Control はコードとファイルは自分のマシンのまま、インターフェースだけがリモート。cloud session はクラウド基盤の上で走るので、ラップトップを閉じても走り続ける。「Claude Code on the web」は claude.ai/code のブラウザ surface だけを指す名前になった（下の改名表）
CLAUDE.md / AGENTS.mdどちらも自分が書くプロジェクト指示。CLAUDE.md が無くて AGENTS.md があれば、後者がそのまま読まれる（v2.1.277 以降）。両方読むか CLAUDE.md だけにするかは /config の Project instructions で選ぶ
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 — 別の分類器モデルが自分の代わりに行動を審査する permission mode。v2.1.283 以降は、対話ターミナルと VS Code のセッションの組み込みの開始モード（それより前の版では Pro / Max / Team だけ）。分類器が止めるのは scope escalation・信頼できないインフラ・prompt injection の3つで、明示的な ask ルールに当たる行動は今までどおり確認される。

Tool results are stripped from what it sees, so hostile content in a file or web page can’t manipulate it directly.

分類器が見るものからは tool result が取り除かれているので、ファイルや web ページに潜む敵対的な内容が分類器を直接操ることはできない。

prompt injection への備えは分類器だけではない。 auto mode はサーバ側の probe が tool result を怪しい内容がないか走査するのと、上の分類器が tool result 抜きで審査するのを重ねている。

artifact — セッションから claude.ai の非公開 URL に publish される、動く web ページ。端末のテキストを読む代わりに、出力を目で見たり人に渡したりできる。publish し直すと同じ URL が更新される。共有の選択肢はプランで違う（原典はプランごとの内容を artifacts の文書に任せている）。

effort level — モデルが各ステップで考えるかどうか・どれだけ考えるかを自分で決める adaptive reasoning の設定。高いほど thinking token が増えて推論が深くなり、低いほど速く安い。対応するのは Fable 系、Opus 4.6 以降、Sonnet 4.6 以降。

system prompt — Claude Code が毎回のリクエストで会話の前に送る指示（ツールの使い方・安全な振る舞い・応答の形式）。--append-system-prompt で足し、--system-prompt で置き換える。prompt cache の最初の層。

system reminder — harness としての Claude Code が、Claude に context を与えるために会話へ差し込むメッセージ。自分で送るものではない。system reminder として届くもの: CLAUDE.md、output style の指示、hook が additionalContext で返したテキスト、使える skill の一覧、前に読んだファイルがディスク上で変わったという知らせ、コミットと PR の帰属行。ログに残る API リクエストでは、user メッセージの中の <system-reminder> タグとして（モデルによっては system ロールの別メッセージとして）現れる。

transcript — セッションの保存された記録（以前の取得で項目が足された）。会話は自分と Claude がやりとりするもの、transcript はそれをファイルとして残したもので、既定では ~/.claude/projects/<project>/<session-id>.jsonl。再開するとき Claude Code はこのファイルを読み戻す —— セッションが終わっても会話を続けられるのはこのため。

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。配列はレイヤ間でマージされ、スカラーは上位が下位を上書きする。

auto memory — Claude が自分の訂正・好みをもとに書き溜めるノート。git リポジトリごとに ~/.claude/projects/ の下に置かれ、同じリポジトリの worktree は1つのディレクトリを共有する。毎セッションの頭で読まれるのは MEMORY.md の索引の先頭 200 行または 25 KB まで。

project trust — ディレクトリの設定をロードする前に受け入れるダイアログ。ホームディレクトリだけは例外で、trust はそのセッション限りで、起動のたびにプロンプトが再表示される。信頼するまでは、リポジトリが供給する内容の一部が差し止められる —— .claude/settings.json の project allow ルールや marketplace など。

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 フラグ、同じ挙動
Web session / あらゆるクラウドセッションを指す「Claude Code on the web」Cloud session「Claude Code on the web」は claude.ai/code のブラウザ surface だけを指す名前になった
Custom commandsSkills.claude/commands/ のファイルは動き続ける
Slash commandsCommands製品文言から “Slash” が落ちた

そのまま使える具体例

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

agentic loop / agentic harness / turn / tool     → how-claude-code-works
CLAUDE.md / AGENTS.md / auto memory / rules      → memory
context window / compaction                      → context-window
effort level / extended thinking                 → model-config, effort
skill / bundled skills                           → skills
subagent                                         → sub-agents
worktree isolation                               → worktrees
agent teams                                      → agent-teams
hook                                             → hooks-guide, hooks
MCP / MCP server / MCP Tool Search / connector   → mcp
permission mode / plan mode                      → permission-modes
auto mode                                        → permission-modes, claude-code-auto-mode
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

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

バックリンク