Claude Code スラッシュコマンド完全ガイド — /clear /help から /batch /simplify まで全コマンドの使い時を網羅

/help 🌱 初級

別名: なし

何をするか

使用可能なコマンドの一覧と、現在のセッション情報を表示する。

いつ使うか

新しいバージョンで追加されたコマンドの確認、特定キーワードのコマンドを探す時、初心者がまず最初に叩くべきコマンド。

使用例

/help

/clear 🌱 初級

別名: /reset /new

何をするか

コンテキストを全削除して新規会話を開始する。CLAUDE.md は再読み込みされる。

いつ使うか

タスク切替時（記事執筆 → デプロイ作業など）／機密会話のリセット／コンテキスト過多でAI応答が鈍化した時。

注意点

同じセッションのまま情報を残しつつコンテキストを軽くしたいなら /compact を使うこと。/clear は完全リセットなので、続きをやりたい時は前会話を /resume で復帰可能。

/compact [instructions] 🌱 初級

別名: なし

何をするか

コンテキストを圧縮しながら会話を続行する。重要な推論結果・ルール・スキルは保持。引数で「何を残すか」を指示できる。

いつ使うか

長時間作業でコンテキスト70%超え（/context で確認）／トークン効率を上げたい時／UIが遅くなった時。

使用例

/compact
/compact 直近のテスト結果と決定事項だけ残して

保持される情報

直近タスクの進行サマリー、CLAUDE.md最初の5,000トークン、各スキル最初の5,000トークン（合計25,000トークン予算内）。

/resume [session] 🌱 初級

別名: /continue

何をするか

セッションIDまたは名前で過去会話を再開する。引数なしで対話的に選択できる。

いつ使うか

前日中断した機能開発の続き／複数並行タスク間の行き来／特定 PR・Issue 関連セッションへ戻る時。

使用例

/resume                       # 対話的に選択
/resume "feature/login"        # 名前で指定
/resume 2026-05-07-abc123      # セッションIDで指定

/exit 🌱 初級

別名: /quit

何をするか

Claude Code セッションを終了する。会話履歴は保存されるので /resume で再開可能。

いつ使うか

作業完了時／離席時／長時間放置を防ぐため。

注意点

未保存のファイル変更があると確認プロンプトが出る。バックグラウンドのジョブ（/loop や /schedule 経由）は停止しない点も覚えておこう。

/init 🌿 中級

別名: なし／スキルとして実装

何をするか

カレントディレクトリのリポジトリを Claude が自動探索して、プロジェクト概要・主要ディレクトリ・ビルド/テストコマンド・コーディング規約をまとめた CLAUDE.md を自動生成する。既に CLAUDE.md が存在する場合は確認した上で更新提案を出す。

いつ使うか

① 新規リポジトリで Claude Code を初めて起動した直後
② 大幅なフォルダ構成変更後（例: モノレポ化、Next.js → Astro 移行）
③ 引き継ぎプロジェクトを引き取った直後（依存関係・規約をClaudeに把握させたい）

使用例

# 新規プロジェクトでまず叩く
/init

# 既存 CLAUDE.md があれば「上書き or 追記？」と聞かれる
# 追記推奨（手書きの規約を残せる）

生成される内容（典型）

• プロジェクトの目的・技術スタック
• 主要ディレクトリの説明（src/, tests/, docs/ 等）
• package.json / Cargo.toml 等から検出したビルド・テスト・lintコマンド
• 検出されたコーディング規約（ESLint設定、Prettier設定、editorconfig）
• 環境変数の一覧（.env.example から検出）

落とし穴

大規模リポジトリだと node_modules や .git まで読みに行こうとして遅い場合がある。.claudeignore（Claude専用の除外設定）を先に置いておくと安全。生成された CLAUDE.md はあくまで初期版なので、人間が手で「禁止事項」「デプロイ先」「秘密情報の扱い」を追記すること。

/team-onboarding 🌳 上級

別名: なし

何をするか

チームに新しいメンバーが Claude Code を導入する時のセットアップアシスタント。.claude/ ディレクトリ以下のスキル・権限プロファイル・MCP設定を一括チェックし、不足しているものをガイド付きでセットアップする。

いつ使うか

新人エンジニアの初日／業務委託メンバーの参画時／自分でも久しぶりに触るプロジェクトの再キャッチアップ。

使用例

/team-onboarding

/branch [name] 🌿 中級

別名: /fork

何をするか

現在の会話の分岐点で新ブランチを作成・切替する。元会話は /resume で復帰可能。git のブランチとは独立した「会話のブランチ」だが、git worktree と組み合わせるとファイルレベルでも分岐できる。

いつ使うか

大きな変更前のセーフティネット／同じ状態から複数の実装方式を並行検証／失敗アプローチの放棄／PR レビュー対応で main 戻しと feature 続行を行き来する時。

使用例（A/Bテスト的な実装比較）

# 1. 認証実装で2つのアプローチを検証する場合
/branch "approach-A-jwt"
# Claude に「JWT ベースで実装して」と依頼
# 完成したらテスト → メモを残す

/resume    # 元の会話に戻る
/branch "approach-B-session"
# Claude に「セッションベースで実装して」と依頼
# こちらもテスト

# 2. 両方の実装を比較して良い方を採用
/resume   # 採用するブランチを選ぶ

実体験ベースの活用例

• UI コンポーネントのデザイン比較: ブランチA = グリッド、B = カルーセル、C = リスト の3パターンを同じセッションから派生させて、最終的にPMに見せる
• パフォーマンス最適化: ブランチA = メモ化、B = 仮想スクロール、C = サーバーサイドフィルタ。各ブランチで実測してベンチマーク比較
• マイグレーション戦略: ブランチA = ビッグバン、B = ストラングラーパターン で実装難易度を比較

注意点

会話のブランチは「Claude の頭の中の分岐」なので、ファイルシステムも分岐させたいなら git worktree add や git switch -c も併用する必要がある。/batch は内部で worktree を自動生成するので、本格的な並列作業はそちらを使う。

/rewind 🌿 中級

別名: /checkpoint /undo

何をするか

会話を任意のチェックポイント（過去のメッセージ）まで巻き戻す。それ以降の会話・ツール呼び出し・ファイル変更を取り消せる。チェックポイントは Claude が「区切りの良いタイミング」で自動作成 + ユーザーが手動指定もできる。

いつ使うか

Claudeが間違った方向に進み始めた時／リファクタが裏目に出た時／実験的変更を一気にロールバック／許可ダイアログで意図しないコマンドを承認してしまった時の救済。

