Anthropic ant CLI実践ガイド — curlを卒業して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-5-20250929",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "日本の首都は？"}
    ]
  }'

# ant CLIの場合 — フラグ指定でシンプル
ant messages create \
  --model claude-sonnet-4-5-20250929 \
  --max-tokens 1024 \
  --message '{role: user, content: [{type: text, text: "日本の首都は？"}]}'

# 1. Homebrew（macOSで最も簡単）
brew install anthropics/tap/ant

# 2. Goソースビルド（Go 1.22以上が必要）
go install github.com/anthropics/anthropic-cli/cmd/ant@latest

xattr -d com.apple.quarantine "$(brew --prefix)/bin/ant"

export ANTHROPIC_API_KEY="sk-ant-..."
ant models list

ant messages create \
  --model claude-sonnet-4-5-20250929 \
  --max-tokens 1024 \
  --system "あなたは優秀なプログラマーです" \
  --message '{role: user, content: [{type: text, text: "FizzBuzzをPythonで書いて"}]}'

# テキストファイルを渡す
ant messages create \
  --model claude-sonnet-4-5-20250929 \
  --max-tokens 2048 \
  --message '{role: user, content: [{type: text, text: "@./prompt.txt"}]}'

# 画像をbase64自動変換して渡す
ant messages create \
  --model claude-sonnet-4-5-20250929 \
  --max-tokens 1024 \
  --message '{role: user, content: [{type: image, source: {type: base64, media_type: "image/png", data: "@data://./screenshot.png"}}]}'

# テキスト本文だけ抽出
ant messages create \
  --model claude-sonnet-4-5-20250929 \
  --max-tokens 1024 \
  --message '{role: user, content: [{type: text, text: "今日の日付は？"}]}' \
  --transform 'content.0.text' \
  --format yaml

# シェル変数に代入するパターン
RESULT=$(ant messages create \
  --model claude-sonnet-4-5-20250929 \
  --max-tokens 256 \
  --message '{role: user, content: [{type: text, text: "Hello"}]}' \
  --transform 'content.0.text' \
  --format yaml)
echo "$RESULT"

# エージェント作成
ant beta:agents create \
  --name "summarizer" \
  --model claude-sonnet-4-5-20250929 \
  --description "テキスト要約エージェント" \
  --system "渡されたテキストを3行以内に要約してください"

# 1. エージェント作成 → IDを取得
AGENT_ID=$(ant beta:agents create \
  --name "code-reviewer" \
  --model claude-sonnet-4-5-20250929 \
  --system "コードレビューを行い、改善点を指摘してください" \
  --transform id --format yaml)

# 2. 環境作成
ENV_ID=$(ant beta:environments create \
  --name "review-env" \
  --transform id --format yaml)

# 3. セッション作成
SESSION_ID=$(ant beta:sessions create \
  --agent "{id: $AGENT_ID}" \
  --environment-id "$ENV_ID" \
  --transform id --format yaml)

# 4. メッセージ送信
ant beta:sessions:events send \
  --session-id "$SESSION_ID" \
  --event '{type: user.message, content: [{type: text, text: "def add(a, b): return a + b のレビューをお願いします"}]}'

# 5. ストリーミングで結果取得
ant beta:sessions stream --session-id "$SESSION_ID"

# デバッグモードで実行
ant messages create \
  --model claude-sonnet-4-5-20250929 \
  --max-tokens 256 \
  --message '{role: user, content: [{type: text, text: "test"}]}' \
  --debug 2>debug.log