claude-code

@rules/routing.md

Claude Code スキル

<output_language>

ユーザー向けの成果物、保存されるアーティファクト、レポート、計画、生成されたドキュメント、要約、引き継ぎメモ、コミット／メッセージの草案、検証メモは、この正規のスキルファイルが英語で書かれていても、デフォルトで韓国語にしてください。

ソースコードの識別子、CLI コマンド、ファイルパス、スキーマキー、JSON/YAML のフィールド名、API 名、パッケージ名、固有名詞、引用されたソースの抜粋は、必要な言語または元の言語のまま保持してください。

ユーザーが明示的に別の言語を指定した場合、既存の対象アーティファクトの一貫性を保つために別の言語を維持する必要がある場合、または機械可読な契約で正確な英語のトークンが必要な場合に限り、別の言語を使用してください。ローカライズされたテンプレートや参照資料がある場合（例：*.ko.md または *.ko.json）、ユーザー向けのアーティファクトにはそちらを優先してください。

</output_language>

正とする情報源：https://code.claude.com/docs/en/cli-reference。

<instruction_contract>

フィールド	契約
意図	ユーザーが Claude Code を明示的に求めた場合に、安全な claude CLI 呼び出しを構築または説明します。
範囲	claude のコマンド構築、再開／セッションフラグ、権限モードの選択、ツール制限、認証ガイダンス、結果の要約を担当します。
優先順位	ユーザーの意図とローカルプロジェクトのルールを優先し、CLI フラグの正とする情報源はリンク先の Claude Code CLI リファレンスです。
根拠	コマンドの形式、CLI の出力、サポートファイルのガイダンス、および確認された警告／エラーに基づいて回答します。
ツール	ユーザーが CLI の実行を希望する場合に限りシェルを実行します。それ以外の場合は、コマンドを提示するか、別の方法に案内します。
出力	実行または推奨した正確なコマンドを示し、出力／警告を要約し、CLI のトークンはそのまま保持します。
検証	非対話型の実行で -p が使われていること、権限モードが要求された権限に合致していること、危険なバイパスに制限が設けられていることを確認します。
停止条件	要求されたコマンドを構築または実行し、その結果、警告、または阻害要因を報告した時点で終了します。

</instruction_contract>

デフォルト

パラメーター	デフォルト
モデルの選択	ユーザーが --model を明示的に求めない限り、Claude Code CLI のデフォルトを使用します
努力度	ユーザーが --effort を明示的に求めない限り、CLI のデフォルトを使用します
権限モード	--permission-mode default
ヘッドレスモード	-p / --print
CI／スクリプト実行	ローカルのフック、プラグイン、MCP、CLAUDE.md を無視するよう、--bare を追加します
再開対象	現在のディレクトリにある最新のセッションには claude --continue (-c) を使用し、ID または表示名で指定したセッションには claude --resume (-r) を使用します

明示的に求められない限り、モデルや努力度についてユーザーに質問しないでください。

ルーティング

claude CLI または独立した Claude Code セッションが実際に必要な場合に、このスキルを使用します。

• 範囲外の可能性がある依頼についてコマンドを構築する前に、rules/routing.md を読んでください。
• ユーザーが claude CLI 自体を必要とせず、一般的な文章作成、ドキュメントの整理、ローカルでの編集を求めている場合は、直接編集するか、別のスキルに案内してください。

例

このスキルを使用する例：

• 「Claude Code を使ってこのリポジトリをレビューし、リスクを要約してください。」
• 「claude を print モードで実行して、このアーキテクチャを分析してください。」
• 「前回の Claude Code セッションを再開して、パッチを仕上げるよう依頼してください。」
• 「auth-refactor claude セッションを再開して、次の修正を適用してください。」
• 「ローカルのフックを取り込まないよう、この CI ステップで claude --bare -p を使ってください。」

このスキルを使用しない例：

• 「このランブックを読みやすく書き直してください。」
• 「このリポジトリ用の新しいスキルを作成してください。」

境界の例：

• 「Claude Code の権限を調べて、その内容を説明してください。」 ユーザーが claude CLI の使用を希望している場合に限り、このスキルを使用してください。それ以外の場合は、調査またはドキュメントの直接作業に案内してください。

重要：プリントモード

非対話型の Claude Code 実行では、必ず -p / --print を使用してください。-p を付けずに位置引数でプロンプトを指定すると、代わりに対話型 REPL が起動するため、-p を省略したスクリプトは TTY を待ち続けて停止します。

# Non-interactive (headless / SDK)
claude --permission-mode default -p "your prompt here"