巻き戻せる範囲・できないこと

戻せる:

• 会話履歴（メッセージとツール呼出ログ）
• Claude が Edit / Write ツール経由で行ったファイル編集
• 新規作成されたファイル（自動削除）
• ステージングされていない git 変更

戻せない:

• git commit 済みの履歴（git で戻す必要あり）
• git push でリモートに送信済みの内容
• 外部API への副作用（メール送信、Stripe決済、DB UPDATE など）
• rm で削除されたファイル（ゴミ箱に入っていない場合）
• 外部サービス（Slack投稿、X投稿、Webhook送信）の結果

使用例

/rewind                 # 直前のチェックポイントへ
/rewind 3               # 3ステップ前へ
/rewind "before-refactor"  # 名前付きチェックポイントへ

注意点

git管理下のファイルは git で戻せばいいが、未コミットの変更や設定ファイル変更は /rewind の出番。逆に「副作用のあるコマンド（メール送信、API呼出、DB書込）」は戻せないので、そういうリスクの高い操作の前には /branch でセーフティネットを張るのが鉄則。

/rename 🌿 中級

何をするか

現在のセッションに名前を付ける／変更する。/resume で対話的選択する時に識別しやすくなる。命名は半角英数+ハイフンが推奨（日本語も使えるがフィルタリングしづらい）。

いつ使うか

並行する作業セッションを区別したい時。「feature-auth」「bugfix-login」のように内容で命名／長期作業の途中保存版を識別／レビュー時に履歴を辿るためのインデックス。

命名のベストプラクティス

• feature-{機能名} — 新機能開発
• bugfix-{Issue番号} — バグ修正
• refactor-{対象モジュール} — リファクタリング
• research-{調査トピック} — 調査・PoC
• review-PR{番号} — PRレビュー

/sessions 🌿 中級

別名: /list

何をするか

過去のセッション一覧を表示する。直近100件がデフォルト、フィルタで期間・名前指定も可能。

いつ使うか

「先週やったあのセッション、なんて名前だっけ？」を探す時／使っていない古いセッションを整理する時／チームメンバーに過去の議論を共有する時。

使用例

/sessions                  # 直近100件
/sessions --since "2 weeks"  # 過去2週間
/sessions --filter "auth"    # 名前に "auth" を含むもの

並行セッション運用パターン 🌿 中級

パターン1: タスクごとに分離

# ターミナル1: 機能開発
claude
/rename feature-checkout

# ターミナル2: バグ修正（別ターミナル開いて）
claude
/rename bugfix-login-redirect

# ターミナル3: ドキュメント
claude
/rename docs-api-reference

# 各セッションは独立したコンテキスト
# /resume で行き来できる

パターン2: モデル使い分け

• セッションA: Opus + xhigh — 設計議論・難しいバグ調査
• セッションB: Sonnet + medium — 実装・テスト
• セッションC: Haiku + low — typo修正・インポート整理・docstring書き

こうすると「重い議論で詰まったらAに、軽作業はCに」と用途で分けられて、コストも品質も最適化される。

パターン3: タイムゾーン分離

夜の作業セッション（眠い・集中力低下）と朝の作業セッション（クリア）を分ける。/rename morning-{date} / night-{date} で識別し、朝のセッションには「夜のセッションで決めた事項を貼り直す」運用にすると判断ミスが減る。

/model [model] 🌱 初級

何をするか

使用するAIモデルを切り替える。引数なしで対話的に選択。

いつ使うか

高度な推論にはOpus／単純なテキスト編集にSonnet／コスト削減にHaiku。

使用例

/model                          # 対話的に選択
/model claude-opus-4-7          # 厳密にバージョン指定
/model sonnet                   # 短縮名
/model opus

/effort [level|auto] 🌳 上級

何をするか

推論レベルを low / medium / high / xhigh / max から設定する。auto で自動調整。

いつ使うか

複雑なバグ追跡に high/xhigh／ルーチン作業に low／重要レビューに max（セッション限定）。

使用例

/effort high
/effort auto

/fast 🌳 上級

何をするか

Fastモード（軽量モデル + 低effort）に一発で切り替えるショートカット。内部的には /model haiku + /effort low 相当。

いつ使うか

大量の単純編集／typo修正／インポート整理など、推論力よりスピード優先のタスク。100ファイル一括の lint 修正や、フォーマッタ的な書き換え作業。

体感差

通常モード（Sonnet + medium）と比較すると、応答速度は 3〜5倍速い。ただし複雑な意図を読む力は落ちるので、「Aの場合はXを、Bの場合はYを」のような条件分岐が必要なタスクには不向き。

/cost 🌿 中級

別名: なし

何をするか

現在のセッションでの API 使用コスト・トークン消費量を表示する。入力トークン／出力トークン／キャッシュヒット率／推定USD課金額を一覧化。

いつ使うか

長時間作業の中盤で「今日いくら使った？」を確認／/effort xhigh や /batch 多用後のコスト感確認／月末の予算管理／チームへの工数報告。

使用例

/cost                      # 現セッションのコスト
/cost --today              # 今日累計
/cost --week               # 過去7日

典型的な出力例

セッション統計（feature-checkout）:
  入力トークン:     458,231
  出力トークン:      82,415
  キャッシュ読込:   312,000 (68.0% ヒット率)
  推定コスト:        $2.84

今日の累計:         $7.91
今月の累計:        $89.34

節約のヒント

キャッシュヒット率が30%未満なら、/clear せずに同じセッションを使い続けることでヒット率が上がる。逆にコンテキストが乱雑になっているなら /compact で整理すると次から効率化される。

圧縮の優先順位（高→低） 🌿 中級

① 完全保持（圧縮されない）

• CLAUDE.md（プロジェクト + 親階層 + ホーム） — 最初の5,000トークン
• 有効化されているスキルの SKILL.md — 各5,000トークンまで
• システムプロンプト — Claude Code の動作定義
• 現在進行中のタスクのプラン

② 要約化される

• 過去のユーザーメッセージとClaudeの応答 — タスク単位でサマリー化
• ツール呼び出しログ — 「何をしたか」のリストに圧縮
• ファイル読込結果 — ファイル名と要点だけ残す

③ 直近データは原文保持

直近 10〜20 メッセージ程度（合計2万トークン目安）はそのまま残る。これにより「今やっている話」が途切れない。

④ 完全削除

