APIモードとは

Claude Codeは通常、ターミナルで対話的に使用しますが、--printフラグを付けることで**非対話型モード（APIモード）**で実行できます。このモードでは、プロンプトを引数で渡し、結果を標準出力に返すため、シェルスクリプトやCI/CDパイプラインからの呼び出しに最適です。

# 基本的な使い方
claude --print "このプロジェクトのREADMEを要約して"

# JSON形式で出力
claude --print --output-format json "src/index.tsの問題点を分析して"

基本的なフラグとオプション

--print（-p）

最も基本的なフラグです。対話型UIを起動せず、結果をそのまま標準出力に書き出します。

# パイプとの組み合わせ
claude -p "このコードをレビューして" < src/main.ts

# 結果をファイルに保存
claude -p "テストケースを生成して" > tests/generated.test.ts

--output-format

出力形式を指定します。text（デフォルト）、json、stream-jsonから選択できます。

# JSON形式で構造化された結果を取得
claude -p --output-format json "バグを分析して"

JSON出力の場合、以下のような構造で結果が返されます。

{
  "result": "分析結果のテキスト",
  "cost_usd": 0.042,
  "duration_ms": 3200,
  "tokens_used": {
    "input": 15000,
    "output": 2400
  }
}

--max-turns

エージェントのループ回数を制限します。自動化で暴走を防ぐために重要です。

claude -p --max-turns 5 "このバグを修正して"

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

GitHub Actions での活用

GitHub ActionsにClaude Codeを組み込むことで、PR作成時に自動的にコードレビューやテスト生成を行えます。

name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
      - name: Run Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          git diff origin/main...HEAD | claude -p \
            "このdiffをレビューして、問題点があればMarkdown形式で指摘して" \
            > review.md
      - name: Post Review Comment
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const review = fs.readFileSync('review.md', 'utf8');
            github.rest.issues.createComment({
              owner: context.repo.owner,
              repo: context.repo.repo,
              issue_number: context.issue.number,
              body: review
            });

定期実行でのコード品質チェック

cronスケジュールで定期的にコードベースを分析することもできます。

#!/bin/bash
# daily-analysis.sh
REPORT=$(claude -p --output-format json \
  "プロジェクト全体の技術的負債を分析し、優先度順にリストアップして")

echo "$REPORT" | jq -r '.result' > /tmp/daily-report.md
# Slackに通知するなどの後処理

実践的な活用パターン

パターン1：コミットメッセージの自動生成

# git hookに組み込み
git diff --cached | claude -p \
  "この変更内容に適切なコミットメッセージを日本語で生成して。Conventional Commits形式で。"

パターン2：ドキュメント自動更新

# APIの変更を検知してドキュメントを更新
claude -p "src/api/ディレクトリのコードを読んで、API仕様書をdocs/api.mdに反映して。既存の形式を維持すること。"

パターン3：依存関係の脆弱性分析

claude -p --max-turns 3 \
  "package.jsonの依存関係をチェックし、既知の脆弱性がないか分析して"

セキュリティ上の注意点

APIモードをCI/CDで使用する際は以下の点に注意してください。

• APIキーの管理 — 環境変数やシークレットマネージャーで管理し、コードにハードコードしない
• --max-turnsの設定 — 無限ループを防ぐため必ず上限を設定
• --allowedToolsの制限 — 本番環境での実行時は使用可能なツールを最小限に制限
• 出力の検証 — AIの出力を無条件に適用せず、テスト通過を必須条件にする

# ツールを制限した安全な実行例
claude -p --max-turns 3 \
  --allowedTools "Read,Grep,Glob" \
  "セキュリティ上の問題点を分析して"

まとめ

Claude CodeのAPIモードは、AIコーディングアシスタントをワークフローに深く統合するための強力な手段です。--printと--output-format jsonを組み合わせることで、コードレビュー、テスト生成、ドキュメント更新など多くの作業を自動化できます。まずは簡単なスクリプトから始めて、段階的にCI/CDパイプラインに組み込んでいくのがおすすめです。