# Interactive REPL (initial prompt only — does NOT exit)
claude "your prompt here"

-p は SDK／CI の標準的なエントリーポイントです。CLI は以前「ヘッドレスモード」と呼ばれていましたが、-p フラグに変更はありません。

CI とスクリプト向けのベアモード

スクリプトまたは CI から実行する場合は、--bare を追加してください。これにより、フック、スキル、プラグイン、MCP サーバー、自動メモリ、CLAUDE.md の自動検出がスキップされ、どのマシンでも同じ結果が返されます。ベアモードでは OAuth キーチェーンもスキップされるため、ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN、または --settings で渡す apiKeyHelper が必要です。

ANTHROPIC_API_KEY=$KEY claude --bare -p "Summarize the diff" --allowedTools "Read"

API キーの代わりに長期間有効な OAuth トークンが必要なパイプラインでは、claude setup-token でトークンを生成し、CLAUDE_CODE_OAUTH_TOKEN としてエクスポートしてください（注：ベアモードでは CLAUDE_CODE_OAUTH_TOKEN は読み込まれません。--bare を設定する場合は、ANTHROPIC_API_KEY または apiKeyHelper を使用してください）。

タスクの実行

権限モードの変更、セッションの再開、ツールの制限、追加ディレクトリの指定を行う前に、具体的なコマンド例について references/recipes.md をお読みください。

権限モードの選択

6 つのモードがサポートされています。タスクを安全に実行できる範囲で、最も制限の緩いモードを選んでください。

フラグ	使用する場面
--permission-mode default	通常の承認プロンプトを伴う一般的な Claude Code の使用
--permission-mode plan	ファイルの変更やシェルの実行を伴わない、読み取り専用の分析や計画
--permission-mode acceptEdits	ユーザーが Claude Code にファイルの書き込みを明示的に求めている場合（mkdir、mv、cp などの一般的なファイルシステムコマンドも自動承認されます）
--permission-mode auto	プロンプト疲れが問題となる長時間の自律型タスク。サーバー側の分類器がリスクのある操作をブロックしますが、レビューの代わりにはなりません
--permission-mode dontAsk	制限された CI：permissions.allow ルールと読み取り専用コマンドセットのみ実行でき、それ以外はすべて自動的に拒否されます
--permission-mode bypassPermissions	コンテナ／VM 専用 — --dangerously-skip-permissions と同等です。ユーザーの明示的な承認が必要で、プロンプトインジェクションに対する保護はありません

Auto モードには Claude Code v2.1.83 以降が必要で、プラン、管理者ポリシー、モデル、プロバイダーによって利用が制限されます。CLI が利用不可と報告した場合は、再試行しないでください。

コマンドの使用ルール

• claude --permission-mode default -p "your prompt here" から開始します。
• ユーザーが明示的に求めた場合に限り、--model <model> または --effort <level> を追加します。
• ユーザーが text 以外を求めている場合に限り、--output-format を使用します。サポートされている値は text（デフォルト）、json、stream-json です。
• スキーマ検証済みの構造化出力には、--output-format json と --json-schema '<JSON Schema>' を組み合わせます。
• 無限にループしてはならない自律型のプリントモード実行では、--max-turns <N> および／または --max-budget-usd <dollars> を追加します。
• 過負荷時に完全な失敗を避け、段階的に性能を落としたい場合は、プリントモードで --fallback-model <name> を使用します。
• 起動ディレクトリ外のファイルが必要なタスクでは、--add-dir <path> を使用します（--add-dir はファイルへのアクセスを許可しますが、追加したディレクトリの .claude/ 設定は読み込みません。ただし、.claude/skills/ は除きます）。
• --allowedTools、--disallowedTools、または --tools でツールを制限します（すべての組み込みツールを無効にするには --tools ""、すべてを有効にするには --tools "default"、または "Bash,Edit,Read" のようなカンマ区切りリストを使用します）。
• システムプロンプトに追記するには、または置き換えるには、--append-system-prompt、--append-system-prompt-file、--system-prompt、または --system-prompt-file を使用します。
• --mcp-config <file-or-json> で MCP サーバーを読み込みます。他のすべての MCP ソースを無視するには、--strict-mcp-config を追加します。
• --dangerously-skip-permissions を使用する前に確認してください。通常のファイル編集では、--permission-mode acceptEdits を優先してください。

セッションの再開

# Latest session in the current directory
claude --continue -p "continue the previous task"   # short: claude -c -p "..."

# Specific session by ID or by display name
claude --resume "auth-refactor" -p "continue with this follow-up"   # short: -r
claude --resume <session-id> -p "continue with this follow-up"

