Claude Code Knowledge

Claude Code Knowledge

Claude Code CLI（v2.1.81 対応）の仕様と使い方に関する知識を提供します。

公式ドキュメント: https://code.claude.com/docs/en/

概要

• 正式名称: Claude Code
• 開発元: Anthropic
• インストール: 公式インストーラーを使用（npm は非推奨、後述）
• 起動: claude
• ライセンス: 有料プラン必須

モデル

重要: 上記以外のモデル（Opus 4/4.1 含む）は利用価値なし。Opus 4/4.1 は非推奨化済み。

モデルエイリアス

1M コンテキスト

opus[1m]、sonnet[1m] で 1M トークンコンテキストが利用可能。 ただし、トークン消費が大幅に増加するため、通常は無効化を推奨:

export CLAUDE_CODE_DISABLE_1M_CONTEXT=1

Max、Team、Enterprise プランで利用可能。Pro は追加使用量が必要。

サブエージェントの model フィールド

• opus: Opus 4.6 を使用（デフォルト）
• sonnet: Sonnet 4.6 を使用（高速・コスト効率推奨）
• haiku: Haiku 4.5 を使用（軽量タスク向け）
• inherit: 親から継承

プラグイン構造

公式ドキュメント: https://code.claude.com/docs/en/plugins

{plugin-name}/
├── .claude-plugin/           # メタデータ（必須）
│   └── plugin.json          # マニフェスト（必須）
├── commands/                 # スラッシュコマンド
│   └── {command}.md
├── agents/                   # サブエージェント
│   └── {agent}.md
├── skills/                   # スキル
│   └── {skill-name}/
│       └── SKILL.md
├── hooks/                    # イベントフック
│   └── hooks.json
├── settings.json             # プラグイン同梱設定（v2.1.49+）
├── .mcp.json                 # MCP サーバー設定
└── .lsp.json                 # LSP サーバー設定

重要: .claude-plugin/ には plugin.json のみ配置。他コンポーネントはルートレベル。

plugin.json スキーマ

{
  "name": "plugin-name",           // 必須: 識別子（kebab-case）
  "version": "1.0.0",              // セマンティックバージョン
  "description": "説明",
  "author": {
    "name": "Author Name",         // author 指定時は name 必須
    "email": "email@example.com",
    "url": "https://..."
  },
  "homepage": "https://...",
  "repository": "https://...",
  "license": "MIT",
  "keywords": ["tag1", "tag2"],
  "commands": "./commands/",       // カスタムパス指定可
  "agents": "./agents/",
  "skills": "./skills/",
  "hooks": "./hooks/hooks.json",
  "mcpServers": "./.mcp.json",
  "lspServers": "./.lsp.json"
}

プラグインシステム更新

スラッシュコマンド定義

公式ドキュメント: https://code.claude.com/docs/en/slash-commands

スキルとの統合（v2.1.3+）

v2.1.3 以降、スラッシュコマンドとスキルが統合:

• SlashCommand ツールは Skill ツールに統合
• /skills/ ディレクトリ内のスキルがスラッシュコマンドメニューに自動表示
• user-invocable: false でメニューから非表示に設定可能
• スキルは自動トリガーと明示的呼び出しの両方に対応

保存場所

ファイル形式

ファイル名がコマンド名になる（例: commit.md → /commit）

---
allowed-tools: Bash(git add:*), Bash(git status:*), Bash(git commit:*)
argument-hint: [message]
description: Git コミットを作成する
model: claude-haiku-4-5-20251001
disable-model-invocation: false
context: fork
---

# コマンド本体

$ARGUMENTS

フロントマターオプション

引数の取得

# 全引数
$ARGUMENTS

# 位置引数
PR #$1 をレビュー（優先度: $2、担当: $3）

動的コンテキスト埋め込み

構文:

• Bash コマンド実行: ! + バッククォートで囲んだコマンド（例: ! + `git status`）
• ファイル参照: @/path/to/file.ts

