claude -p とは
claude -p は print mode（非対話モード・ヘッドレスモード）。プロンプトを渡すと一回だけ実行して結果を標準出力に返して終了する。対話セッションを開かずスクリプトや CI から呼び出せるのが特徴。
claude -p "このファイルを要約して" < README.md
主要フラグ
| フラグ | 用途 |
|---|---|
-p |
print モードで実行（必須） |
--output-format |
出力形式を text / json / stream-json で指定 |
--allowedTools |
使えるツールを制限（例："Read,Write" のみ許可） |
--max-turns |
エージェントのターン数上限を設定 |
--bare |
CI 向けの再現性重視モード |
なぜ 2026年6月15日から従量課金に変わるのか
サブスクの収益モデルの歪み
サブスクは「平均的なユーザーが使う量 × 人数」で価格設定する。軽いユーザーの余剰で重いユーザーをカバーする設計だが、自動化ユーザーは意図的に上限まで使い切ることを目的にプログラムを書く。
- Max $200/月 の枠をフルに使うと、API 従量換算で 月 $1,000〜数千ドル相当 のトークンが回せると言われていた
- 対話ユーザー向けに設定した価格で機械が叩き続ける「価格裁定」が成立していた状態
Anthropic の対応（2026年6月15日〜）
サブスクの利用を「インタラクティブ利用」と「プログラマティック利用」に分離する。
| 利用区分 | 対象 | 課金 |
|---|---|---|
| インタラクティブ利用 | Claude.ai・Claude Code の対話TUI・Claude Cowork | サブスクの上限のまま（変化なし） |
| プログラマティック利用 |
-p / Agent SDK / サードパーティツール経由 |
別枠のクレジットから引かれる |
プラン別のクレジット付与額（Anthropic からのメールより）
- Pro プラン：月 $20 クレジットが別枠で付与される（Pro の月額 $20 と同額）
- クレジットを使い切った場合、「extra usage（追加課金）」を手動で有効化しないと利用が止まる
- 黙って青天井に課金される仕組みではない
ポイント
- サブスクの対話用上限はそのまま維持される
- Pro ユーザーは $20 枠内なら追加費用ゼロ
- クレジットは毎月リセット・繰り越しなし・譲渡不可
- クレジットの請求開始は 6月中旬（別途メールで受け取り手続きの案内が来る予定）
-p と SDK の違い
本質的にやっていることは同じ。フロントエンドの違い。
claude -p：CLIコマンド。シェルスクリプト・Makefile・CI の yaml から叩く。
git diff main | claude -p "このPRをコードレビューして" --output-format json
Anthropic SDK：Python/TypeScript のライブラリ。アプリケーションコードに組み込む。
import anthropic
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-opus-4-7",
messages=[{"role": "user", "content": "このコードをレビューして"}]
)
Claude Code SDK（subprocess 経由）：claude -p をプログラムからサブプロセスとして起動する。Claude Code のエージェント機能ごと使えるのが特徴。
import subprocess
result = subprocess.run(
["claude", "-p", "バグを探して修正して", "--allowedTools", "Read,Write"],
capture_output=True, text=True
)
他社ツールのバックエンドとして使われていた事例
サブスク定額のまま他社ツールのバックエンドとして Claude を動かせる抜け穴があった。
| ツール | 手法 |
|---|---|
| Codex（OpenAI CLI） | カスタムプロバイダー設定で claude -p を指定 |
| Cursor | 設定画面で Anthropic API キーを直接入力（公式サポート） |
| Continue.dev（VSCode拡張） | カスタムモデルとして claude -p を外部コマンド指定 |
| Warp AI | oz が提案するコマンドの中に claude -p が含まれる形 |
| 自作エージェント | Claude Code SDK でサブプロセスとして組み込む |
6月15日以降、これらのプログラマティック利用はすべて従量課金の対象になる。
Cursor について
- ベースは VSCode（UIや拡張機能はほぼ同じ）
- Claude・GPT-4・Gemini など複数モデルを切り替えられる
- Agent モード・Composer モードなど独自のAI機能を内蔵
Claude Code との違い：
- Claude Code → ターミナルベース、Claude 専用
- Cursor → エディタUI、マルチモデル対応
CI/CD での実践的な使い方
基本パターン：PR 自動レビュー
# .github/workflows/ai-review.yml
on: [pull_request]
jobs:
ai-review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Claude でコードレビュー
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
git diff origin/main | claude -p "このPRをレビューして問題点を日本語で指摘して" \
--output-format json > review.json
# 結果をPRコメントに投稿する処理...
公式 GitHub Action を使う方法
Anthropic が公式の GitHub Action（anthropics/claude-code-action@v1）を提供している。PR コメントへの返信・CI 失敗の自動修正などが可能。
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
prompt: "テストが失敗している原因を調べて修正してください"
実際のユースケース一覧
| ユースケース | 効果 |
|---|---|
| PR 自動コードレビュー | 人間レビュー前に問題を先出しできる |
| ユニットテスト自動生成 | 未テストのコードブランチを平均 72% カバーできると報告あり |
| ESLint エラー自動修正 | lint エラーの解決時間を平均 85% 削減との報告あり |
| テスト失敗の原因解析 | エラーログを投げて「なぜ落ちたか」を自動コメント |
| セキュリティチェック | マージ前に脆弱性スキャン |
| リリースノート自動生成 | コミットログを要約 |
| チェンジログ生成 | バージョン間の差分を自動文書化 |
| アクセシビリティ監査 | UI コンポーネントの a11y 問題を検出 |
| ドキュメント翻訳 | 多言語対応ドキュメントの自動更新 |
| 技術的負債の検出 | コードの複雑度・改善余地を定期レポート |
セキュリティ上の注意点
CI 環境で claude -p を使う際は以下を推奨。
# シークレットの漏洩防止
export CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1
# 実行できるツールを最小限に制限
claude -p "..." --allowedTools "Read,Write" --max-turns 3
GitHub Actions はシークレットを自動でマスクするが、Claude のサブプロセスに環境変数ごと渡さないよう ENV_SCRUB フラグを設定するのがベストプラクティス。
注意点
便利ではあるが「必須」ではない。AI レビューを挟むと「AI が OK と言ったから」で人間のレビューが甘くなるリスクもある。チームの文化・規模によって合う合わないがある。月数ドル〜十数ドル規模のコストで運用できているチームも多い。