• 一時的なエラーログ・冗長な出力
• 失敗した試行（成功したアプローチで上書き）
• 議論の脇道で却下された案

/context 🌿 中級

何をするか

コンテキスト使用状況を色付きグリッドで可視化する。CLAUDE.md／スキル／会話履歴／ツール定義の内訳と、最適化提案を表示。

いつ使うか

応答が遅い・精度が落ちたと感じた時／/compact を打つべきか判断する時／CLAUDE.md やスキルの肥大化チェック／チームメンバーに「自分のセッションどうなってる？」を見せる時。

表示の見方

• 緑のセル: 必須コンテキスト（システム、CLAUDE.md）— 削れない
• 青のセル: スキル定義 — 不要なら無効化で削減可能
• 黄のセル: ツール定義（MCPなど）— MCPサーバーを止めると減る
• 橙のセル: 会話履歴 — /compact の対象
• 赤のセル: 直近メッセージ — 削れない（圧縮後も残る）

全体の使用率がパーセント表示され、80%超でアラートが出る。

典型的な出力

Context: 142,680 / 200,000 tokens (71.3%)

Breakdown:
  System prompt:        4,200   (2.1%)
  CLAUDE.md (3 files): 12,500   (6.3%)
  Skills (8 active):   34,800  (17.4%)
  MCP tool defs:        8,200   (4.1%)
  Conversation:        78,980  (39.5%)
  Recent (raw):         4,000   (2.0%)

Recommendation: /compact を推奨（70%超）

注意点

70%を超えたら /compact、80%超なら別タスクは /clear + /resume で分離するのが目安。スキルが肥大化している場合は /skills で内訳を確認して不要なものを無効化する。

/memory 🌿 中級

何をするか

長期記憶（Auto Memory）の閲覧・編集・削除。プロジェクトを跨いで持続するルールやフィードバックの管理。実体は ~/.claude/projects/{project}/memory/MEMORY.md に保存される Markdown ファイル。

いつ使うか

過去の失敗を二度と繰り返さないようにルール化／個人の好みや禁止事項を恒久登録／プロジェクト固有のドメイン知識（ビジネスルール、命名規則）を蓄積。

使用例

/memory                       # 内容を表示
/memory edit                  # エディタで編集
/memory add "○○ルール"        # 1行追記
/memory clear "{パターン}"     # 該当行を削除

/permissions 🌿 中級

別名: /allowed-tools

何をするか

ツール使用権限を allow / ask / deny で管理する対話的UI。Bashコマンドの個別許可、ファイル書込先の制限などを設定。変更内容は .claude/settings.json または .claude/settings.local.json に保存される。

いつ使うか

新しいプロジェクトに入った時／頻繁に許可ダイアログが出る時／逆に危険なコマンドを deny したい時／MCP導入後の権限整理。

使用例

/permissions                # 対話的UI
/permissions allow Bash(git:*)
/permissions deny Bash(rm -rf:*)
/permissions list           # 現在のルール一覧

保存先の使い分け

• .claude/settings.json: チーム共有（git管理）
• .claude/settings.local.json: 個人のみ（gitignore推奨）
• ~/.claude/settings.json: 全プロジェクト共通の個人設定

/fewer-permission-prompts 🌳 上級

何をするか

過去の transcript をスキャンし、頻繁に許可した安全なコマンド（git status, ls など）を自動的にallowlistに追加する。プロジェクト .claude/settings.json に書き出すので、チーム全員が恩恵を受けられる。

いつ使うか

「またこの許可？」とウンザリしてきた時／チームに導入する初期セットアップ／使い込んでから1ヶ月後くらいの整理タイミング。

追加されるコマンドの例

• Bash(git status), Bash(git log:*), Bash(git diff:*)
• Bash(ls:*), Bash(pwd), Bash(cat:*)
• Bash(npm test), Bash(npm run build)（プロジェクトでよく使うものを検出）
• 頻繁に呼ばれているMCP read系ツール

注意点

追加対象はread-onlyコマンドに限定されるが、git diff などは状況によりプライベート情報を含むので確認すること。書込・削除系のコマンドは自動的に追加対象外。

additionalDirectories の使い方 🌿 中級

何をするか

権限ではないがセットで覚えておくべき設定。.claude/settings.json に additionalDirectories を書くと、Claude のアクセス可能ディレクトリを拡張できる。/add-dir のセッション限定版に対し、こちらは恒久設定。

使用例

// .claude/settings.json
{
  "additionalDirectories": [
    "../shared-lib",
    "../design-system",
    "/workspace/templates"
  ]
}

いつ使うか

モノレポで複数パッケージを横断する時／共通テンプレートを別フォルダで管理している時／設計ドキュメントが別リポジトリにある時。

MCP ツール権限の扱い 🌿 中級

仕様

MCP（Model Context Protocol）経由で追加されるツールも、通常のツールと同じ allow/ask/deny で制御できる。命名規則は mcp__{サーバー名}__{ツール名}。

例

{
  "permissions": {
    "allow": [
      "mcp__github__create_issue",     // Issue作成だけOK
      "mcp__github__list_issues"
    ],
    "ask": [
      "mcp__github__create_pull_request"  // PR作成は確認
    ],
    "deny": [
      "mcp__github__delete_repository"  // リポジトリ削除は絶対NG
    ]
  }
}

ベストプラクティス

新しい MCP サーバーを追加した直後は "ask": ["mcp__{サーバー名}__*"] でいったん全確認に。何度か使って安全だと判断できたものから個別に allow へ移していく。

/doctor 🌿 中級

何をするか

Claude Code のインストール・設定・依存関係を診断する。問題を検出するとレポート表示し、f キーで自動修正を試みる。

検査項目（典型）

• Claude Code バージョン — 最新かどうか
• Node.js バージョン — v18 以上必須
• 認証状態 — /login 済みか、トークンの有効期限
• ネットワーク — api.anthropic.com への到達性
• 権限プロファイル — 構文エラーがないか
• MCPサーバー — 全サーバーの起動・応答状態
• スキル定義 — SKILL.md の YAMLフロントマター構文
• CLAUDE.md — 巨大すぎないか、循環インポートがないか
• 権限設定 — .claude/settings.json の妥当性
• git設定 — git バイナリ存在、ユーザー設定
• ディスク容量 — セッション保存先に余裕があるか

自動修正で直るもの

• 古いバージョンのアップデート
• キャッシュ破損のクリア
• 設定ファイルの構文エラー修正
• MCPサーバーの再起動
• 権限プロファイルの正規化

自動修正できないもの

