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

CLI コマンド

これらのコマンドを使用して、セッションを開始し、コンテンツをパイプし、会話を再開し、更新を管理できます。 サブコマンドを誤入力した場合、Claude Code は最も近い一致を提案して、セッションを開始せずに終了します。たとえば、claude udpate は Did you mean claude update? と出力します。 claude --dangerously-skip-permissions daemon <subcommand> は daemon サブコマンドを実行するため、claude がフラグを含むようにエイリアスされている場合でもサブコマンドは機能します。先頭の --dangerously-skip-permissions または --allow-dangerously-skip-permissions のみがこの方法で daemon にルーティングされます。daemon の前にそれ以外のフラグがある場合、サブコマンドは実行されません。

CLI フラグ

以下のコマンドラインフラグで Claude Code の動作をカスタマイズできます。claude --help にはすべてのフラグが表示されるわけではないため、--help にフラグが表示されないからといって、そのフラグが使用できないわけではありません。

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

Claude Code には、システムプロンプトをカスタマイズするための 5 つのフラグがあります。4 つはプロンプトのテキストを設定するもので、--system-prompt-snapshot では、会話が開始時のテキストを保持し続けるかどうかを制御します。5 つすべてが対話モードと非対話モードの両方で機能します。 これらのフラグは組み合わせて使用できます。デフォルトのプロンプトを置き換えたうえで独自のテキストを追加するには、--system-prompt または --system-prompt-file と一緒に --append-system-prompt または --append-system-prompt-file を渡します。Claude Code v2.1.283 以降では、--append-system-prompt と --append-system-prompt-file のように、フラグとそのファイル形式を一緒に渡すこともでき、Claude Code は両方を使用します。 たとえば、ファイルのスタイルガイドと追加の指示 1 つの両方を追加するには、シェルで次のように実行します:
Claude は、デフォルトのシステムプロンプトの後に style.md の内容、空行、Always reply in French が続いたものを受け取ります。--append-system-prompt-file より前に --append-system-prompt を渡した場合でも、ファイルの内容が先になります。 置き換えるテキストが、毎回同じ指示と実行ごとに変わるコンテキストを組み合わせたものである場合は、指示とコンテキストの間に __SYSTEM_PROMPT_DYNAMIC_BOUNDARY__ のみを含む行を追加します。Claude Code は最初にあるその行でプロンプトを分割してその行を削除するため、その行より上の部分はキャッシュされたままとなり、下の部分は変更されます。Claude Code v2.1.275 以降が必要です。分割が適用される設定については、カスタムプロンプトの静的な部分をキャッシュするに一覧があります。 Claude Code のデフォルトのアイデンティティがタスクに合っているかどうかで選択してください。Claude をコーディングアシスタントのままにしつつ、追加のルール(呼び出しごとの指示、出力のフォーマット、-p スクリプトのドメインコンテキストなど)にも従わせたい場合は、追加フラグを使用します。追加ではデフォルトのツールガイダンス、安全性に関する指示、コーディング規約が保持されるため、異なる部分だけを指定すれば済みます。サーフェス、アイデンティティ、または権限モデルが Claude Code と異なる場合、たとえば人間が監視しないパイプライン内のコーディング以外のエージェントなどには、置き換えフラグを使用します。置き換えると、ツールガイダンスや安全性に関する指示を含むデフォルトのプロンプトがすべて失われるため、タスクに引き続き必要なものはユーザー自身が用意する必要があります。 切り替えたりプロジェクト全体で共有したりできる永続的なペルソナには、出力スタイルを使用します。Claude に常に従わせたいプロジェクトの規約には、CLAUDE.md を使用します。同じ判断について、システムプロンプトに関する Agent SDK ガイドでより詳しく説明しています。

再開した会話でのシステムプロンプトフラグ

デフォルトでは、Claude Code は会話の最初のリクエスト時に、システムプロンプトフラグのテキストを適用したうえでシステムプロンプトを 1 回だけ構築し、セッションに記録します。会話が圧縮されるまでは、以降のすべてのリクエストでその記録されたプロンプトが使用されます。これは --resume または --continue で会話に戻った後も同様です。その後の起動時に異なるシステムプロンプトフラグのテキストを渡した場合(またはフラグを渡さなかった場合)、その変更は会話が圧縮された時点、または新しい会話を開始した時点で有効になります。 クラウドセッション以外で、--bare を渡すか CLAUDE_CODE_SIMPLE=1 を設定して bare モードで Claude Code を開始した場合、--system-prompt-snapshot on を渡さない限り記録はオフのままです。v2.1.268 より前は、機能フラグを取得しないセッション(Amazon Bedrock、Google Cloud’s Agent Platform、Microsoft Foundry 上のセッションを含む)ではリクエストごとにプロンプトが再構築され、--system-prompt-snapshot は効果がありませんでした。 代わりにリクエストごとにプロンプトを再構築するには、--system-prompt-snapshot off を渡します。たとえば、--continue の実行をまたいでプロンプトの文言を繰り返し調整する場合に便利です。v2.1.265 より前は、いずれかのシステムプロンプトフラグを渡すと、--system-prompt-snapshot on を渡さない限り記録もオフになっていました。

関連項目