ヘッドレス Claude Code の魅力
Claude Code は対話型の TUI が看板だが、Agent SDK 経由でヘッドレス起動できることで、cron 起動・CI 起動・他システム連携が可能になる。「人が触らない時間に勝手にリファクタが進む」という体験は破壊的。
基本起動
```bash claude -p "依存ライブラリを最新化して、テストを通して、PR を作成して" \ --output-format stream-json \ --max-turns 20 \ --permission-mode auto ```
cron 統合
```cron 0 3 * * * cd /repo && claude -p "$(cat .claude/cron/dep-update.md)" --max-turns 10 >> /var/log/claude-cron.log 2>&1 ```
GitHub Actions
```yaml on: schedule: [{ cron: '0 18 * * *' }] jobs: refactor: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: anthropic/claude-code-action@v1 with: prompt-file: .claude/cron/refactor-suggest.md max-turns: 15 api-key: ${{ secrets.ANTHROPIC_API_KEY }} ```
用途例
- 依存ライブラリ更新 PR 自動作成
- 翻訳ファイル更新 PR
- 静的解析の指摘を順次解消
- ドキュメント差分を毎日要約してチームに通知
ガードレール
- ファイル書き込み権限の制限（許可ディレクトリのみ）
- ネットワーク呼び出しは egress proxy で制御
- 自動 PR は `auto-merge` を付けず、人レビューを必須化
- 失敗時の Slack 通知 + ログ保管
観測
- 各 cron 実行のトークン消費・レイテンシ
- 失敗率と原因のクラスタリング
- 自動 PR のマージ率（成果指標）
まとめ
Claude Code のヘッドレス運用は「夜間に勝手に進むエンジニアリング作業」を実現する強力な手段。社内 R&D では依存更新 PR の自動化だけで月 12 時間の手作業を削減できた。最初は依存更新・型修正・lint 是正など低リスク領域から始めるのが安全。