メインコンテンツへスキップ

CLI コマンド

コマンド説明
claudeインタラクティブ REPL を開始claude
claude "query"初期プロンプト付きで REPL を開始claude "explain this project"
claude -p "query"SDK 経由でクエリを実行してから終了claude -p "explain this function"
cat file | claude -p "query"パイプされたコンテンツを処理cat logs.txt | claude -p "explain"
claude -c現在のディレクトリで最新の会話を続行claude -c
claude -c -p "query"SDK 経由で続行claude -c -p "Check for type errors"
claude -r "<session>" "query"セッション ID または名前でセッションを再開claude -r "auth-refactor" "Finish this PR"
claude update最新バージョンに更新claude update
claude mcpModel Context Protocol(MCP)サーバーを設定Claude Code MCP ドキュメントを参照してください。

CLI フラグ

これらのコマンドラインフラグで Claude Code の動作をカスタマイズします。
フラグ説明
--add-dirClaude がアクセスできる追加の作業ディレクトリを追加します(各パスがディレクトリとして存在することを検証します)claude --add-dir ../apps ../lib
--agent現在のセッション用のエージェントを指定します(agent 設定をオーバーライドします)claude --agent my-custom-agent
--agentsカスタム subagents を JSON 経由で動的に定義します(形式については以下を参照)claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
--allow-dangerously-skip-permissions--permission-mode と組み合わせることができるオプションとしてパーミッションバイパスを有効にします(すぐには有効化しません)(注意して使用してください)claude --permission-mode plan --allow-dangerously-skip-permissions
--allowedToolsパーミッションプロンプトなしで実行するツール。パターンマッチングについては パーミッションルール構文 を参照してください。利用可能なツールを制限するには、代わりに --tools を使用してください"Bash(git log *)" "Bash(git diff *)" "Read"
--append-system-promptデフォルトシステムプロンプトの末尾にカスタムテキストを追加します(インタラクティブモードと出力モードの両方で機能します)claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-fileファイルから追加のシステムプロンプトテキストを読み込み、デフォルトプロンプトに追加します(出力モードのみ)claude -p --append-system-prompt-file ./extra-rules.txt "query"
--betasAPI リクエストに含めるベータヘッダー(API キーユーザーのみ)claude --betas interleaved-thinking
--chromeWeb 自動化とテスト用の Chrome ブラウザ統合 を有効にしますclaude --chrome
--continue, -c現在のディレクトリで最新の会話を読み込みますclaude --continue
--dangerously-skip-permissionsすべてのパーミッションプロンプトをスキップします(注意して使用してください)claude --dangerously-skip-permissions
--debugデバッグモードを有効にします。オプションのカテゴリフィルタリング付き(例:"api,hooks" または "!statsig,!file"claude --debug "api,mcp"
--disable-slash-commandsこのセッションのすべてのスキルとスラッシュコマンドを無効にしますclaude --disable-slash-commands
--disallowedToolsモデルのコンテキストから削除され、使用できないツール"Bash(git log *)" "Bash(git diff *)" "Edit"
--fallback-modelデフォルトモデルがオーバーロードされた場合、指定されたモデルへの自動フォールバックを有効にします(出力モードのみ)claude -p --fallback-model sonnet "query"
--fork-session再開時に、元のセッション ID を再利用する代わりに新しいセッション ID を作成します(--resume または --continue と共に使用)claude --resume abc123 --fork-session
--from-pr特定の GitHub PR にリンクされたセッションを再開します。PR 番号または URL を受け入れます。セッションは gh pr create 経由で作成されたときに自動的にリンクされますclaude --from-pr 123
--ideスタートアップ時に、正確に 1 つの有効な IDE が利用可能な場合、IDE に自動的に接続しますclaude --ide
--init初期化フックを実行し、インタラクティブモードを開始しますclaude --init
--init-only初期化フックを実行して終了します(インタラクティブセッションなし)claude --init-only
--include-partial-messages部分的なストリーミングイベントを出力に含めます(--print--output-format=stream-json が必要)claude -p --output-format stream-json --include-partial-messages "query"
--input-format出力モード用の入力形式を指定します(オプション:textstream-jsonclaude -p --output-format json --input-format stream-json
--json-schemaエージェントがワークフローを完了した後、JSON Schema に一致する検証済み JSON 出力を取得します(出力モードのみ。構造化出力を参照)claude -p --json-schema '{"type":"object","properties":{...}}' "query"
--maintenanceメンテナンスフックを実行して終了しますclaude --maintenance
--max-budget-usd停止する前に API 呼び出しに費やす最大ドル金額(出力モードのみ)claude -p --max-budget-usd 5.00 "query"
--max-turnsagentic ターン数を制限します(出力モードのみ)。制限に達するとエラーで終了します。デフォルトでは制限なしclaude -p --max-turns 3 "query"
--mcp-configJSON ファイルまたは文字列から MCP サーバーを読み込みます(スペース区切り)claude --mcp-config ./mcp.json
--model現在のセッション用のモデルを設定します。最新モデルのエイリアス(sonnet または opus)またはモデルの完全な名前を使用claude --model claude-sonnet-4-5-20250929
--no-chromeこのセッション用の Chrome ブラウザ統合 を無効にしますclaude --no-chrome
--no-session-persistenceセッション永続化を無効にして、セッションがディスクに保存されず、再開できないようにします(出力モードのみ)claude -p --no-session-persistence "query"
--output-format出力モード用の出力形式を指定します(オプション:textjsonstream-jsonclaude -p "query" --output-format json
--permission-mode指定された パーミッションモード で開始しますclaude --permission-mode plan
--permission-prompt-tool非インタラクティブモードでパーミッションプロンプトを処理する MCP ツールを指定しますclaude -p --permission-prompt-tool mcp_auth_tool "query"
--plugin-dirこのセッションのみのディレクトリからプラグインを読み込みます(繰り返し可能)claude --plugin-dir ./my-plugins
--print, -pインタラクティブモードなしで応答を出力します(プログラム的な使用の詳細については Agent SDK ドキュメント を参照)claude -p "query"
--remote提供されたタスク説明で claude.ai 上に新しい Web セッション を作成しますclaude --remote "Fix the login bug"
--resume, -rID または名前で特定のセッションを再開するか、セッションを選択するためのインタラクティブピッカーを表示しますclaude --resume auth-refactor
--session-id会話に特定のセッション ID を使用します(有効な UUID である必要があります)claude --session-id "550e8400-e29b-41d4-a716-446655440000"
--setting-sources読み込む設定ソースのカンマ区切りリスト(userprojectlocalclaude --setting-sources user,project
--settings追加の設定を読み込むための設定 JSON ファイルまたは JSON 文字列へのパスclaude --settings ./settings.json
--strict-mcp-config--mcp-config からのみ MCP サーバーを使用し、他のすべての MCP 設定を無視しますclaude --strict-mcp-config --mcp-config ./mcp.json
--system-promptデフォルトシステムプロンプト全体をカスタムテキストに置き換えます(インタラクティブモードと出力モードの両方で機能します)claude --system-prompt "You are a Python expert"
--system-prompt-fileファイルからシステムプロンプトを読み込み、デフォルトプロンプトを置き換えます(出力モードのみ)claude -p --system-prompt-file ./custom-prompt.txt "query"
--teleportWeb セッション をローカルターミナルで再開しますclaude --teleport
--teammate-modeエージェントチーム のチームメイトの表示方法を設定します:auto(デフォルト)、in-process、または tmuxエージェントチームのセットアップを参照claude --teammate-mode in-process
--toolsClaude が使用できる組み込みツールを制限します(インタラクティブモードと出力モードの両方で機能します)。すべてを無効にするには "" を、すべてを有効にするには "default" を、または "Bash,Edit,Read" のようなツール名を使用claude --tools "Bash,Edit,Read"
--verbose詳細ログを有効にし、完全なターンバイターン出力を表示します(出力モードとインタラクティブモードの両方でデバッグに役立ちます)claude --verbose
--version, -vバージョン番号を出力しますclaude -v
--output-format json フラグは、スクリプトと自動化に特に役立ちます。Claude の応答をプログラム的に解析できます。

Agents フラグ形式

--agents フラグは、1 つ以上のカスタム subagents を定義する JSON オブジェクトを受け入れます。各 subagent には、一意の名前(キーとして)と、以下のフィールドを持つ定義オブジェクトが必要です。
フィールド必須説明
descriptionはいsubagent を呼び出すべき時期の自然言語説明
promptはいsubagent の動作をガイドするシステムプロンプト
toolsいいえsubagent が使用できる特定のツールの配列(例:["Read", "Edit", "Bash"])。省略した場合、すべてのツールを継承します
modelいいえ使用するモデルエイリアス:sonnetopushaiku、または inherit。省略した場合、デフォルトは inherit(メイン会話のモデルを使用)
例:
claude --agents '{
  "code-reviewer": {
    "description": "Expert code reviewer. Use proactively after code changes.",
    "prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  },
  "debugger": {
    "description": "Debugging specialist for errors and test failures.",
    "prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."
  }
}'
subagents の作成と使用の詳細については、subagents ドキュメントを参照してください。

システムプロンプトフラグ

Claude Code は、システムプロンプトをカスタマイズするための 4 つのフラグを提供します。各フラグは異なる目的に対応しています。
フラグ動作モードユースケース
--system-promptデフォルトプロンプト全体を 置き換えインタラクティブ + 出力Claude の動作と指示を完全に制御
--system-prompt-fileファイルコンテンツで 置き換え出力のみ再現性とバージョン管理のためにファイルからプロンプトを読み込み
--append-system-promptデフォルトプロンプトに 追加インタラクティブ + 出力デフォルト Claude Code 動作を保持しながら特定の指示を追加
--append-system-prompt-fileファイルコンテンツをデフォルトプロンプトに 追加出力のみデフォルトを保持しながらファイルから追加の指示を読み込み
各フラグを使用する時期:
  • --system-prompt:Claude のシステムプロンプトを完全に制御する必要がある場合に使用します。これにより、すべてのデフォルト Claude Code 指示が削除され、白紙の状態が得られます。
    claude --system-prompt "You are a Python expert who only writes type-annotated code"
    
  • --system-prompt-file:ファイルからカスタムプロンプトを読み込みたい場合に使用します。チーム全体の一貫性またはバージョン管理されたプロンプトテンプレートに役立ちます。
    claude -p --system-prompt-file ./prompts/code-review.txt "Review this PR"
    
  • --append-system-prompt:Claude Code のデフォルト機能を保持しながら特定の指示を追加したい場合に使用します。これはほとんどのユースケースで最も安全なオプションです。
    claude --append-system-prompt "Always use TypeScript and include JSDoc comments"
    
  • --append-system-prompt-file:Claude Code のデフォルトを保持しながらファイルから指示を追加したい場合に使用します。バージョン管理された追加に役立ちます。
    claude -p --append-system-prompt-file ./prompts/style-rules.txt "Review this PR"
    
--system-prompt--system-prompt-file は相互に排他的です。追加フラグは、置き換えフラグのいずれかと一緒に使用できます。 ほとんどのユースケースでは、--append-system-prompt または --append-system-prompt-file が推奨されます。これらは Claude Code の組み込み機能を保持しながらカスタム要件を追加します。--system-prompt または --system-prompt-file は、システムプロンプトを完全に制御する必要がある場合にのみ使用してください。

関連項目