Node.js のバージョンアップグレード、ネットワーク到達性問題、認証情報の再発行、ディスク不足。これらは手動対応が必要。

いつ使うか

Claude Code が起動しない／MCPサーバーが繋がらない／予期しない挙動の原因切り分け／週次のメンテとして。

/debug 🌿 中級

何をするか

デバッグモードを有効化。内部ログ・APIリクエストの詳細・ツール呼び出しの中身・モデルへ送る完全なシステムプロンプトを表示する。

いつ使うか

「なぜClaudeがこのツールを呼ばなかったのか」「何のメッセージを送ったか」を調べたい時／スキルが期待通りに自動起動しない原因調査／MCP応答が遅い時のボトルネック特定。

典型的な問題パターン

• スキル description が曖昧 → Claude が「呼ぶべき場面」を判断できず無視される
• 権限ルールで blocked → ツール呼出が denied ログに残る
• MCPサーバーがタイムアウト → 30秒超で abort される
• コンテキスト溢れでツール定義が削られる → 一部ツールが「存在しない」状態になる
• JSON引数のパース失敗 → ツール呼出失敗、リトライループ

/status 🌿 中級

何をするか

現在のセッションの状態（モデル、effort、コンテキスト使用率、有効スキル、権限プロファイル、MCP接続状況、現在ブランチ、累計コスト等）を一覧表示。

いつ使うか

「あれ、今何のモデル使ってる？」と確認したい時／チームと作業状態を共有する時のスクリーンショット用／長時間セッション後の現状把握。

典型的な出力

Session: feature-checkout (renamed)
Model: claude-sonnet-4-7
Effort: medium
Context: 87,420 / 200,000 (43.7%)
Skills: 8 active (review, simplify, init, ...)
MCP: 3 connected (github, slack, postgres)
Branch: feature/checkout-flow
Working dir: /repo
Cost (this session): $1.84

/bug 🌳 上級

別名: なし

何をするか

Claude Code 本体のバグを Anthropic に報告する。現在のセッションのデバッグ情報（モデル、エラーログ、再現手順、環境情報）を自動収集してフィードバックフォームを開く。秘密情報は事前に確認画面で除外できる。

いつ使うか

Claude Code が落ちた／予期しないエラーが続く／公式ドキュメントと挙動が違う／MCP接続が再現性をもって失敗する。

注意点

送信前に 必ず収集データのプレビューを確認すること。CLAUDE.md にAPIキーをハードコードしている場合などは確実に弾く。秘密情報を含む場合は --no-context オプション付きで送信。

/diff [target] 🌿 中級

何をするか

Claude が直近で行ったファイル変更を、git diff 風のフォーマットで色付き表示する。+緑 = 追加、-赤 = 削除、コンテキスト行はグレー。

キーバインド一覧

• j / ↓ — 次の差分へ
• k / ↑ — 前の差分へ
• n — 次のファイルへ
• p — 前のファイルへ
• w — 単語単位差分に切替
• l — 行単位差分に切替（デフォルト）
• a — Apply（変更を確定）
• r — Reject（変更を取消）
• q — 終了

使用例

/diff                    # 直近の変更
/diff src/auth.ts        # 特定ファイルだけ
/diff --staged           # ステージ済み変更
/diff HEAD~3..HEAD       # 過去3コミットとの差分

/copy [options] 🌿 中級

基本

引数なしで直近のClaude応答全文をクリップボードへコピー。

オプション

• /copy — 直近の応答（デフォルト）
• /copy code — 直近の応答からコードブロックだけ抽出
• /copy --last 3 — 直近3応答をまとめてコピー
• /copy --to /tmp/output.md — クリップボードではなくファイルに書き出し
• /copy --format markdown — Markdown整形（デフォルト）
• /copy --format plain — プレーンテキスト
• /copy --format json — メタ情報付きJSON

典型的な使い方

• Claude が書いたコードを別エディタに貼る → /copy code
• 議論結果を Slack に共有 → /copy --last 5
• 長文応答を Markdown ファイル化 → /copy --to ./docs/decision.md

/vim 🌳 上級

別名: なし

何をするか

入力モードをVim風キーバインドに切り替える。i でインサート、Esc でノーマル、:wで送信など。

いつ使うか

普段Vim/Neovimユーザー／長文プロンプトを編集することが多い／マウス操作を最小化したい。

主要キーバインド

• i — インサートモード
• Esc — ノーマルモード
• dd — 行削除
• yy — 行ヤンク
• p — ペースト
• :w — 送信
• :q — キャンセル
• /, ? — 検索

/batch の内部処理ステップ 🌳 上級

ステップ1: タスク分解（Plan Phase）

Claude が指示を解析し、独立して実行可能な単位に分解する。例えば「全てのReactクラスコンポーネントを関数+Hooksに変換」なら、1ファイル = 1サブタスクとして洗い出す。
分解アルゴリズム: ① 影響ファイルを Grep で列挙 → ② 依存グラフを構築 → ③ 独立に並列化できる単位（リーフノード）から順に切り出し

ステップ2: worktree生成

各サブタスクに対して git worktree add で隔離されたワーキングコピーを作成。これにより並列実行してもファイル衝突しない。

ステップ3: 並列実行（Parallel Phase）

各 worktree で独立した Claude セッションを起動し、サブタスクを実行。デフォルトで5並列、--concurrency 10 で増減可能。

ステップ4: 統合（Merge Phase）

全サブタスク完了後、結果を1つのブランチにマージ。コンフリクトがあれば Claude が自動解決を試み、解決不能なら人間に問い合わせ。

ステップ5: 統合PR生成

gh pr create で統合PRを作成。本文には「分解したサブタスクの一覧 + 各サブタスクの差分サマリー」が自動記載される。

失敗時の再試行ロジック 🌳 上級

サブタスク失敗

1つのサブタスクが失敗しても全体停止しない。失敗したものだけ最大3回まで自動リトライ。3回失敗で放置。

3回失敗後

そのサブタスクは「failed」マークが付き、最終マージ時にスキップ。統合PR本文には「未完了タスク」セクションで明示される。

手動再開

/batch resume で失敗したサブタスクだけ再実行。/batch resume --task 7 で個別指定も可能。

完全中止

/batch abort で全 worktree を破棄。git の状態は /batch 開始前に戻る。

/batch <instruction> 🌳 上級

スキルとして実装

何をするか

複雑な変更を5〜30個のサブタスクに自動分解し、git worktreeで並列実行する。完了後に統合PRを生成。

