referencegrowing

Claude Code CLI を「ほぼ対話の実行装置」として使う — claude -p の正しい呼び方

claude -p(print モード)は autorun と同じ経路で、シェルから 1 行でエージェントを走らせられる。--continue で擬似対話、--model と環境変数で Claude/DeepSeek を呼び分ける。権限・cwd・env 残留・引数長・課金の 5 つが事故の主因なので、手順とチェックリストを固定化する。

結論

claude -p "指示" は「1 回の指示 → ツールを使って実行 → 終了」の非対話(print)モードである。 自動運用(autorun)が回しているのはこのモードそのもので、GUI を使わずシェルから 1 行で エージェントを起動できる。

擬似対話は --continue(直前の会話を再開)を付けて1 ターンずつ呼ぶ。 会話は CLI 側に保存されるため、呼び出し側が履歴を持つ必要はない。

やりたいことコマンド
1 回だけ実行claude -p "この作業を実施せよ" ...
続きをやらせる(擬似対話)同じ + -c(--continue)
特定の会話を再開-r <session-id>(--resume)
Claude で動かすモデル名が opus / sonnet / claude-*
DeepSeek で動かす--model deepseek-* + ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN

CLI 自体に「プロバイダ」という概念はなく、モデル名と環境変数の組み合わせで行き先が決まる。 この 2 つを毎回正しく書くのは間違えやすいので、本記事の最後に薄いラッパー(agentgo)を示す。


1. 前提:autorun と何が同じで、何が違うか

自動運用は特別なものを使っておらず、同じ claude バイナリを非対話モードで叩いているだけ。 ループ・状態保存・レート制限待ちは、すべて外側のシェルスクリプトがやっている。

autorun手動の claude -p
起動run_agent.sh がループ人が 1 行叩く
プロンプトファイルから読む引数 or 標準入力
会話の継続--continue を条件付きで付与自分で付ける
権限--dangerously-skip-permissions自分で付ける(必須)
失敗時の扱いレート制限/認証を判定して待つ・止める終了コードを見て人が判断
コスト管理off-peak ゲート等のポリシー無い(生で叩く)

autorun が成立している環境では、claude -p も同じように動作する。逆に、autorun が やっている「権限・env・継続・失敗判定」を人がやらないと事故る。


2. 最小手順(Claude で 1 回走らせる)

2-1. まず素の 1 発(安いモデル・短い指示で)

Terminal window
# PowerShell
claude -p "README の見出しだけ列挙して" --model sonnet --dangerously-skip-permissions
Terminal window
# bash
claude -p "README の見出しだけ列挙して" --model sonnet --dangerously-skip-permissions

-p は標準出力に結果を出して終了する。--output-format json にすると 結果・使用トークン・セッション ID が構造化されて返る(後述の --resume に使える)。

2-2. 本番の指示(長いプロンプト)

引数で渡せる長さには上限がある(Windows の CreateProcess は約 32,767 バイト)。 長い指示は標準入力に流す方が安全。

Terminal window
Get-Content -Raw .\task.md | claude -p --model sonnet --dangerously-skip-permissions
Terminal window
cat task.md | claude -p --model sonnet --dangerously-skip-permissions

引数で渡す方式(claude -p "$(Get-Content -Raw task.md)")は、上限を超えると Argument list too long で起動そのものが失敗する。まず短い指示で 1 回通し、 長文は標準入力へ切り替えるのが、迷わない順序。

2-3. 権限(ここを忘れると「何もしてくれない」)

非対話モードでは人が承認できない。権限が「確認待ち」のままだと、 ツール呼び出しは黙って拒否される(エラーに見えないので詰まりやすい)。

  • 全許可:--dangerously-skip-permissions
  • もう少し絞る:--permission-mode acceptEdits(編集は許可、実行系は確認)など
    • 選択肢(CLI 実測):acceptEdits / auto / bypassPermissions / manual / dontAsk / plan
  • 許可ツールを明示:--allowedTools "Bash(git *) Edit"

信頼できないリポジトリで --dangerously-skip-permissions を使わない。 これは「サンドボックス相当の環境でのみ」とされている。

補足:-p ではワークスペース信頼ダイアログがスキップされるため、 .claude/settings.json の permissions.allow は(未信頼のワークスペースでは)無視される。 「設定に allow を書いたのに拒否される」場合はこれが原因で、--dangerously-skip-permissions か --permission-mode に寄せる必要がある。


