Claude Code CLI上級編：CI/CDパイプラインとバッチ処理の自動化

Claude CodeはAnthropicが提供するCLIツールで、ターミナルから直接AIにコーディング作業を依頼できる。GUIベースのチャットとは違い、既存の開発ワークフローにそのまま組み込めるのが最大の強みだ。

Claude Code CLIの基本

インストールと初期設定

npm install -g @anthropic-ai/claude-code

インストール後、claude コマンドで対話モードに入れる。だが本当に強力なのは、非対話モードでの活用だ。

非対話モード（ワンライナー実行）

claude -p "この関数にエラーハンドリングを追加して" < src/utils/api.ts

-p フラグでプロンプトを渡し、標準入力でファイルを流し込む。結果は標準出力に返るので、パイプで次の処理に繋げられる。

実践ユースケース

1. コードレビューの自動化

git diff --staged | claude -p "このdiffをレビューして。バグ、パフォーマンス問題、セキュリティリスクを指摘して"

pre-commitフックに仕込めば、コミットのたびに自動レビューが走る。人間のレビュー前にAIが一次チェックを済ませることで、レビューの質と速度が上がる。

2. テストコードの自動生成

claude -p "この関数のユニットテストをJestで書いて。エッジケースも含めて" < src/services/payment.ts > tests/payment.test.ts

実装ファイルを入力して、テストファイルを直接出力する。生成後に npm test を走らせてパスするかまで確認するスクリプトを組めば、TDDサイクルが加速する。

3. ドキュメント生成パイプライン

find src/api -name "*.ts" -exec cat {} + | claude -p "これらのAPIエンドポイントのOpenAPI仕様書を生成して" > docs/api-spec.yaml

複数ファイルをまとめて流し込み、構造化されたドキュメントを一括生成する。CIに組み込めば、コード変更時にドキュメントが自動更新される。

4. エラーログの分析

tail -100 /var/log/app/error.log | claude -p "このエラーログを分析して。根本原因と修正案を提示して"

本番環境のトラブルシューティングが格段に速くなる。ログの量が多くても、AIが要点を抽出してくれる。

CI/CDパイプラインへの統合

GitHub Actionsでの活用例

- name: AI Code Review
  run: |
    git diff ${{ github.event.pull_request.base.sha }} HEAD | \
    claude -p "PRの変更をレビューして。重要な問題のみ指摘して" > review.md

PRが作成されるたびに自動レビューが走り、結果をコメントとして投稿する仕組みが作れる。

バッチ処理スクリプト

#!/bin/bash
for file in src/legacy/*.js; do
  claude -p "このJavaScriptをTypeScriptに変換して。型は厳密に付けて" < "$file" > "${file%.js}.ts"
done

レガシーコードのマイグレーションを半自動化できる。完全な自動変換は危険だが、8割の作業をAIに任せて残り2割を人間が確認する運用が現実的だ。

効果的な使い方のコツ

コンテキストを十分に渡す

CLIの場合、GUIと違ってプロジェクト全体の文脈が自動で渡されない。関連ファイルは明示的に標準入力で渡すか、プロンプト内で説明する必要がある。

cat tsconfig.json src/types.ts src/target.ts | claude -p "target.tsをリファクタリングして。型定義とtsconfig設定を踏まえて"

出力形式を指定する

「コードだけ出力して。説明は不要」と明示すると、パイプラインで扱いやすい出力が得られる。

claude -p "以下のCSVをJSON配列に変換して。コードブロックなしで出力して" < data.csv > data.json

セッション機能の活用

claude で対話モードに入ると、プロジェクトのファイルを自動認識する。複雑なリファクタリングや設計相談は対話モードの方が向いている。

コスト管理

Claude Code CLIはAPI利用料が発生する。大量のファイルを処理する場合は事前にトークン数を見積もるべきだ。

短い関数の変換：1回あたり約$0.01〜$0.03
ファイル全体のレビュー：1回あたり約$0.05〜$0.15
複数ファイルのバッチ処理：合計で$1〜$5程度

月額の上限設定をAPIダッシュボードで行っておくと安心だ。

まとめ

Claude Code CLIの価値は「AIをUNIXパイプラインの一部にできる」ことにある。既存のシェルスクリプト、CI/CD、開発ワークフローにそのまま差し込める。

GUIのチャットでコードを貼り付けてコピペで戻す時代は終わった。ターミナルに留まったまま、AIの力を開発フロー全体に行き渡らせる。それがClaude Code CLIの本質的な活用法だ。