1. Claude Code とは？
Claude Code は Anthropic が開発した CLI AI コーディングアシスタントです。ターミナルで直接動作し、ファイルの読み書き、コマンド実行、Git 管理が可能 — 単なるコード補完ではなく、真の AI 開発エージェントです。
推定年間収益 25億ドル、最も急成長している AI 開発ツールです。並列 Sub-agents、完全な Hooks システム、CLAUDE.md 永続メモリ、Command → Agent → Skill オーケストレーションワークフローをサポート。
vs 他のツール
- 完全なターミナルアクセス
- 並列 Sub-agents
- 完全な Hooks システム
- CLAUDE.md メモリ
- 25億ドル収益（推定）
- IDE インライン補完
- インラインコード提案
- エージェント機能なし
- カスタム Hooks なし
- メモリシステムなし
- グラフィカル IDE
- ビルトイン AI チャット
- 限定的エージェント機能
- 無 Hooks 系統
- ネイティブオーケストレーションなし
2. コアアーキテクチャ：3つの C
Claude Code の拡張性は3つのコンポーネントに基づいています：Agents、Commands、Skills。
Agents エージェント
- カスタムモデル＆ツール
- バックグラウンド実行
- Hooks ライフサイクル
- Git Worktree 分離
- Skill プリロード
Commands コマンド
- /slash コマンドトリガー
- Context fork 分離
- モデル＆effort オーバーライド
- ツール権限制御
- Shell スクリプト埋め込み
Skills スキル
- パスマッチング自動ロード
- Agent プリロード
- 独立 fork 実行
- simplify / batch / debug
- loop スケジュール繰り返し
🤖 Agents — 16 Frontmatter フィールド
| フィールド | 型 | 説明 |
|---|---|---|
| name | string | 一意識別子（小文字+ハイフン） |
| description | string | いつ起動するか。 "PROACTIVELY" で自動起動 |
| tools | string/list | ツール許可リスト、 Agent(type) 構文サポート |
| disallowedTools | string/list | 継承リストから除外するツール |
| model | string | haiku、sonnet、opus 或 inherit |
| permissionMode | string | default、acceptEdits、dontAsk、bypassPermissions、plan |
| maxTurns | integer | 最大実行ターン数 |
| skills | list | 起動時にプリロードする Skill 名 |
| mcpServers | list | MCP サーバー接続 |
| hooks | object | ライフサイクル Hooks |
| memory | string | メモリスコープ：user、project、local |
| background | boolean | true でバックグラウンドタスクとして実行 |
| effort | string | low、medium、high、max |
| isolation | string | "worktree" で一時的な git worktree で実行 |
| initialPrompt | string | メインエージェントとして実行時に自動送信される最初のプロンプト |
| color | string | CLI 出力色（例： green、magenta） |
6 公式ビルトイン Agent
| # | Agent | モデル | ツール | 用途 |
|---|---|---|---|---|
| 1 | general-purpose | inherit | 全て | 複雜多步驟任務 — 預代理類型 |
| 2 | Explore | haiku | 読み取り専用 | 高速コード検索と探索 |
| 3 | Plan | inherit | 読み取り専用 | 実装前にの計画調査 |
| 4 | Bash | inherit | Bash | 独立 context でターミナルコマンド実行 |
| 5 | statusline-setup | sonnet | Read, Edit | 定狀態列 |
| 6 | claude-code-guide | haiku | Glob, Grep, Read, WebFetch, WebSearch | Claude Code 機能の質問に回答 |
⌨️ Commands — 13 Frontmatter フィールド
| フィールド | 型 | 説明 |
|---|---|---|
| name | string | 表示名と /slash-command ID |
| description | string | オートコンプリートに表示される説明 |
| argument-hint | string | オートコンプリート時の引数ヒント |
| disable-model-invocation | boolean | Claude の自動起動を防止 |
| user-invocable | boolean | false メニューから非表示 |
| paths | string/list | Glob パターンでロードタイミングを制限 |
| allowed-tools | string | 権限プロンプト不要のツール |
| model | string | 実行時に使用するモデル |
| effort | string | effort レベルをオーバーライド |
| context | string | fork 独立 subagent で実行 |
| agent | string | context: fork 時の subagent タイプ |
| shell | string | bash（預）或 powershell |
| hooks | object | このコマンド限定のライフサイクル hooks |
64 公式コマンド（カテゴリ別）
| # | コマンド | カテゴリ | 説明 |
|---|---|---|---|
| 1-3 | /login /logout /upgrade | Auth | アカウントログイン、ログアウト、プランアップグレード |
| 4-15 | /color /config /keybindings /permissions /privacy-settings /sandbox /statusline /stickers /terminal-setup /theme /vim /voice | Config | 主題、按鍵、權限、沙盒、語音等定 |
| 16-22 | /context /cost /extra-usage /insights /stats /status /usage | Context | Context 可視化、トークン使用量、分析 |
| 23-27 | /doctor /feedback /help /release-notes /tasks | Debug | 診断、バグ報告、バックグラウンドタスク管理 |
| 28-29 | /copy /export | Export | レスポンスをクリップボードにコピー、会話エクスポート |
| 30-37 | /agents /chrome /hooks /ide /mcp /plugin /reload-plugins /skills | Extensions | Agent、MCP、Plugin、Hooks 管理 |
| 38 | /memory | Memory | 編輯 CLAUDE.md メモリ檔、管理 auto-memory |
| 39-43 | /effort /fast /model /passes /plan | Model | モデル切替、effort 調整、Plan モード |
| 44-49 | /add-dir /diff /init /pr-comments /review /security-review | Project | 作業ディレクトリ、Diff ビューア、PR、セキュリティレビュー |
| 50-56 | /desktop /install-github-app /install-slack-app /mobile /remote-control /remote-env /schedule | Remote | Desktop App、Slack、GitHub、リモートコントロール、クラウドスケジューリング |
| 57-64 | /branch /btw /clear /compact /exit /rename /resume /rewind | Session | ブランチ、圧縮、巻き戻し、Session 管理 |
🧩 Skills — 13 Frontmatter フィールド
| フィールド | 型 | 説明 |
|---|---|---|
| name | string | 表示名と /slash-command ID |
| description | string | 自動発見用の説明 |
| argument-hint | string | オートコンプリート時の引数ヒント |
| disable-model-invocation | boolean | Claude の自動起動を防止 |
| user-invocable | boolean | false 非表示（agent プリロード専用） |
| allowed-tools | string | 権限プロンプト不要のツール |
| model | string | 実行時に使用するモデル |
| effort | string | effort レベルをオーバーライド |
| context | string | fork 独立 subagent で実行 |
| agent | string | context: fork 時の subagent タイプ |
| hooks | object | この skill 限定のライフサイクル hooks |
| paths | string/list | Glob パターンで自動ロードを制限 |
| shell | string | bash（預）或 powershell |
5 公式ビルトイン Skill
| # | Skill | 用途 |
|---|---|---|
| 1 | simplify | 変更コードのレビュー — リファクタリングで重複排除、品質向上 |
| 2 | batch | 複数ファイルにまたがるバッチコマンド実行 |
| 3 | debug | 失敗したコマンドやコードのデバッグ |
| 4 | loop | プロンプトを定期的に繰り返し実行（最大3日間） |
| 5 | claude-api | Claude API / Anthropic SDK でアプリ構築 |
3. Memory メモリシステム
CLAUDE.md は Claude Code の永続メモリです — 起動時に毎回ロードされ、プロジェクトの規約、設定、ワークフローを記憶します。
良い CLAUDE.md の書き方
CLAUDE.md は Claude Code の出力を改善する最も効果的な方法です：
- プロジェクト構造の説明
- コードスタイル規約
- よく使うコマンドとパス
- テスト＆デプロイワークフロー
- 個人設定は CLAUDE.local.md
3層ローディング機構
Claude Code は2つの方向でメモリをロードします：
- 上方向ロード — 起動時に上方向へ歩き、すべての CLAUDE.md をロード
- 下方向遅延ロード — サブディレクトリはアクセス時のみロード
- グローバル — ~/.claude/CLAUDE.md 全セッションに適用
- 同階層の兄弟ディレクトリはロードされません
Monorepo 構造例
├── CLAUDE.md ← 根層共用（啟動即ません）
├── frontend/
│ └── CLAUDE.md ← 前に端專屬（讀取時才ません）
├── backend/
│ └── CLAUDE.md ← 後に端專屬（讀取時才ません）
└── api/
└── CLAUDE.md ← API 專屬（讀取時才ません）
從 /mymonorepo/frontend/ から起動した場合：
✅ /mymonorepo/CLAUDE.md — 祖先目錄，啟動即ません
✅ frontend/CLAUDE.md — 當前に目錄，啟動即ません
❌ backend/CLAUDE.md — 不同分支，不ません
❌ api/CLAUDE.md — 不同分支，不ません
4. Hooks 確定的ガードレール
Hooks は agentic loop の外で実行される確定的スクリプトです — 特定のイベントでトリガーされ、安全ガードレールと自動化を提供します。
Hooks はツール操作が完了した後ににトリガーされます（PostToolUse）。操作前にではありません。PreToolUse は例外で、実行前ににインターセプトできます。
Agent がサポートする 6 種類の Hooks
PreToolUse
ツール実行の前にトリガー。操作のブロック、変更、ログが可能。
PostToolUse
ツール実行の後にトリガー。出力検証、linter 実行、通知送信。
Notification
Claude がユーザーの注意を必要とする時にトリガー。サウンド、デスクトップ通知に接続。
Stop
Agent がターンを完了した時にトリガー。最終チェックやクリーンアップ。
SubagentStop
Subagent 停止時にトリガー。子エージェントの結果を収集。
HTTP Hooks
HTTP POST で外部 webhook をトリガー、JSON payload サポート。
定範例
{
"hooks": {
"PostToolUse": [
{
"matcher": "Write|Edit",
"hooks": [
{
"type": "command",
"command": "npx eslint --fix $CLAUDE_FILE_PATHS"
}
]
}
],
"Notification": [
{
"hooks": [
{
"type": "command",
"command": "afplay /System/Library/Sounds/Glass.aiff"
}
]
}
]
}
}5. オーケストレーションワークフロー
Command → Agent → Skill は Claude Code のコアオーケストレーションパターンです。Command がフローを開始し、Agent が実行を担当し、Skill がドメイン知識を提供します。
例：天気システム
| コンポーネント | 役割 | 例 |
|---|---|---|
| Command | エントリーポイント、ユーザー操作 | /weather-orchestrator |
| Agent | プリロード skill でデータ取得 | weather-agent（weather-fetcher プリロード） |
| Skill | 独立したビジュアル出力 | weather-svg-creator |
実行フロー
// 用戶輸入
/weather-orchestrator
// Step 1: Command 詢問用戶偏好
├─ AskUser: "攝氏還是華氏？"
│ └─ 用戶: "攝氏"
// Step 2: Command 透過 Agent tool 呼叫 agent
├─ Agent tool → weather-agent
│ ├─ 預載 Skill: weather-fetcher（領域知識）
│ ├─ 從 Open-Meteo API 取得 → 26°C
│ └─ 回傳溫度值給 Command
// Step 3: Command 透過 Skill tool 呼叫 skill
├─ Skill tool → weather-svg-creator
│ ├─ 產出 → weather.svg（天氣卡片）
│ └─ 產出 → output.md（摘要）
// 完成
└─ 顯示結果給用戶
Agent Skill（預載）：agent の skills フィールドで注入、ドメイン知識として。
Skill（獨立）：Skill tool で独立して呼び出し、直接結果を出力。
6. 実践テクニック
Claude Code を日常的に使う実践的なテクニックで、開発効率を向上。
/context — Context 可視化
查看當前に context 使用量的彩色格狀圖。顯示哪些工具佔用最多空間，建議如何優化。
context: fork
在 command 或 skill 中 context: fork，讓它独立 subagent で実行，不污染主對話。
paths パスマッチング
用 paths 欄位定 glob 模式，讓 skill 只在操作特定檔案時自動ません。
Auto Mode
用 claude --enable-auto-mode で起動。バックグラウンド安全分類器が手動権限プロンプトを置き換え。
effort 調整
/effort low|medium|high|max で思考深度を調整。max は Opus 4.6 が必要。
/compact — 会話圧縮
context が満杯に近い時 /compact で圧縮。フォーカス指定可能：/compact API コンテンツを保持
よく使う CLI 起動フラグ
| フラグ | 短縮 | 説明 |
|---|---|---|
| --continue | -c | 最新の会話を続行 |
| --resume | -r | 特定 session を復元 |
| --model <NAME> | モデル指定（sonnet、opus、haiku） | |
| -p | 非対話モード出力（headless / SDK） | |
| --permission-mode | default、plan、acceptEdits、bypassPermissions | |
| --allowedTools | 権限プロンプト不要のツール清單 | |
| --add-dir <path> | 作業ディレクトリを session に追加 | |
| --worktree | git worktree で実行 | |
| --enable-auto-mode | Auto Mode を有効化（beta） |
7. インストールと開始
3ステップで Claude Code を始めましょう。
# 1. Claude Code をインストール
npm install -g @anthropic-ai/claude-code
# 2. プロジェクトディレクトリに移動
cd your-project
# 3. Claude Code を起動
claudeクイックリファレンス
🚀 基本操作
claude # 対話モードで起動
claude -c # 前回の会話を続行
claude -r # 指定 session を復元
claude -p "問題" # ワンショットQ&A
claude /init # CLAUDE.md を初期化⚙️ 高度な操作
claude --model opus # モデル指定
claude --worktree # Git worktree 分離
claude --enable-auto-mode # Auto Mode
/context # context 使用量を確認
/compact # 会話を圧縮
/effort max # 最大思考深度
初めて使う？まず claude /init を実行して CLAUDE.md を作成し、プロジェクト規約を書き込みましょう。
これが最も ROI の高いステップです — Claude があなたの設定を記憶し、会話のたびにより正確になります。