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

CLI コマンド

これらのコマンドを使用して、セッションを開始し、コンテンツをパイプし、会話を再開し、更新を管理できます。
コマンド説明
claudeインタラクティブセッションを開始claude
claude "query"初期プロンプト付きでインタラクティブセッションを開始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 auth loginAnthropic アカウントにサインイン。--email を使用してメールアドレスを事前入力し、--sso を使用して SSO 認証を強制しますclaude auth login --email [email protected] --sso
claude auth logoutAnthropic アカウントからログアウトclaude auth logout
claude auth status認証ステータスを JSON として表示。--text を使用して人間が読める形式で表示。ログイン済みの場合はコード 0 で終了、ログインしていない場合は 1 で終了claude auth status
claude agentsすべての設定済み subagents をソース別にグループ化して一覧表示claude agents
claude mcpModel Context Protocol(MCP)サーバーを設定Claude Code MCP ドキュメント を参照してください。
claude remote-controlRemote Control セッション を開始して、ローカルで実行中の Claude Code を Claude.ai または Claude アプリから制御します。フラグについては Remote Control を参照してくださいclaude remote-control

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 --append-system-prompt-file ./extra-rules.txt
--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起動時に IDE に自動的に接続します(正確に 1 つの有効な 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-6
--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"
--remoteclaude.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追加の設定を読み込むための 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 --system-prompt-file ./custom-prompt.txt
--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
--worktree, -wClaude を <repo>/.claude/worktrees/<name> の分離された git worktree で開始します。名前が指定されていない場合は、自動生成されますclaude -w feature-auth
--output-format json フラグは、スクリプトと自動化に特に役立ち、Claude の応答をプログラム的に解析できます。

Agents フラグ形式

--agents フラグは、1 つ以上のカスタム subagents を定義する JSON オブジェクトを受け入れます。各 subagent には、一意の名前(キーとして)と、以下のフィールドを持つ定義オブジェクトが必要です。
フィールド必須説明
descriptionはいsubagent を呼び出すべき時期の自然言語説明
promptはいsubagent の動作をガイドするシステムプロンプト
toolsいいえsubagent が使用できる特定のツールの配列。例:["Read", "Edit", "Bash"]。省略された場合は、すべてのツールを継承します。Agent(agent_type) 構文をサポート
disallowedToolsいいえこの subagent に対して明示的に拒否するツール名の配列
modelいいえ使用するモデルエイリアス:sonnetopushaiku、または inherit。省略された場合は、デフォルトで inherit
skillsいいえsubagent のコンテキストにプリロードする skill 名の配列
mcpServersいいえこの subagent の MCP servers の配列。各エントリはサーバー名文字列または {name: config} オブジェクト
maxTurnsいいえsubagent が停止する前の agentic ターンの最大数
例:
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 つのフラグを提供します。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 --system-prompt-file ./prompts/code-review.txt
    
  • --append-system-prompt:Claude Code のデフォルト機能を保持しながら特定の指示を追加したい場合に使用します。これはほとんどのユースケースで最も安全なオプションです。
    claude --append-system-prompt "Always use TypeScript and include JSDoc comments"
    
  • --append-system-prompt-file:Claude Code のデフォルトを保持しながらファイルから指示を追加したい場合に使用します。バージョン管理された追加に役立ちます。
    claude --append-system-prompt-file ./prompts/style-rules.txt
    
--system-prompt--system-prompt-file は相互に排他的です。追加フラグは、置き換えフラグのいずれかと一緒に使用できます。 ほとんどのユースケースでは、--append-system-prompt または --append-system-prompt-file が推奨されます。これらは Claude Code の組み込み機能を保持しながらカスタム要件を追加します。システムプロンプトを完全に制御する必要がある場合にのみ --system-prompt または --system-prompt-file を使用してください。

関連項目