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 発(安いモデル・短い指示で)
# PowerShellclaude -p "README の見出しだけ列挙して" --model sonnet --dangerously-skip-permissions# bashclaude -p "README の見出しだけ列挙して" --model sonnet --dangerously-skip-permissions-p は標準出力に結果を出して終了する。--output-format json にすると
結果・使用トークン・セッション ID が構造化されて返る(後述の --resume に使える)。
2-2. 本番の指示(長いプロンプト)
引数で渡せる長さには上限がある(Windows の CreateProcess は約 32,767 バイト)。
長い指示は標準入力に流す方が安全。
Get-Content -Raw .\task.md | claude -p --model sonnet --dangerously-skip-permissionscat 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
- 選択肢(CLI 実測):
- 許可ツールを明示:
--allowedTools "Bash(git *) Edit"
信頼できないリポジトリで --dangerously-skip-permissions を使わない。
これは「サンドボックス相当の環境でのみ」とされている。
補足:-p ではワークスペース信頼ダイアログがスキップされるため、
.claude/settings.json の permissions.allow は(未信頼のワークスペースでは)無視される。
「設定に allow を書いたのに拒否される」場合はこれが原因で、--dangerously-skip-permissions か
--permission-mode に寄せる必要がある。
3. 擬似対話にする(--continue / --resume)
claude -p "まず現状を調査して報告して" --model sonnet --dangerously-skip-permissionsclaude -p -c "その調査結果に基づいて修正して" --model sonnet --dangerously-skip-permissionsclaude -p -c "テストを回して結果を報告して" --model sonnet --dangerously-skip-permissions-c/--continueは 「カレントディレクトリの直近の会話」 を再開する。 → cwd が会話のキー。別ディレクトリに移ると別会話になる。- どの会話か確実に指定したいなら
-r <session-id>(--resume)。--output-format jsonの戻り値にセッション ID が入るので、それを保存しておく。 - 会話はCLI 側に保存される。こちらで履歴を保持する必要はない。
落とし穴:-c の取り違え
同じディレクトリで複数の作業(別ロール・別目的)を並行すると、-c が
別の会話を拾う。回避は次のどれか。
- 目的ごとに
cwdを分ける(git worktreeが最も確実) -r <session-id>で明示する-cを使わず、毎回自己完結したプロンプトにする(状態は handover 等のファイルに持たせる)
自動運用が「直前に自分が起動したロールと同じときだけ --continue を付ける」と
条件分けしているのは、まさにこの事故を避けるため。
4. Claude と DeepSeek の呼び分け
CLI は Anthropic 互換のエンドポイントを環境変数で差し替えられる。
DeepSeek はその互換 API を出しているので、同じ claude バイナリで DeepSeek が動く。
| Claude | DeepSeek | |
|---|---|---|
| モデル名 | opus / sonnet / claude-* | deepseek-v4-pro / deepseek-flash |
ANTHROPIC_BASE_URL | 設定しない(既定) | https://api.deepseek.com/anthropic |
ANTHROPIC_AUTH_TOKEN | 設定しない(OAuth / API キー) | DeepSeek の API キー |
| 課金 | Anthropic | DeepSeek |
4-1. 原則:1 コマンド単位で env を被せる(export しない)
export すると後続の Claude 呼び出しが DeepSeek を叩く(=無自覚に別ベンダーへ課金)。
1 回ごとに env を被せ、Claude を呼ぶときは明示的に unset する。
# bash: DeepSeekenv 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# PowerShell: DeepSeek(finally で必ず戻す)$env:ANTHROPIC_BASE_URL = 'https://api.deepseek.com/anthropic'$env:ANTHROPIC_AUTH_TOKEN = $env:DEEPSEEK_API_KEYtry { 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 で渡すため、
下のシェル関数より安全)。
シェル関数で済ませる場合の最小形(プロンプトを引数で渡すので長文には向かない):
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)。
agentgo -p "この作業を実施せよ" # 1 ターン(Claude)agentgo -c "続いて YY せよ" # 直前の会話の続きagentgo -m deepseek-flash -p "…" # DeepSeekGet-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. 参考
claude --help(実測。-p/--print、-c/--continue、-r/--resume、--permission-mode、--output-format、--input-format)- DeepSeek を Claude Code の代替バックエンドにする
—
PROVIDER:/MODEL:による自動運用側の切り替えと env の被せ方