ヘッドレスモードとは？

詳しい解説

ヘッドレスモードは claude -p "指示" --output-format json のように、コマンドラインから非対話的に Claude Code を実行する方法です。GitHub Actions や CI/CD パイプラインに組み込んで、PR の自動レビュー、テストコード生成、ドキュメント更新などを自動化できます。--output-format json を指定すると、結果を機械可読な JSON 形式で受け取れます。-p フラグ（--print）は単一のプロンプトを渡して結果を標準出力に返すモードで、シェルスクリプトやパイプラインとの相性が抜群です。出力フォーマットは text（デフォルト）、json、stream-json から選べ、json は後続のスクリプトで jq などで加工するのに便利です。実用的な活用例として、GitHub Actions で PR がオープンされたときに変更差分を自動レビューする、git commit-msg フックでコミットメッセージを自動生成する、cron ジョブで定期的にコード品質レポートを生成する、といったパターンがあります。--dangerously-skip-permissions と組み合わせると完全に無人で実行でき、--allowedTools で許可するツールを限定すればセキュリティと自動化のバランスを取れます。会話の継続が必要な場合は --session-id で既存のセッションを再開でき、複数ステップのワークフローも構築可能です。

使用例

claude -p "Fix all TypeScript errors" --output-format json