CLIスクリプティングと自動化

このページでは、ant CLIを基盤としたタスク指向のワークフローについて説明します。基礎となるフラグや出力オプションについては、CLIの使用を参照してください。



APIリソースのバージョン管理

CLIを使用して、スキル、エージェント、環境、デプロイメントなどのAPIリソースをリポジトリ内のYAMLファイルとしてバージョン管理し、Claude APIと同期させることができます。



スクリプティングパターン

CLIは標準的なシェルツールと組み合わせて使用できるように設計されています。



リスト出力を2番目のコマンドに連結する

リストエンドポイントで--transform id --raw-outputを使用すると、1行につき1つのIDのみが出力されるため、headやxargsなどの標準ツールを直接適用できます。最初の結果を取得し、それを後続のコマンドに渡します：

FIRST_AGENT=$(ant beta:agents list \
  --transform id --raw-output | head -1)

ant beta:agents:versions list \
  --agent-id "$FIRST_AGENT" \
  --transform "{version,created_at}" --format jsonl



エラーを調査する

--transform-errorと--format-errorフラグは、エラーレスポンスに対して同じフィルタリングを適用します。--raw-outputはエラーには適用されないため、引用符なしのスカラーを得るには--format-error yamlを使用してください。エラーメッセージのみを抽出します：

ant beta:agents retrieve --agent-id bogus \
  --transform-error error.message --format-error yaml 2>&1

GET "https://api.anthropic.com/v1/agents/bogus?beta=true": 404 Not Found
Agent not found.



Claude CodeからCLIを使用する

Claude Codeは、ant CLIをそのまま使用できます。CLIがインストールされ認証されていれば、Claude CodeにAPIリソースを直接操作するよう依頼できます。例えば：

• 「最近のエージェントセッションを一覧表示して、どれがエラーになったか要約して。」
• 「./reports内のすべてのPDFをFiles APIにアップロードして、結果のIDを出力して。」
• 「セッションsession_01...のイベントを取得して、エージェントがどこで行き詰まったか教えて。」

Claude Codeはantをシェルで実行し、構造化された出力を解析し、結果について推論します（カスタム統合コードは不要です）。



CLI認証情報でcurlリクエストを認証する

curlやその他のHTTPクライアントでAPIを呼び出すスクリプトは、静的なAPIキーの代わりにant auth loginによって保存された認証情報を使用できます。OAuthアクセストークンはベアラートークンとしてAuthorizationヘッダーに入れます。x-api-keyヘッダーは静的なAPIキー専用です。

ant auth print-credentials --access-tokenは、アクティブなプロファイルのアクセストークンを出力します。期限切れまたは期限切れ間近の場合は、先にリフレッシュされます：

curl https://api.anthropic.com/v1/messages \
  -H "Authorization: Bearer $(ant auth print-credentials --access-token)" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "hi"}]
  }'

ant auth statusを実行して、どの組織とワークスペースにログインしているかを確認してください。環境変数がログインを上書きしている場合は警告が表示されます。