Claude Code 汎用コマンド：対話セッション、復元、スクリプト、構造化出力

claude を直接実行すると継続的なセッションが開き、探索、修正、複数回のフィードバックに適している。起動コマンドにプロンプトを付与すると、特定のタスクに直接入れる。一方 -p は非対話モードで結果を出力し、スクリプトや CI に適している。

自動化の前に、まず対話モードでプロンプトと権限を検証する。非対話実行では即座に修正を行う人がいないため、タスクの境界と許可するツールをより厳格にする必要がある。

スラッシュコマンドは Claude Code の対話インターフェースに入力するものであり、shell に直接渡すべきではない。/help は現在のバージョンを確認、/status はモデルと認証を検査、/context はコンテキストの出所を表示、/permissions は権限を管理する。

コマンドセットはバージョンにより変化します。/help は現在インストールされているバージョンのコマンド一覧です。静的なコマンド一覧を永続的なインターフェースとして扱いません。

claude --continue は現在のディレクトリの最後のセッションを再開し、claude --resume はデフォルトで現在の worktree スコープからセッションセレクタを開き、セレクタ内で他のプロジェクトへ拡張できる。複雑なタスクではセッション内で /rename を使い、検索可能な名前を付けるべきである。

セッションを復元すると会話と関連状態も復元されるが、現在のワークツリーは変化している可能性がある。続行する前に、まず Claude に Git の状態と主要ファイルを再確認させる。

非対話モードはプレーンテキスト、JSON、ストリーミング JSON をサポートする。単一の JSON オブジェクトは最終結果を待ってから解析するのに適し、stream-json はイベントをリアルタイムで消費するのに適し、verbose 出力を必要とする。

機械解析の際、自然言語から正規表現でフィールドを推測してはいけない。構造化出力を選択し、下流で必須フィールドと終了ステータスを検証すべきである。

バッチ呼び出しでは、タスク完了に必要なツールのみを許可すべきである。--tools は利用可能な組み込みツールを決定し、--allowedTools は一致するツールを確認なしで呼び出せることを示すだけで、他のツールを隠すわけではない。ツールを全く必要としないパイプラインタスクでは空の --tools を渡せる。

--safe-mode は既存のサブスクリプション/OAuth でログインする隔離レビューに適する。より厳格な --bare は OAuth や keychain を読み込まず、明示的に ANTHROPIC_API_KEY や apiKeyHelper が提供される環境でのみ適用できる。

まず2〜3個のサンプルでプロンプト、権限、出力を校正してから、バッチ規模を拡大する。並列処理はコストを増加させ、同じワークツリーで競合が生じる可能性もあるため、編集タスクは独立した worktree と組み合わせるのが適している。

claude doctor は shell からインストールと設定を検査し、claude --debug-file <path> はより詳細な起動、MCP、gateway 診断を指定ファイルに書き出す。--debug を単独で使用する場合、デフォルトのログは ~/.claude/debug/<session-id>.txt に置かれる。

トラブルシューティングでは一度に一つの変数だけを変更し、完全なエラーテキストを保持すること。モデルエラー、認証エラー、ネットワークエラーの修正経路は異なる。