Claude Code --bare フラグ — スクリプト自動化とヘッドレス実行の新標準

# 基本的な使い方
claude -p "このコードのバグを見つけてください" --bare
 
# API キーを明示的に指定する場合
ANTHROPIC_API_KEY=sk-ant-xxx claude -p "src/utils.ts のユニットテストを生成してください" --bare
 
# JSON 形式で出力を受け取る
claude -p "package.json の依存関係を分析してください" --bare --output-format json

# 方法1: 環境変数で API キーを渡す（推奨）
export ANTHROPIC_API_KEY="sk-ant-your-key-here"
claude -p "コードを分析してください" --bare
 
# 方法2: --settings で apiKeyHelper を指定する
claude -p "コードを分析してください" --bare \
  --settings '{"apiKeyHelper": "op read op://vault/anthropic/api-key"}'

# .github/workflows/claude-review.yml
name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]
 
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
 
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
 
      - name: Run Claude Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          # 変更されたファイルの差分を取得
          DIFF=$(git diff origin/main...HEAD)
 
          # --bare フラグで高速レビュー実行
          claude -p "以下のコード差分をレビューしてください。
          バグ、セキュリティ問題、パフォーマンス改善点を指摘してください。
 
          $DIFF" \
            --bare \
            --output-format json \
            --max-turns 3 \
            --max-budget-usd 0.50

#!/bin/bash
# generate-tests.sh — カバレッジ不足のファイルにテストを自動生成
 
set -euo pipefail
 
# テストが存在しないソースファイルを検出
find src/ -name "*.ts" -not -name "*.test.ts" -not -name "*.d.ts" | while read -r file; do
  test_file="${file%.ts}.test.ts"
 
  if [ ! -f "$test_file" ]; then
    echo "📝 テスト生成: $file"
 
    # --bare で高速実行、--max-turns で安全制限
    claude -p "以下のファイルのユニットテストを生成してください。
    Jest を使用し、主要な関数をカバーしてください。
    テストファイルの内容のみを出力してください。
 
    ファイル: $file
    $(cat "$file")" \
      --bare \
      --max-turns 5 \
      --output-format text > "$test_file"
 
    echo "✅ 生成完了: $test_file"
  fi
done
 
echo "🎉 バッチテスト生成が完了しました"

# --channels でツール承認プロンプトをスマートフォンに転送
claude -p "本番データベースのマイグレーションを実行してください" \
  --bare \
  --channels permission-relay \
  --max-turns 10
 
# 期待される動作:
# 1. --bare で高速起動
# 2. ファイル変更やコマンド実行時に承認リクエストが
#    Telegram/Discord に送信される
# 3. スマートフォンで承認/拒否を選択
# 4. 承認後に処理が続行

# 推奨: 3つの安全フラグを常にセットで使用
claude -p "$PROMPT" \
  --bare \
  --max-turns 5 \        # 推論ループの上限
  --max-budget-usd 1.00  # コスト上限（USD）
 
# さらに厳密な制御が必要な場合
claude -p "$PROMPT" \
  --bare \
  --max-turns 3 \
  --max-budget-usd 0.50 \
  --output-format json \
  --allowedTools "Read,Grep,Glob"  # 使用可能なツールを制限