用語チートシート(試験直前確認用)
Claude Agent SDK
| 用語 / 値 | 意味・重要ポイント |
|---|---|
stop_reason: "tool_use" | ツール実行して次イテレーションへ継続 |
stop_reason: "end_turn" | ループ終了・最終レスポンス返却 |
PostToolUse フック | ツール結果を変換 / インターセプト。決定論的保証に使用 |
allowedTools: ["Task"] | コーディネーターがサブエージェントを生成するために必須 |
AgentDefinition | description・system prompt・tool restrictions でサブエージェントを定義 |
fork_session | 共有ベースラインから独立ブランチ作成 |
--resume <name> | 名前付きセッションを再開 |
MCP
| 用語 / 値 | 意味・重要ポイント |
|---|---|
| Tools | model-controlled。アクション実行(外部 API 等) |
| Resources | app-controlled。読み取り専用データ公開・コンテンツカタログ |
| Prompts | user-controlled。事前定義ワークフロー指示テンプレート |
isError フラグ | ツール失敗をエージェントに通知する MCP パターン |
errorCategory | transient / validation / permission / business |
isRetryable | transient: true、その他: false |
.mcp.json | プロジェクトスコープ(チーム共有) |
~/.claude.json | ユーザースコープ(個人・実験) |
Claude Code 設定
| パス / コマンド | 意味 |
|---|---|
~/.claude/CLAUDE.md | ユーザーレベル(バージョン管理外・全プロジェクト共通の個人設定) |
.claude/CLAUDE.md | プロジェクトレベル(バージョン管理・チーム共有) |
CLAUDE.local.md | プロジェクトローカル(gitignore 対象・個人 override) |
@ パス参照 | 外部ファイルを CLAUDE.md に参照(@./docs/api.md)。「@import」キーワードは不要 |
.claude/rules/ | YAML フロントマターの paths: または globs: で glob パターン条件付きロード |
.claude/commands/ | プロジェクトスコープのカスタムコマンド |
~/.claude/commands/ | ユーザースコープのカスタムコマンド |
.claude/skills/ | Skill ファイル(SKILL.md + frontmatter) |
.claude/hooks/ または settings.json | Claude Code ライフサイクルフック(PreToolUse・PostToolUse 等) |
context: fork | 独立サブエージェントで Skill を実行 |
allowed-tools | 指定ツールへの事前承認付与(プロンプト省略)。ブロック機能ではない |
argument-hint | / オートコンプリートメニュー用の表示専用ヒント文字列 |
disable-model-invocation | Skill の自動呼び出しを無効化(明示的に /skill-name でのみ実行) |
permissions.deny | 実際にツールをブロックする設定(.claude/settings.json 内) |
-p / --print | CI/CD 非インタラクティブモード(必須) |
--output-format json | JSON 形式で出力 |
--json-schema | JSON スキーマを指定 |
/memory | ロード中のメモリファイルを確認・デバッグ |
/compact | コンテキストを圧縮(要約に置き換え) |
/agents | サブエージェントの管理(一覧・作成・編集) |
/skill <name> | Skill の明示的呼び出し(disable-model-invocation Skill 用) |
Claude API
| 用語 / 値 | 意味 |
|---|---|
tool_choice: "auto" | ツールかテキストかモデルが自由選択(構造化保証なし) |
tool_choice: "any" | 必ずいずれかのツールを呼ぶ(ツール呼び出し保証) |
tool_choice: {type:"tool",name:"..."} | 特定ツールを強制実行 |
| Message Batches API | 50% コスト削減・最大 24 時間・SLA 保証なし・エージェンティックループ非対応(バッチ内では 1 往復のみ。tool_use 継続のループ展開不可) |
custom_id | バッチリクエスト / レスポンスの紐付けと失敗特定に使用 |
Last updated on