Anthropic公式CLI「ant」実践ガイド — curlを卒業してYAMLでClaude APIを管理する新しい開発ワークフロー

# curl — JSON手書き
curl -X POST https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-6","max_tokens":1024,"messages":[{"role":"user","content":"Hello, Claude"}]}'

# Python SDK — 本番コード向き
import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}]
)

# ant — コマンド一発
ant messages create \
  --model claude-sonnet-4-6 \
  --max-tokens 1024 \
  --message '{role: user, content: "Hello, Claude"}'

# macOS
brew install anthropics/tap/ant

# Linux/WSL — バイナリ直接ダウンロード
VERSION=1.3.2
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
ARCH=$(uname -m | sed -e 's/x86_64/amd64/' -e 's/aarch64/arm64/')
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
  | sudo tar -xz -C /usr/local/bin ant

# Go
go install github.com/anthropics/anthropic-cli/cmd/ant@latest

export ANTHROPIC_API_KEY=sk-ant-api03-...
ant --version   # v1.3.2
ant models list # 利用可能なモデル一覧

ant messages create ...           # Messages API
ant models list                   # モデル一覧
ant beta:agents retrieve --agent-id agent_01...  # betaリソース
ant beta:sessions:events list --session-id ...   # ネストしたサブリソース

# システムプロンプトをファイルから読み込み
ant messages create \
  --model claude-opus-4-7 \
  --max-tokens 1024 \
  --system @./prompts/reviewer.txt \
  --message '{role: user, content: "このコードをレビューして"}'

# PDFをVision APIに送信（自動base64エンコード）
ant messages create \
  --model claude-opus-4-7 \
  --max-tokens 1024 \
  --message '{role: user, content: [
    {type: document, source: {type: base64, media_type: application/pdf, data: "@./report.pdf"}},
    {type: text, text: "この資料を要約して"}
  ]}' \
  --transform 'content.0.text' --format yaml

# テキスト部分だけ抽出
ant messages create ... --transform 'content.0.text' --format yaml

# agentのid, name, modelだけ一覧
ant beta:agents list --transform '{id,name,model}' --format jsonl

# prompt.yaml
model: claude-sonnet-4-6
max_tokens: 1024
system: |
  あなたはシニアコードレビュアーです。
  セキュリティ上の問題を重点的に指摘してください。
messages:
  - role: user
    content: |
      以下のコードをレビューしてください。
      ...

ant messages create < prompt.yaml --transform 'content.0.text' --format yaml

# エージェント作成（YAMLヒアドキュメント）
ant beta:agents create <<'YAML'
name: Research Agent
model: claude-opus-4-7
system: |
  あなたはリサーチアシスタントです。主張には必ず出典を付けてください。
YAML

# IDを変数にキャプチャ
AGENT_ID=$(ant beta:agents create \
  --name "My Agent" \
  --model '{id: claude-sonnet-4-6}' \
  --transform id --format yaml)

# .github/workflows/review.yml（抜粋）
- name: AI Code Review
  env:
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
  run: |
    DIFF=$(git diff HEAD~1)
    echo "$DIFF" | ant messages create \
      --model claude-sonnet-4-6 \
      --max-tokens 2048 \
      --system "コード差分をレビューし、問題点を指摘してください" \
      --message "{role: user, content: \"$(cat)\"}" \
      --transform 'content.0.text' --format yaml

# シンプルなリトライパターン
for i in 1 2 3; do
  result=$(ant messages create ... 2>&1) && break
  echo "Retry $i..." >&2
  sleep $((i * 30))
done