いつ使うか

フレームワーク全置換（Vue 2 → Vue 3 など）／大型リファクタリング／全ファイルへの統一適用（lint修正、型注釈追加など）／単体テスト一括追加／ドキュメント全更新。

使用例

/batch すべてのReactクラスコンポーネントを関数コンポーネント+Hooksに変換
/batch すべてのモジュールにJSDocコメントを追加
/batch すべてのテストファイルをVitestからPlaywrightへ移行
/batch すべてのCSSファイルをCSS Modulesに変換

並列度のチューニング

/batch --concurrency 3 ...   # 軽め（CPU/メモリ節約）
/batch --concurrency 10 ...  # 全力（API課金が嵩むので注意）
/batch --dry-run ...         # 分解結果だけ見て実行しない

注意点

並列実行のためAPIコストが嵩む。事前に /effort medium で実行コストを抑え、--dry-run で分解結果を確認してから本実行するのが安全。PRはレビュー必須。

/simplify [focus] 🌳 上級

スキルとして実装

何をするか

最近編集したファイルを3つのレビューエージェントで同時分析。コード再利用・品質・効率の改善提案を返す。

いつ使うか

機能実装が一段落した時／PR提出前のセルフレビュー／コードの「におい」が気になる時／コードレビュー文化のないチームでの自己訓練。

使用例