3. 擬似対話にする(--continue / --resume)

Terminal window
claude -p "まず現状を調査して報告して" --model sonnet --dangerously-skip-permissions
claude -p -c "その調査結果に基づいて修正して" --model sonnet --dangerously-skip-permissions
claude -p -c "テストを回して結果を報告して" --model sonnet --dangerously-skip-permissions
  • -c / --continue は 「カレントディレクトリの直近の会話」 を再開する。 → cwd が会話のキー。別ディレクトリに移ると別会話になる。
  • どの会話か確実に指定したいなら -r <session-id>(--resume)。 --output-format json の戻り値にセッション ID が入るので、それを保存しておく。
  • 会話はCLI 側に保存される。こちらで履歴を保持する必要はない。

落とし穴:-c の取り違え

同じディレクトリで複数の作業(別ロール・別目的)を並行すると、-c が 別の会話を拾う。回避は次のどれか。

  1. 目的ごとに cwd を分ける(git worktree が最も確実)
  2. -r <session-id> で明示する
  3. -c を使わず、毎回自己完結したプロンプトにする(状態は handover 等のファイルに持たせる)

自動運用が「直前に自分が起動したロールと同じときだけ --continue を付ける」と 条件分けしているのは、まさにこの事故を避けるため。


4. Claude と DeepSeek の呼び分け

CLI は Anthropic 互換のエンドポイントを環境変数で差し替えられる。 DeepSeek はその互換 API を出しているので、同じ claude バイナリで DeepSeek が動く。

ClaudeDeepSeek
モデル名opus / sonnet / claude-*deepseek-v4-pro / deepseek-flash
ANTHROPIC_BASE_URL設定しない(既定)https://api.deepseek.com/anthropic
ANTHROPIC_AUTH_TOKEN設定しない(OAuth / API キー)DeepSeek の API キー
課金AnthropicDeepSeek

4-1. 原則:1 コマンド単位で env を被せる(export しない)

export すると後続の Claude 呼び出しが DeepSeek を叩く(=無自覚に別ベンダーへ課金)。 1 回ごとに env を被せ、Claude を呼ぶときは明示的に unset する。

Terminal window
# bash: DeepSeek
env ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" \
ANTHROPIC_AUTH_TOKEN="$DEEPSEEK_API_KEY" \
claude -p "…" --model deepseek-flash --dangerously-skip-permissions
# bash: Claude(残留 env を必ず落とす)
env -u ANTHROPIC_BASE_URL -u ANTHROPIC_AUTH_TOKEN \
claude -p "…" --model sonnet --dangerously-skip-permissions
Terminal window
# PowerShell: DeepSeek(finally で必ず戻す)
$env:ANTHROPIC_BASE_URL = 'https://api.deepseek.com/anthropic'
$env:ANTHROPIC_AUTH_TOKEN = $env:DEEPSEEK_API_KEY
try { claude -p "…" --model deepseek-flash --dangerously-skip-permissions }
finally {
Remove-Item Env:ANTHROPIC_BASE_URL, Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue
}

4-2. ラッパーにして「呼び分け」を固定する

毎回 env を手で書くと必ずどこかで抜ける。判断を 1 か所に閉じ込めるのが定石で、 本記事では §5 の agentgo をその実装として示す(プロンプトは argv ではなく stdin で渡すため、 下のシェル関数より安全)。

シェル関数で済ませる場合の最小形(プロンプトを引数で渡すので長文には向かない):