# Pin a UUID so a script always reuses the same session
claude --session-id 550e8400-e29b-41d4-a716-446655440000 -p "..."   # must be a valid UUID

# Resume sessions linked to a pull request
claude --from-pr 123 -p "address review comments"

現在のディレクトリで最新の会話を再開するには、--continue を使用します。 特定のセッションを再開するには、--resume を使用し、ID または表示名を指定します（--name / -n で設定するか、セッション中に /rename で設定します）。 --session-id は実際の UUID と組み合わせてのみ使用してください。CLI はそれ以外の文字列を拒否します。 再開するときは、ユーザーからモデル、推論の強度、または権限モードの変更を明示的に求められない限り、既存のセッションの動作を維持してください。 既存のセッションを再利用せずに分岐させたい場合にのみ、--fork-session を追加します。

完了後

• 警告や一部のみの出力を含め、結果を要約します。
• claude --continue（-c）、claude --resume <id-or-name>（-r）、または claude --from-pr <pr> で再開できることをユーザーに伝えます。
• 続行するか、プロンプトを調整するか、直接作業に戻るかを尋ねます。

重要な評価

Claude Code は権威者ではなく、同僚として扱ってください。

• 確信がある場合は、根拠に基づく自分の知識を信頼してください。
• 意見が食い違う場合は、主張を受け入れる前に最新のドキュメントや一次資料で確認してください。
• 別の Claude Code セッションでも、誤りや古い情報が含まれる可能性があることを忘れないでください。
• 本当に曖昧な場合は、ユーザーに判断を委ねてください。

認証

CLI は次の優先順位で認証情報を読み取ります：クラウドプロバイダーの環境変数（CLAUDE_CODE_USE_BEDROCK / _VERTEX / _FOUNDRY）→ ANTHROPIC_AUTH_TOKEN → ANTHROPIC_API_KEY → apiKeyHelper → CLAUDE_CODE_OAUTH_TOKEN → /login によるサブスクリプション OAuth。

• ブラウザーログイン：claude を一度実行してプロンプトに従うか、claude auth login を実行します（Console 請求には --console、SSO の強制には --sso を使用します）。
• 確認／サインアウト：セッション内で claude auth status または /status を実行します。認証情報を消去するには、claude auth logout または /logout を実行します。
• CI 用の長期間有効な OAuth：claude setup-token でトークンを出力し、CLAUDE_CODE_OAUTH_TOKEN としてエクスポートします（--bare では読み取られません）。
• 直接 API を使用する場合：ゲートウェイ経由で X-Api-Key を使用するには ANTHROPIC_API_KEY を、Authorization: Bearer を使用するには ANTHROPIC_AUTH_TOKEN を設定します。

エラー処理

• command not found: claude：Claude Code CLI がインストールされていないことをユーザーに伝えます。セットアップ後に claude install stable を実行できます。
• 認証エラー：上記の優先順位を確認します（例：サブスクリプションが有効な場合、設定を解除するために unset ANTHROPIC_API_KEY が必要になることがあります）。その後、claude auth login または claude auth status を再実行して確認します。
• 権限によるブロック：適切な --permission-mode（読み取り専用には plan、ファイル編集には acceptEdits）で再試行するか、--allowedTools / --disallowedTools を調整します。ユーザーの明示的な承認なしに --dangerously-skip-permissions に切り替えないでください。
• セッションが見つからない：引数なしで claude --resume を実行して一覧から選択するか、現在のディレクトリで claude --continue に切り替えます。--session-id には UUID が必要です。
• 自動モードが利用できない：これはプラン、管理者ポリシー、モデル、プロバイダーによって制限されているもので、一時的な障害ではありません。default または acceptEdits に切り替えてください。
• 無効なフラグまたはモデルのエラー：claude --help を確認してから、サポートされているオプションを指定して再実行します。claude --help にすべてのフラグが記載されているわけではありません。全リストは CLI リファレンスを参照してください。

<validation_checklist>

• リクエストで claude CLI または別の Claude Code セッションが明示的に必要とされています。
• 非対話型の実行では -p / --print を使用し、自動化に位置引数のプロンプトを使用しません。
• 権限モードがタスクに適合しています。読み取り専用には plan、明示的なファイル編集にのみ acceptEdits を使用し、バイパスは隔離された環境で明示的な承認を得た後にのみ使用します。
• 再現性とローカルフックの分離が必要な場合、スクリプト実行または CI 実行では --bare を使用します。
• 最終出力にはコマンドの形式、確認された結果、警告、および認証／セッション／権限に関するブロッカーが含まれています。

</validation_checklist>