/simplify
/simplify "重複コードに焦点"
/simplify --files src/auth/**
/simplify --severity high     # 重要な指摘のみ

自動ペース調整の仕組み 🌳 上級

判定要素

• 前回の結果（変化があったか、エラーだったか）
• 監視対象の性質（デプロイ → 5〜10分、CI → 30秒〜1分、長期トレンド → 数時間）
• API コストとキャッシュ効率（短すぎるとキャッシュヒット率が落ちる）
• 時間帯（業務時間 vs 深夜）

キャッシュ効率の重要性

同じプロンプトを繰り返すなら、Anthropic API のプロンプトキャッシュ（5分間有効）が効く間隔を選ぶのが理想。例えば「3分間隔」だと毎回キャッシュヒットして大幅にコスト削減。逆に「10分間隔」だとキャッシュ切れて全額課金。

停止条件の指定

/loop 3m "デプロイ状況を確認" --until "デプロイ完了"
/loop 1m "テスト結果を見る" --until "全グリーン"
/loop --max-iterations 20 ...

/loop [interval] [prompt] 🌳 上級

スキルとして実装

何をするか

指定間隔でプロンプトを繰返し実行する。間隔を省略するとClaudeが自動で適切なペースを判断。

いつ使うか

デプロイ完了の監視／CI/CDパイプライン状況の定期チェック／自動メンテナンスタスク／長時間実行ジョブの完了通知／競合プロダクトのアップデート監視。

使用例

/loop 5m "git pull && npm test を実行して結果を報告"
/loop "デプロイ状況を監視、完了したら通知"
/loop 1h "競合のXアカウントを確認して新着があれば要約"
/loop 30s "ローカルサーバーの応答を確認、5回連続失敗で通知"

/schedule [description] 🌳 上級

別名: /routines ／ スキルとして実装

何をするか

cronスケジュールでタスクを定期実行する設定。リモートエージェントとして動作するので、ローカルがオフでも実行される。

いつ使うか

毎朝9時にPRレビュー／毎週月曜にdependabotマージ／月初に売上レポート生成／日次バックアップ実行／週次のセキュリティスキャン。

使用例

/schedule "平日朝9時にdependabot PRをマージ"
/schedule "毎週金曜18時に今週のコミットを要約"
/schedule "毎月1日にcron式の月次レポートを作成しSlackに投稿"
/schedule list                        # 設定済みスケジュール一覧
/schedule disable {id}                # 一時停止
/schedule run {id}                    # 即時実行

注意点

リモート実行なので、機密情報やローカル限定リソースに依存するタスクは適さない。実行ログは /schedule logs {id} で確認可能。

例1: 大規模リファクタの完全自動化 🌳 上級

シナリオ

「すべてのコンポーネントを TypeScript に変換 → セルフレビュー → セキュリティチェック → PR作成」

連鎖

# 1. 並列でリファクタ実行
/batch すべての .jsx を .tsx にリネームし、型注釈を追加

# 2. 完了後、自動的にレビュー
/simplify --severity high

# 3. セキュリティチェック
/security-review

# 4. すべてOKなら統合PR（/batch が自動生成）
/review

例2: 朝のルーチン自動化 🌳 上級

シナリオ

「平日朝9時に、夜間のCI失敗を確認 → 自分担当の Issue を要約 → 今日のタスクをSlack投稿」

設定

/schedule "平日朝9時に、以下を実行:
1. /loop 'GitHub Actionsの過去24時間の失敗をリストアップ'
2. 自分にアサインされたopen Issueを取得
3. 今日のタスクを優先順位付きで整理
4. SlackのDMに投稿"

/batch <instruction> 🌳 上級

スキルとして実装

何をするか

複雑な変更を5〜30個のサブタスクに自動分解し、git worktreeで並列実行する。完了後に統合PRを生成。

いつ使うか

フレームワーク全置換（Vue 2 → Vue 3 など）／大型リファクタリング／全ファイルへの統一適用（lint修正、型注釈追加など）。

使用例

/batch すべてのReactクラスコンポーネントを関数コンポーネント+Hooksに変換

注意点

並列実行のためAPIコストが嵩む。事前に /effort medium で実行コストを抑え、PRはレビュー必須。

/simplify [focus] 🌳 上級

スキルとして実装

何をするか

最近編集したファイルを3つのレビューエージェントで同時分析。コード再利用・品質・効率の改善提案を返す。

いつ使うか

機能実装が一段落した時／PR提出前のセルフレビュー／コードの「におい」が気になる時。

使用例

/simplify
/simplify "重複コードに焦点"

/loop [interval] [prompt] 🌳 上級

スキルとして実装

何をするか

指定間隔でプロンプトを繰返し実行する。間隔を省略するとClaudeが自動で適切なペースを判断。

いつ使うか

デプロイ完了の監視／CI/CDパイプライン状況の定期チェック／自動メンテナンスタスク。

使用例

/loop 5m "git pull && npm test を実行して結果を報告"
/loop "デプロイ状況を監視、完了したら通知"

/schedule [description] 🌳 上級

別名: /routines ／ スキルとして実装

何をするか

cronスケジュールでタスクを定期実行する設定。リモートエージェントとして動作するので、ローカルがオフでも実行される。

いつ使うか

毎朝9時にPRレビュー／毎週月曜にdependabotマージ／月初に売上レポート生成。

使用例

/schedule "平日朝9時にdependabot PRをマージ"
/schedule "毎週金曜18時に今週のコミットを要約"

/review [PR] 🌳 上級

何をするか

PRをローカルでレビューする。差分を git から取得し、ロジック・テスト・命名・パフォーマンスを分析。

いつ使うか

同僚のPRのセルフチェック前／merge直前の最終確認／自分のPRを客観的に見直す。

使用例

/review              # 現在のブランチ
/review 123          # PR番号指定

/security-review 🌳 上級

何をするか

git diff から脆弱性を分析する。SQLインジェクション、XSS、認証バグ、シークレット漏洩、CSRF などを検出。

いつ使うか

本番デプロイ前の必須チェック／認証・課金まわりを触った後／外部ライブラリ更新後。

注意点

静的解析の代替ではなく、補完として使うこと。コミット前に git diff --staged で秘密情報も自分の目で確認を。

/ultrareview [PR] 🌳 上級

何をするか

クラウドsandboxで複数エージェントによる深度レビューを実行。実際にビルド・テスト・実行までして検証する。Pro/Max プラン対象。

いつ使うか

大規模PR（数千行）の最終承認前／ビルドが手元で重いプロジェクト／チームレビューの前段階フィルタとして。

/pr_comments [PR] 🌿 中級

別名: /pr-comments

何をするか

GitHub PR の既存コメント一覧を取得し、未対応のレビュー指摘を整理して表示する。インラインコメントとレビューコメントの両方をスレッド構造で表示。

いつ使うか

レビュー対応の整理／レビュアーからの指摘の抜け漏れチェック／古いPRを再開する時の状況確認。

使用例

/pr_comments              # 現在のブランチの紐づくPR
/pr_comments 123          # PR番号指定
/pr_comments --unresolved # 未対応のみ
/pr_comments --since "yesterday"  # 昨日以降のコメント

/mcp 🌿 中級

何をするか

MCP（Model Context Protocol）サーバーの管理。接続中のサーバー一覧、追加、削除、再接続。

いつ使うか

新しいMCPサーバーを追加／GitHub/Slack/DBなどの外部連携が動作不良／接続状態の確認。

使用例

/mcp                  # 一覧表示
/mcp add github       # GitHub MCP を追加
/mcp restart slack    # Slack MCP を再起動

/plugin 🌿 中級

何をするか

プラグイン（Claude Code拡張）の管理。インストール・有効化・無効化・更新。

いつ使うか

サードパーティ拡張の導入／マーケットプレイスからの検索／不要プラグインの削除。

/reload-plugins 🌿 中級

何をするか

プラグインをセッション再起動なしでリロード。開発中のプラグインの動作確認に。

いつ使うか

自作プラグインを開発中／プラグイン更新を即座に反映したい時／npm install したばかりのプラグインを認識させる時。

トラブル解決例

• 新しく npm install -g claude-plugin-foo したけどコマンドが出ない → /reload-plugins で認識
• SKILL.md を編集したけど反映されない → /reload-plugins で再読込
• 権限プロファイル変更が効かない → /reload-plugins で適用
• プラグインがクラッシュした → /reload-plugins で復旧（多くの場合）

認証方式の比較 🌿 中級

方式1: OAuth フロー（推奨）

/mcp authenticate github
# → ブラウザが開いてOAuth同意画面
# → 同意後、トークンが ~/.claude/mcp-credentials.json に暗号化保存
# → 以降は自動更新

メリット: トークン自動更新、権限スコープを最小化できる
デメリット: ブラウザが必要（SSH先では使えない）

方式2: APIキー直接設定

# .claude/settings.json に環境変数を参照
{
  "mcpServers": {
    "github": {
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

メリット: SSH/CI でも使える、シンプル
デメリット: トークン管理が手動、漏洩リスク

方式3: 環境ベース（CI/CD向け）

環境変数を直接 export してから claude 起動。CI/CD パイプラインや Docker コンテナで使う。

/add-dir <path> 🌿 中級

何をするか

セッションのアクセス対象ディレクトリを追加する。デフォルトでは現在のワーキングディレクトリ配下のみアクセス可能。

いつ使うか

モノレポで隣のパッケージを参照したい時／別プロジェクトのコードを参考にしたい時／共通テンプレートを別ディレクトリから読み込む時。

使用例

/add-dir ../shared-lib
/add-dir /workspace/templates

注意点

セキュリティ境界が広がるので、追加先のフォルダに秘密情報がないかは確認すること。

/skills 🌿 中級

何をするか

インストール済みスキルの一覧を表示。トークン消費量でソート可（t キー）、Spaceキーで表示モード切替。

いつ使うか

「あのスキル名なんだっけ？」を確認／重いスキルを特定して整理／チームへスキル一覧を共有。

/agents 🌿 中級

別名: /subagents

何をするか

定義済みサブエージェントの一覧表示・新規作成・編集・削除を対話的UIで行う。エージェント定義は ~/.claude/agents/ または {repo}/.claude/agents/ に Markdown で保存される。

いつ使うか

専門タスクのテンプレート化／チームでサブエージェントを共有／/batch で使うエージェントの整備／コンテキストを節約したい時。

使用例

/agents                    # 一覧
/agents create reviewer    # 新規作成
/agents edit reviewer      # 編集
/agents delete old-agent   # 削除
/agents test reviewer "このコードをレビューして"  # テスト実行

/hooks 🌿 中級

別名: なし

何をするか

設定済みフックの一覧表示・編集・テスト実行を行う対話的UI。フック定義は .claude/settings.json に格納される。

いつ使うか

コミット前自動lint／編集後フォーマット／Bashコマンド実行前のセキュリティチェック／作業終了時の通知。

使用例

/hooks list                  # 一覧
/hooks add                   # 対話的に追加
/hooks test PreToolUse       # 特定タイミングのフックをテスト

/login 🌱 初級

何をするか

Anthropicアカウントにサインインする。APIキーまたはOAuth経由。

いつ使うか

初回セットアップ時／別アカウントに切り替える時／認証エラーの再認証。

/logout 🌱 初級

何をするか

サインアウト。保存された認証情報を削除する。

いつ使うか

共有マシンからの離席時／アカウント切替の前段。

/upgrade 🌳 上級

別名: なし

何をするか

プランアップグレードのフローを起動。Free → Pro → Max の各プランへの移行をブラウザで完了させる。

いつ使うか

使用上限に達した時／/ultrareview など Pro/Max 限定機能を使いたい時／チームプランへ移行したい時。

プラン別の主な差

• Free: 基本機能、月間メッセージ上限あり、Sonnet/Haiku のみ
• Pro: 上限緩和、Opus 利用可、/ultrareview 利用可、優先処理
• Max: 大幅な上限緩和、最新モデル優先アクセス、SLA保証

/privacy-settings 🌳 上級

Pro / Max 限定

何をするか

プライバシー設定の管理。データ学習への利用可否、コードのアップロード設定、長期記憶の保存範囲などを制御する。

いつ使うか

機密プロジェクトでデータ学習をオプトアウトしたい／企業ポリシーに従って設定したい／個人情報の扱いを厳格化したい。

主な設定項目

• 会話データの学習利用 ON/OFF
• コードのクラウド送信 ON/OFF
• テレメトリ収集 ON/OFF
• 長期記憶の永続化 ON/OFF
• データ保持期間（30日 / 90日 / カスタム）

/app / /desktop 🌳 上級

macOS / Windows 限定

何をするか

デスクトップアプリ（Claude Desktop）との統合管理。CLI と Desktop アプリでセッションを共有したり、Desktop で開始した会話を CLI で続けたりする。

いつ使うか

外出先で iOS/Mac アプリで議論 → 帰宅して CLI で実装続行／Desktop の音声入力で書いたプロンプトを CLI で実行／複数デバイス間でコンテキストを引き継ぐ。

使用例

/app                     # アプリ統合の状態確認
/app sync                # Desktop ⇔ CLI の同期
/app open               # Desktop アプリで現在セッションを開く
/desktop notify        # Desktop アプリに通知を送る

連携①: コンテキスト診断 → 圧縮（/context → /compact） 🌳 上級

シナリオ

長時間作業で応答が鈍ってきた時の正しい対処。

手順

# 1. まず現状把握
/context

# 出力: Conversation 78,980 (39.5%) と判明
# まだ余裕あり、続行

# しばらく作業…

/context
# 出力: Conversation 158,920 (79.5%) になった

# 2. 圧縮実行
/compact 直近のテスト結果と決定事項を残して

# 3. 再確認
/context
# 出力: Conversation 38,420 (19.2%) に減少 ✓

連携②: エージェント + バッチ並列実行（/agents + /batch） 🌳 上級

シナリオ

大規模リファクタを「コード変換」「テスト追加」「ドキュメント更新」の3エージェントで並列実行。

手順

# 1. 専用エージェントを定義（事前準備）
/agents create code-converter      # 変換専門
/agents create test-writer         # テスト追加専門
/agents create doc-updater         # ドキュメント更新専門

# 2. /batch で各エージェントに役割分担
/batch すべてのクラスコンポーネントを変換せよ。
  - code-converter で実装変換
  - test-writer でテスト追加
  - doc-updater でドキュメント更新
  各タスクを並列実行

メリット

各エージェントが専門コンテキストで動くので、メインコンテキストが汚れず、品質も上がる。

連携③: デプロイ監視ループ（/loop でCI/CD監視） 🌳 上級

シナリオ

GitHub Actions でデプロイ実行 → 完了まで監視 → 完了時にSlack通知。

手順

# 1. デプロイ起動
gh workflow run deploy.yml --ref main

# 2. 監視ループ
/loop 30s "
  最新のdeploy.yml実行ステータスを確認:
  - in_progress → 経過時間を報告
  - completed (success) → Slack #deploys にSUCCESS通知してループ停止
  - completed (failure) → エラーログを抜粋してSlack通知して停止
" --max-iterations 60

連携④: スケジュール + カスタムコマンドで定期メンテ（/schedule + 自作スキル） 🌳 上級

シナリオ

毎週月曜朝に「dependabot PRをチェックし、安全なものだけマージ」を自動実行。

手順

# 1. カスタムスキルを作成
# .claude/skills/safe-deps-merge/SKILL.md
---
name: safe-deps-merge
description: dependabotの安全なPR（パッチアップデートのみ）を自動マージ
allowed-tools: Bash(gh:*), Bash(git:*)
---
# dependabot PR の安全マージ
1. `gh pr list --author "dependabot[bot]"` で取得
2. 各PRについて、パッチバージョンアップ（x.y.Z）のみ抽出
3. CIが通っているものだけ `gh pr merge --auto --squash`
4. マージ結果をSlackに報告

# 2. スケジュール登録
/schedule "毎週月曜朝9時に /safe-deps-merge を実行"

連携⑤: 大規模実装 → セルフレビュー → セキュリティ → PR（4段階フロー） 🌳 上級

シナリオ

機能実装からPR提出までを一気通貫で。

手順

# 1. ブランチ切ってセーフティネット
/branch "feature-payment"

# 2. 大規模実装
/batch Stripe決済を全エンドポイントに統合

# 3. セルフレビュー
/simplify --severity high

# 4. セキュリティチェック
/security-review

# 5. PRレビューシミュレーション
/review

# 6. すべてOKなら本物のPR
gh pr create

連携⑥: フック + コマンドで Tinker-Free 環境（/hooks + /lint） 🌳 上級

シナリオ

「ファイル編集 → 自動lint → 自動test → 失敗したら自動rewind」の完全ハンズフリー。

設定

// .claude/settings.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "npm run lint --silent" },
          { "type": "command", "command": "npm test --silent || echo 'TEST_FAILED'" }
        ]
      }
    ]
  }
}

動作

編集後に自動でlint+test実行 → 失敗ならClaude側に通知が届き、Claudeが自動で /rewind を提案。

連携⑦: モデル切替 + コスト監視（/model + /cost） 🌳 上級

シナリオ

難所だけ Opus に切り替え、終わったら戻す。コストを管理。

手順

# 1. 通常作業（Sonnet）
/model sonnet

# 2. 詰まったらコスト確認しながらOpusへ
/cost                # 現在 $0.45
/model opus
/effort xhigh

# 3. 難所突破

# 4. コスト確認
/cost                # 現在 $1.82（Opusで1.4ドル使った）

# 5. 通常モードに戻す
/model sonnet
/effort medium

連携⑧: ブランチでA/B検証（/branch × 2 で2パターン比較） 🌳 上級

シナリオ

同じ機能を2つのアプローチで実装し、計測して優れた方を採用。

手順

# 1. 開始点で名前を付ける
/rename payment-experiment

# 2. アプローチA
/branch "approach-A-stripe-elements"
# 実装してテスト・計測

# 3. 元に戻ってアプローチB
/resume payment-experiment
/branch "approach-B-stripe-checkout"
# 実装してテスト・計測

# 4. 比較
/resume approach-A-stripe-elements
# 結果メモ
/resume approach-B-stripe-checkout
# 結果メモ
# → 良い方をmainにマージ

連携⑨: PRレビュー対応のフルフロー（/pr_comments → /review → /security-review） 🌳 上級

シナリオ

レビュアーから指摘が来たPRに対応。

手順

# 1. 未対応コメントを取得
/pr_comments --unresolved

# 2. Claudeに指摘ごとに対応依頼
（指摘リストを見ながら一つずつ修正）

# 3. 修正後セルフレビュー
/review

# 4. セキュリティ系の指摘ならsecurityも
/security-review

# 5. 再度レビューを依頼
gh pr comment {PR番号} --body "修正完了です。再レビューお願いします"

連携⑩: 朝の習慣化（/schedule + /loop で起動ルーチン） 🌳 上級

シナリオ

毎朝 Claude Code を起動した時に、自動で前日の続きをサマリー表示。

手順

# 1. SessionStart フックを設定
// .claude/settings.json
{
  "hooks": {
    "SessionStart": [
      { "type": "command", "command": "echo '昨日の作業:' && /sessions --since yesterday" }
    ]
  }
}

# 2. /schedule で朝のレポート生成
/schedule "毎日朝8時に、過去24時間のコミット・PR・Issueをまとめてemailで送る"

Q1. コンテキストが急に消えた / 過去の会話が辿れない 🌱 初級

原因

誤って /clear を叩いた、別ターミナルで新セッションを始めた、セッションファイルが破損した。

解決

/resume 引数なしで対話的に過去セッションを選択。日付やキーワードで /sessions --filter。完全に消えた場合は ~/.claude/projects/{project}/sessions/ をローカルバックアップから復元。

Q2. 権限プロンプトが多すぎてストレス 🌿 中級

解決

/fewer-permission-prompts でread-onlyコマンドを自動allowlist化。それでも残るものは /permissions allow Bash(git:*) で個別追加。本当に困ったら --dangerously-skip-permissions でCLI起動（共有マシンでは絶対NG）。

Q3. モデル切替後に動作がおかしい 🌱 初級

原因

モデル変更直後はキャッシュが効かず、過去の会話の解釈が前モデルと変わる。

解決

/clear で新規セッションを開始。重要な背景は CLAUDE.md に書いておく。または /compact で履歴を整理してからモデル切替。

Q4. カスタムスキルが認識されない 🌳 上級

チェックリスト

1. パスは .claude/skills/{name}/SKILL.md か（個人なら ~/.claude/skills/）
2. YAMLフロントマターの構文が正しいか（インデント、コロン、引用符）
3. name が小文字+数字+ハイフンのみか
4. /skills で一覧確認
5. /reload-plugins で再読込
6. /doctor で構文エラー検査

Q5. Claudeが指示を無視する／違うことをする 🌿 中級

解決

① /debug でシステムプロンプトに何が送られているか確認
② CLAUDE.md と現在の指示が矛盾していないか
③ Plan mode（/plan）で計画を立てさせてから実行
④ /effort high でじっくり考えさせる
⑤ それでもダメなら /clear で新規セッション

Q6. APIコストが想定より高い 🌿 中級

解決

① /cost で内訳確認
② キャッシュヒット率が低ければ、長いセッションを維持して /compact 活用
③ /model haiku や /fast で軽作業を切り分け
④ /effort xhigh や max を放置していないか確認
⑤ /batch 多用なら --concurrency を下げる

Q7. MCPサーバーが繋がらない 🌿 中級

解決

① /mcp で接続状態確認
② /mcp restart {server} で再起動
③ 認証切れの可能性 → /mcp authenticate {server}
④ /doctor でMCPセクションのエラー確認
⑤ それでもダメなら設定ファイルを直接確認（.claude/settings.json）

Q8. /batch がコンフリクトで止まる 🌳 上級

解決

① /batch status でどのサブタスクで止まったか確認
② コンフリクトファイルを手動解決
③ /batch resume で再開
④ どうしても解けないなら /batch abort で全破棄、サブタスクを小さく分解して再実行

Q9. /rewind で戻したのに変な状態になっている 🌿 中級

原因

git管理外の変更や、/rewind 範囲外（外部API呼出、メール送信など）の副作用は戻らない。

解決

git stash で残った変更を退避 → 必要なものだけ git stash pop。外部副作用は手動でロールバック。

Q10. /compact で大事な情報が失われた 🌿 中級

予防

大事な情報は CLAUDE.md か /memory に書き出しておく。/compact 引数で明示的に保持指示「直近のSQL設計とビジネスルールを残して」と書く。

事後対処

圧縮前に戻すコマンドはない。/sessions から圧縮前のスナップショットを探す（あれば）。

Q11. /schedule で実行されるタスクが失敗している 🌳 上級

解決

① /schedule logs {id} でログ確認
② リモート実行なのでローカルパス・環境変数依存はNG
③ シークレット情報はAnthropicが管理する secret store を使う
④ /schedule run {id} で手動即時実行してデバッグ

Q12. /loop が止まらない 🌳 上級

解決

① Ctrl+C で中断
② /loop stop で全ループ停止
③ --until "条件" や --max-iterations N を最初から指定する習慣を

Q13. CLAUDE.md が肥大化して /context を圧迫している 🌿 中級

解決

① セクションを別ファイルに分割し、@docs/details.md でインポート
② プロジェクト全体に必要な情報だけ残し、固有スキルに移譲
③ 階層化（プロジェクト/サブディレクトリ別CLAUDE.md）で必要な時だけ読み込ませる

Q14. /init が古いプロジェクトで止まる・遅い 🌿 中級

解決

① .claudeignore を先に作成（node_modules, dist, .next, vendor 等を除外）
② リポジトリが巨大な場合は手動でCLAUDE.mdを書く方が早い
③ /init --shallow で軽量モード（トップレベルのみ解析）

Q15. アップデート後に既存の機能が動かない 🌿 中級

解決

① /release-notes で変更履歴確認（破壊的変更がないか）
② /doctor で診断・自動修正
③ ~/.claude/cache/ をクリア
④ プラグイン/スキルのバージョン互換性確認
⑤ 最終手段は /bug でAnthropicに報告