~/.bashrc
claude_run() { env -u ANTHROPIC_BASE_URL -u ANTHROPIC_AUTH_TOKEN claude -p "$1" --dangerously-skip-permissions "${@:2}"; }
deepseek_run() { env ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" ANTHROPIC_AUTH_TOKEN="$DEEPSEEK_API_KEY" claude -p "$1" --model deepseek-flash --dangerously-skip-permissions "${@:2}"; }

4-3. モデル名だけで自動判定させる(autorun と同じ規則)

自動運用は「モデル名が deepseek-* なら DeepSeek、claude-*|opus*|sonnet*|haiku* なら Claude」と 判定している。人が叩くときも同じ規則にしておくと迷わない。

ただし判定は「env をどちらに向けるか」までは決めてくれない(CLI 側の自動判定ではない)。 ∴ 「モデル名で選ぶ → それに応じた env を被せる」を1 つのラッパーで一体化するのが安全。


5. 薄いラッパー(agentgo)

上の「呼び分け」を毎回手で書くと、env の付け忘れ・残留・権限フラグ忘れが起きる。 そこで判断だけを固定した薄いコマンドを用意する(実装は 1 ファイル・依存なし・Node ≥ 22)。

Terminal window
agentgo -p "この作業を実施せよ" # 1 ターン(Claude)
agentgo -c "続いて YY せよ" # 直前の会話の続き
agentgo -m deepseek-flash -p "…" # DeepSeek
Get-Content task.md | agentgo -p # 長い指示は標準入力
agentgo -n -m deepseek-v4-pro -c "…" # 実行内容の確認だけ(--dry-run)

固定するのは次の 3 点だけで、それ以外は claude に渡すだけ。

固定するもの内容
バックエンド--model の名前から決める(deepseek-* → DeepSeek / `claude-*
権限既定で --dangerously-skip-permissions。--safe で外す
プロンプト常に stdin で子プロセスへ渡す(argv 長の上限と Windows の引用符事故を同時に消す)
  • -c / -r <id> はそのまま claude に渡る。
  • Claude を呼ぶときは ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN を自動で落とす(env 残留対策)。
  • キーは DEEPSEEK_API_KEY、無ければ --env-file、無ければカレントの .env.agent → .env.deepseek → .env.local を未設定キーだけ読む。
  • 未知のフラグはエラーにする。 素通しすると --output-format json "x" の json が プロンプトに混入して静かに壊れるため。例外的なフラグが要る用途では claude を直接叩く。
  • -n / --dry-run は provider・argv・env(キーは伏字)を表示して終了する。API を呼ばない。

回帰テストは bash bin/test_agentgo.sh(21 checks・API 非呼び出し)。


6. 間違えないためのチェックリスト

実行前に上から確認する。

  • cwd:そのディレクトリで良いか(-c の宛先・相対パス・git 操作の基準になる)
  • 権限:--dangerously-skip-permissions か --permission-mode を付けたか(付け忘れ=無言の拒否)
  • env:DeepSeek なら 2 つとも設定したか。Claude なら残留していないか
  • モデル名:--model を明示したか(既定は最新世代とは限らない。opus は世代固定にならない)
  • プロンプト長:引数で渡していないか(長いなら標準入力)
  • 出力:結果をファイルに残すか(> out.txt / --output-format json)
  • 終了コード:$LASTEXITCODE / $? を見る(0 以外は失敗。本文の成功っぽい文言に騙されない)
  • 課金:DeepSeek を手で叩くなら、autorun の off-peak ゲート等のポリシーを迂回している自覚
  • 並行:同じ cwd で 2 本走らせない(-c の取り違え・git の index.lock 衝突)
  • 秘密:プロンプトに API キーや個人情報を入れない(会話ログに残る)

7. よくある失敗と、その見分け方

症状原因対処
何もせず文章だけ返す権限が確認待ちでツールが無言拒否--dangerously-skip-permissions / --permission-mode
急に別ベンダーへ課金export した ANTHROPIC_BASE_URL が残留1 コマンド単位で被せる/Claude 側は unset
前と違う話題を続ける-c が別会話(同 cwd の直近)を拾った-r <id> か cwd 分離
起動即失敗(Argument list too long)プロンプトを引数で渡した標準入力へ
出力が途中で切れる出力をファイルに残していない> out.txt か --output-format json
失敗したのに成功に見える終了コードを見ていない$LASTEXITCODE / $? を必ず確認
同じ作業を 2 回やる-c を付けたつもりで付け忘れ継続は明示的に付ける(ラッパーなら -c)

8. どの実行形態を選ぶか

状況選択
人が見ながら 1 往復ずつ進めたいclaude -p + -c(擬似対話)
定型作業を夜間に回したいautorun(run_agent.sh。レート制限・失敗判定込み)
対話で試行錯誤し、最後に一括実行GUI で詰める → 同じ指示を claude -p に流す
別ロールを並行git worktree で cwd を分ける

使い分けの芯:claude -p は「1 指示 = 1 プロセス」。 会話の連続性は CLI の保存に依存するので、重要な状態はファイル(handover 等)に落とす。 これを守れば、GUI と遜色なく回せる。


9. 参考