重要: !プレフィックス記法はスラッシュコマンド（commands/*.md）でのみ有効です。スキルファイル（SKILL.md）では使用できません。

新スラッシュコマンド

サブエージェント定義

公式ドキュメント: https://code.claude.com/docs/en/sub-agents

注意: v2.1.63 で Task ツールは Agent ツールにリネームされました。旧 Task(...) 構文は互換性のため動作しますが、新規定義では Agent を使用してください。

---
name: agent-name
description: いつ呼ばれるかの説明
tools: Read, Glob, Grep, Bash     # 省略時は全ツール継承
model: sonnet                      # haiku | sonnet | opus | inherit
effort: high                       # low | medium | high | max（v2.1.80+）
background: true                   # バックグラウンド実行（v2.1.49+）
memory: project                    # user | project | local（永続メモリ）
isolation: worktree                # ワークツリー分離
permissionMode: default            # default | permissive | strict（v2.0.43+）
maxTurns: 10                       # 最大ターン数
skills: skill1, skill2
mcpServers:                        # サブエージェント固有 MCP
  - server1
disallowedTools:                   # 禁止ツールリスト（v2.0.30+）
  - write_file
hooks:                             # エージェント固有フック（v2.1.0+）
  PreToolUse:
    - command: "validate.sh"
  Stop:
    - type: prompt
      prompt: "レビューを実行"
---

# システムプロンプト

エージェントへの指示をここに記述。

tools フィールド

• 省略: 親の全ツール + MCP ツールを継承
• 指定: 制限（例: Read, Glob, Grep）

model フィールド

新フィールド

permissionMode フィールド（v2.0.43+）

サブエージェントのスコープ（優先順位）

1. CLI --agents フラグ（現在のセッションのみ）
2. .claude/agents/（プロジェクトレベル）
3. ~/.claude/agents/（ユーザーレベル）
4. プラグインの agents/ ディレクトリ（プラグインレベル）

スキル定義

公式ドキュメント: https://code.claude.com/docs/en/skills

SKILL.md フォーマット

---
name: skill-name                    # 必須: 小文字、数字、ハイフンのみ（最大64文字）
description: スキルの説明            # 必須: いつ使うか明記（最大1024文字）
allowed-tools: Read, Grep, Glob     # オプション: 使用可能ツール制限
context: fork                       # オプション: サブエージェントとして実行（v2.1.0+）
agent: custom-agent                 # オプション: 実行エージェント指定（v2.1.0+）
user-invocable: true                # オプション: スラッシュメニュー表示制御（v2.1.3+）
effort: high                        # オプション: effort レベル（v2.1.80+）
hooks:                              # オプション: スキル固有フック（v2.1.0+）
  PreToolUse:
    - command: "validate.sh"
---

# スキル名

## Instructions
明確なステップバイステップの指示

## Examples
具体的な使用例

重要: フロントマターは必ず1行目から --- で開始（空行不可）

フォークコンテキスト（v2.1.0+）

context: fork を指定すると、スキルが独立したサブエージェントとして実行:

• メインの会話コンテキストを汚染しない
• トークン消費を抑制
• 複雑なスキルの干渉を防止

エージェントチーム（実験的、v2.1.32+）

有効化

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

概要

複数の Claude Code インスタンスが協調して作業するチーム機能。

CLI フラグ

# チーム有効化
claude --team

# チームメイトモード指定
claude --teammate-mode auto|in-process|tmux

# カスタムサブエージェントを動的定義
claude --agents '{"name":"reviewer","description":"コードレビュー"}'

アーキテクチャ

• チームリーダー: タスクの分配と調整を担当
• 共有タスクリスト: TaskCreate/TaskUpdate で全メンバーがタスクを共有
• 直接メッセージング: エージェント間で情報を直接交換

バックエンド

• tmux をバックエンドとして使用
• 各エージェントが独立した tmux セッションで実行
• リーダーが全セッションを監視・調整

バックグラウンドエージェント強化

バックグラウンド化

• Ctrl+B: 全フォアグラウンドタスクをバックグラウンド化
• & プレフィックス: バックグラウンドタスクとして開始

background: true エージェントフィールド（v2.1.49）

エージェント定義に background: true を指定すると、常にバックグラウンドで実行:

---
name: background-worker
description: バックグラウンドで実行するワーカー
background: true
---

キャンセルとクリーンアップ

• ESC でキャンセル時もバックグラウンドエージェントは継続
• Ctrl+F（2回）で全バックグラウンドエージェントを終了

Git Worktree サポート（v2.1.49）

CLI フラグ

# Worktree で起動
claude --worktree
claude -w

# 名前付き Worktree
claude -w my-feature

サブエージェント Worktree 分離

サブエージェントが独立した Worktree で作業可能:

• メインの作業ツリーに影響を与えない
• 並列作業の安全性を確保
• 完了時に結果をマージ

Worktree フック

セッションテレポート（v2.1.30+）

概要

CLI セッションをブラウザ（claude.ai/code）に引き継ぐ機能。

使い方

/desktop

または claude.ai/code でブラウザから継続。

リモートセッション

# Web セッションを作成
claude --remote

# Web セッションをローカルで再開
claude --teleport

iOS からのタスク委任

iOS デバイスからタスクを開始し、CLI で実行を継続可能。

自動メモリ（v2.1.32+）

概要

セッション中に学習した情報を自動的に記録・呼び出す機能。

エージェント memory フィールド

---
name: my-agent
memory: project    # user | project | local
---

永続メモリの種類:

• user: ユーザー全体で共有
• project: プロジェクト単位
• local: ローカルのみ

タスク管理システム（v2.1.16+）

依存関係追跡

• TaskCreate でタスクを作成
• TaskUpdate でステータス更新（pending → in_progress → completed）
• addBlocks/addBlockedBy で依存関係を設定
• TaskUpdate でタスク削除（status: "deleted"）

PR レビュー状況（v2.1.20+）

プロンプトフッターに PR ステータス表示

• PR の状態（open/closed/merged）を自動表示
• レビューコメント数、承認状態の確認

--from-pr フラグ

claude --from-pr 123

PR の内容をコンテキストとして読み込んで作業開始。

effort 制御

CLI フラグ

claude --effort low|medium|high|max

• low: 最小限の処理
• medium: 標準
• high: 詳細な分析・実装
• max: 最大限の推論（Opus 4.6 のみ）

フロントマター

スキルやサブエージェントに effort フィールドを設定可能（v2.1.80+）。

無効化

export CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1

構造化出力（v2.1.50+）

--json-schema フラグ

claude -p "タスク一覧を生成" --json-schema '{"type":"object","properties":{"tasks":{"type":"array"}}}'

JSON Schema によるバリデーション付き構造化出力を生成。

フック定義

公式ドキュメント: https://code.claude.com/docs/en/hooks

イベント一覧

基本構造

{
  "hooks": {
    "EventName": [
      {
        "matcher": "ToolPattern",
        "hooks": [
          {
            "type": "command",
            "command": "your-command-here",
            "timeout": 600,
            "once": true
          }
        ]
      }
    ]
  }
}

フックタイプ

// Command: シェルコマンド実行
{ "type": "command", "command": "bash-command" }

// Prompt: LLM 評価
{ "type": "prompt", "prompt": "LLM に送信するプロンプト" }

// Agent: サブエージェント実行
{ "type": "agent", ... }

環境変数

CLI フラグ・サブコマンド

主要フラグ

サブコマンド

権限設定

公式ドキュメント: https://code.claude.com/docs/en/permissions

基本構造

{
  "permissions": {
    "allow": ["Tool1", "Tool2(pattern)"],
    "deny": ["Tool3"],
    "ask": ["Tool4"]
  }
}

権限モード

Permission Hook で自律動作

フックで権限判定を自動化:

{
  "hooks": {
    "PermissionRequest": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "echo '{\"permissionDecision\": \"allow\"}'"
          }
        ]
      }
    ]
  }
}

コンテンツレベル要求の優先度

コンテンツレベルの権限要求は設定レベルの許可より優先される。

MCP（Model Context Protocol）

MCP 管理コマンド

# サーバー追加
claude mcp add <name> <command>

# サーバー一覧
claude mcp list

# サーバー削除
claude mcp remove <name>

Tool Search デフォルト Auto（v2.1.7）

MCP ツールの検索がデフォルトで自動モードに。

claude.ai MCP コネクタ（v2.1.46）

claude.ai から MCP サーバーに接続可能。

OAuth クライアント資格情報（v2.1.30）

MCP サーバーの認証に OAuth クライアント資格情報フローを使用可能。 CIMD（Client ID Metadata Document）/ SEP-991 に対応。

MCP ツールレンダリング改善（v2.1.81）

Read/Search 系ツール呼び出しが単一行「Queried {server}」に折りたたみ表示。 Ctrl+O で詳細を展開可能。

Plan モード改善

計画がファイルに保存

• Plan モードで作成した計画がファイルに保存される
• 後から参照・編集可能

受け入れ時にコンテキストリセット

• 計画を承認すると新しいコンテキストで実行開始
• 不要な履歴を引き継がない

設定オプション

LSP サーバー定義

公式ドキュメント: https://code.claude.com/docs/en/lsp

有効化

export ENABLE_LSP_TOOL=1

設定ファイル

.lsp.json:

{
  "typescript": {
    "command": "typescript-language-server",
    "args": ["--stdio"],
    "file_extensions": ["ts", "tsx", "js", "jsx"]
  }
}

Vim モーション（v2.1.0+）

/vim

名前付きセッション（v2.0.64+）

/rename my-feature-session

v2.1.41 以降、引数なしで自動生成:

/rename

インストール

公式インストーラー（推奨）

公式サイトからインストーラーをダウンロードして使用。

npm（非推奨、v2.1.15）

npm install -g @anthropic/claude-code

v2.1.15 以降、npm インストールは非推奨化。

環境変数

モデル制御

機能制御

システム

破壊的変更

npm インストール非推奨化（v2.1.15）

• npm install -g @anthropic/claude-code は非推奨
• 公式インストーラーの使用を推奨

Task → Agent リネーム（v2.1.63）

• Task ツールは Agent ツールにリネーム
• 旧 Task(...) 構文は互換性のため動作
• 新規定義では Agent を使用

Opus 4.6 最大出力トークン拡張（v2.1.77）

• 64k → 128k に拡張

ANTHROPIC_SMALL_FAST_MODEL 非推奨化

• ANTHROPIC_SMALL_FAST_MODEL は非推奨
• ANTHROPIC_DEFAULT_HAIKU_MODEL を使用

OAuth URL 変更（v2.1.7）

• 認証 URL が変更
• 旧 URL はリダイレクトで対応

Opus 4.6 でプリフィル削除

• Opus 4.6 ではレスポンスのプリフィルが削除
• より自然な応答生成

Opus 4/4.1 非推奨化

• 旧モデル（Opus 4、Opus 4.1）は非推奨
• Opus 4.6 への移行を推奨

マーケットプレイス

公式ドキュメント: https://code.claude.com/docs/en/plugin-marketplaces

開発・テスト

# ローカルプラグインをロード
claude --plugin-dir ./my-plugin

# 追加ディレクトリからプラグイン読み込み（v2.1.45+）
claude --add-dir ./additional-plugins

# 検証
claude plugin validate .
/plugin validate .

よくある質問

スキルが発動しない: claude --debug でログ確認。キャッシュクリア: rm -rf ~/.claude/plugins/cache

フックが動作しない: 設定変更後は新しいセッションを開始。タイムアウト値を確認。

プラグインが更新されない: plugin.json の version を更新（バージョン単位でキャッシュ）。

参考

• プラグイン公式ドキュメント
• プラグインリファレンス
• スラッシュコマンド
• サブエージェント
• スキル
• フック
• フック入門ガイド
• マーケットプレイス
• LSP
• 権限設定
• メモリ（CLAUDE.md/Rules）