claude -pで要約・判定・整形を一度だけ実行する

Claude CodeのCLIには対話REPLと、--print（短縮形 -p）で応答を出力して終了するモードがあります。公式CLIリファレンスには、標準入力をパイプする例、--output-format の text・json・stream-json、--max-turns などが掲載されています。 CLIリファレンス

まず短い入力で試す

大量処理の前に、一つの入力が正しく出力されることを確かめます。

1. 1入力を渡す短いメモか、対象を絞った標準入力を用意。
2. 2claude -pで処理目的と出力形式、変更しない範囲を指定。
3. 3出力を検査終了結果・空出力・構文・必要な値を確認。
4. 4採用して保存検査済みの結果だけを後工程へ渡す。

CLIのJSON形式と、任意のスキーマに沿う出力は同じではありません。受け取る側でも中身を確認します。

claude -p "次のメモを箇条書きに整理して。本文にない事実は追加しない。メモ：今日は資料を整理する。明日は下書きを作る。公開日はまだ決まっていない。"

上は架空のメモです。「公開日が決まっていない」が、具体的な日付へ変わっていないかを確かめます。

実際の文章を渡す場合は、機密情報を除いて標準入力へパイプします。

Get-Content .\note.md -Raw | claude -p "要点を箇条書きで返して。元の表現を引用しすぎない。"

ワンショットは一回の処理に向きますが、毎回まったく同じ文脈とは限りません。入力ファイル、作業ディレクトリ、CLAUDE.md、権限、モデル、CLIバージョンを記録します。外部通信やファイル編集が不要なら、依頼文で「読み取りと出力だけ」と明記します。

JSONを後工程へ渡す

claude -p "タイトルと要確認フラグをJSONで返して。説明文は追加しない。" --output-format json

これはCLI応答の形式をJSONへする指定です。任意のJSON Schemaへ厳密に適合させるAPIのStructured Outputsとは別機能なので、受信側で構文・必須キー・型・値を検証します。 Structured Outputs

大量処理では、まず1ファイルで出力と終了コードを確認し、次に一覧を固定して進めます。失敗時は入力名とエラーをログへ残し、個人情報やAPIキーを保存しません。--max-turns は非対話実行のターン数を制限できますが、成功や正確性の保証ではありません。

記事原稿への応用はテキスト整形、ファイル単位の整理はフォルダー整理、SDKで継続対話を組むならPythonエージェントを参照してください。

限界

ワンショットは短い処理を簡潔にする手段で、検証工程を省く機能ではありません。出力を保存する前に、文字コード、JSON構文、根拠、対象ファイル、権限を確認します。コマンドやフラグは更新されるため、実行日に公式リファレンスを再確認してください。

定型処理に組み込むなら、入力が空のとき、CLIが見つからないとき、終了コードが失敗のとき、出力が空のときの分岐を用意します。ファイルを上書きする前に一時ファイルへ保存し、検査に通った場合だけ置き換えます。標準入力へ渡す内容は必要最小限にし、ログには本文ではなくファイル名と結果だけを残す方法も検討します。