Claude Platform ant CLI: 公式開発者ガイド

リリース内容

要約： Claude Platformに公式API CLIである antが登場しました。

このローンチツイートは、本製品の用途（API呼び出し、Managed Agents、シェルパイプライン、コーディングエージェント）を端的に示しており有用です。公式CLIドキュメントでは、OAuthログイン、APIキー、ワークスペースプロファイル、YAMLおよびJSONリクエストボディ、GJSON変換、自動ページネーション、デバッグ出力、シェル補完、リソースヘルプといった詳細な仕組みが解説されています。

The new workflow shape:

terminal command
  -> ant resource action
  -> Claude API endpoint
  -> structured JSON/YAML/raw output
  -> shell pipeline, CI step, or Claude Code agent

一文での定義

The ant CLI is Anthropic's command-line interface for calling Claude API resources from a terminal.これはPythonやTypeScriptのSDKを置き換えるものではありません。エンドポイントの探索、APIリソースのスクリプト化、出力のパイプ処理、そしてClaude Codeがカスタム統合コードなしでプラットフォームの状態を検査できるようにするための、シェルネイティブなインターフェースです。

メンタルモデル：4つの要素

読み取り ant シェルワークフローとClaude Platform間の小さなアダプターとして機能します。公式ドキュメントでは、Messages、ベータリソース、出力変換、Claude Codeの使用方法において、一貫したパターンが繰り返されています。

[credentials/profile]
        |
        v
[ant resource:subresource action] --flags < stdin.yaml
        |
        v
[Claude API resource]
        |
        v
[formatted output] --transform -> shell, CI, or Claude Code

• 認証情報： OAuthログイン、API key、フェデレーション、または名前付きプロファイル。
• コマンド： a resource action パターン。ネストされたリソースはコロンで区切られます。
• 入力： フラグ、stdinのYAML/JSON、および @file インラインファイルコンテンツへの参照。
• 出力： フォーマット済みJSON、YAML、JSONL、raw出力、インタラクティブエクスプローラー、およびGJSON変換。

インストールと検証

The CLI docs show install paths for Homebrew on macOS, curl on Linux/WSL, and Go. The least ambiguous official commands are Homebrew and Go, followed by the version check:

# macOS
brew install anthropics/tap/ant

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

# Verify
ant --version

ドキュメントには、公開されているすべてのAPIリソースがローカルのヘルプ出力に表示されると記載されています。新規インストール時は、以下を実行してください。 ant --help、次に以下を追記します。 --help 使用予定のリソースに対して、例えば ant messages create --helpのように指定します。

認証：OAuth、API Keys、およびプロファイル

公式ドキュメントでは、認証をローカル開発用と非対話型ワークロード用に分けています。開発者用マシンについては、 ant auth login Claude Consoleに対するブラウザベースのOAuthフローを開始します。ローカルブラウザが利用できないリモートホストの場合は、 --no-browser フラグを使用すると認証用URLが表示され、返されたコードを貼り付けるよう求められます。

ant auth login
ant auth login --no-browser
ant auth login --workspace-id wrkspc_01...
ant auth login --profile platform-dev

ant auth status
ant auth logout
ant auth logout --all

ワークスペースに関する重要な詳細：OAuthログイン時に組織とワークスペースを選択します。トークンはそのワークスペースにスコープされます。複数のワークスペースで作業する場合は、ワークスペースごとにプロファイルを作成し、明示的にプロファイルを切り替えてください。

ant auth login --profile other-ws
ant profile activate other-ws

ant --profile other-ws models list
ANTHROPIC_PROFILE=other-ws ant models list

CI、コンテナ、サーバー環境では、CLIドキュメントは対話型ログインではなく、Workload Identity Federationの使用を推奨しています。これにより、インストール後のルールが明確になります。つまり、ローカルマシンにはOAuth、自動化にはFederation、意図的にキーベースの認証が必要な場合にはAPIキーを使用します。

最小限のエンドツーエンドリクエスト

一度 ant がインストールされ認証されると、ドキュメントはMessages APIから始まります。これが最小構成です：モデル、最大トークン数、そしてユーザーメッセージ。

ant messages create \
  --model claude-opus-4-8 \
  --max-tokens 1024 \
  --message '{role: user, content: "Hello, Claude"}'

ドキュメントでは、レスポンスは完全なAPIオブジェクトとして示されています。モデルID、メッセージID、アシスタントロール、コンテンツ配列、停止理由、および使用量が含まれます。CLIは、stdoutがターミナルの場合、そのオブジェクトを整形して表示します。

コマンド構造

コマンドは resource action という形式に従います。ネストされたリソースにはコロンを使用し、ベータ版リソースは beta:の下に配置されます。ドキュメントでは、エージェント、セッション、デプロイメント、環境、スキルがベータ版リソースとして定義されています。

ant <resource>[:<subresource>] <action> [flags]

ant models list
ant messages create --model claude-opus-4-8 --max-tokens 1024 ...
ant beta:agents retrieve --agent-id agent_01...
ant beta:sessions:events list --session-id session_01...

ベータ版のプレフィックスが重要なのは、それらのコマンドが自動的に適切な anthropic-beta ヘッダーをそのリソースに対して送信するためです。ドキュメントでは、 --betaを使用するのはデフォルトのスキーマバージョンを上書きする必要がある場合のみとされています。

出力形式とGJSON変換

出力は、 ant 単なる便利なラッパー以上の存在となり、 curl。ドキュメントには以下が記載されています： autoAntigravity jsonGemini jsonlChrome yamlMCP prettyAgent-First rawIDE exploreAPI。リストエンドポイントは自動的にページネーションされ、リストの出力はシェルコマンドへスムーズにストリームできます。

変換言語にはGJSONを使用します。リストエンドポイントの場合、変換はエンベロープ全体ではなく、各アイテムに対して実行されます。そのため、このパターンを使用すると、エージェントのサマリーを1行に1つずつ出力できます：

ant beta:agents list \
  --transform "{id,name,model}" \
  --format jsonl

私の実践的な見解：次のコマンドがシェルツールである場合は --format jsonl を使用し、 --transform id --raw-output 次のコマンドでリソースIDが必要な場合は ant 呼び出し (invocation)。

手書きのJSONを使わずにリクエストボディを渡す

CLIのドキュメントには、フラグ、stdin、ファイル参照という3つの入力モードが記載されています。スカラーフィールドはフラグにマッピングされます。構造化フィールドは、緩やかなYAML風の構文または厳密なJSONを受け入れます。リクエストボディ全体は、JSONまたはYAMLとしてstdin経由でパイプ処理できます。

ant beta:agents create <<'YAML'
name: Research Agent
model: claude-opus-4-8
system: |
  You are a research assistant. Cite sources for every claim.
tools:
  - type: agent_toolset_20260401
YAML

ファイルコンテンツについては、ドキュメントでは以下を使用しています。 @pathこれにより、プロンプトファイルを文字列フィールドにインライン化したり、PDFをMessages APIに送信したりできます。CLIはバイナリファイルを自動的に検出し、base64エンコードします。

ant beta:agents create \
  --name "Researcher" \
  --model '{id: claude-sonnet-4-6}' \
  --system @./prompts/researcher.txt

ant messages create \
  --model claude-opus-4-8 \
  --max-tokens 1024 \
  --message '{role: user, content: [
    {type: document, source: {type: base64, media_type: application/pdf, data: "@./scan.pdf"}},
    {type: text, text: "Extract the text from this scanned document."}
  ]}' \
  --transform 'content.0.text' --raw-output

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

プラットフォームチームにとって最も重要なリリースの詳細は、1行のMessages呼び出しではありません。それは、APIリソースをYAMLファイルで管理する方法を説明したドキュメントセクションです。この例では、Managed Agent、環境、セッション、ユーザーイベント、およびセッションイベントのリストを扱っています。

# summarizer.agent.yaml
name: Summarizer
model: claude-sonnet-4-6
system: |
  You are a helpful assistant that writes concise summaries.
tools:
  - type: agent_toolset_20260401

ant beta:agents create < summarizer.agent.yaml
ant beta:agents update --agent-id agent_011... --version 1 < summarizer.agent.yaml

# summarizer.environment.yaml
name: summarizer-env
config:
  type: cloud
  networking:
    type: unrestricted

ant beta:environments create < summarizer.environment.yaml

ant beta:sessions create \
  --agent agent_011CYm1BLqPXpQRk5khsSXrs \
  --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
  --title "Summarization task"

このパターンにより、プラットフォームリソースをレビュー可能で、リポジトリに保存でき、CIから更新可能なファイルに変換できます。CLIはガバナンスの必要性を排除するものではありませんが、運用上のオブジェクトモデルをシェルスクリプトから可視化できるようにします。

Claude Codeから ant を使用する

リリースのツイートには次のようにあります。 ant はコーディングエージェントによく理解されており、CLIドキュメントは Claude Code の動作を明確にしています。 ant がインストールされ認証されている場合、Claude Code はそれをシェルから呼び出し、構造化された出力を解析し、その結果に基づいて推論を行うことができます。

Prompts the docs say are now reasonable:

"List my recent agent sessions and summarize which ones errored."
"Upload every PDF in ./reports to the Files API and print the resulting IDs."
"Pull the events for session session_01... and tell me where the agent got stuck."

実用的な意味として、Claude Code は多くの Claude Platform リソースを理解するために独自のスクリプトを必要としなくなりました。 antをインストールし、適切なワークスペースに対して認証を行うと、Claude Code は使用可能な構造化されたコマンドインターフェースを取得します。

リリースを読んでいて私が誤解していたこと

私の最初の誤った想定は、 ant が単なる見栄えの良い Messages API のラッパーに過ぎないというものでした。ドキュメントにより、より広範なターゲットが明らかになりました。それは、APIリソース操作、ベータ版の Managed Agents、環境、セッション、ファイル、プロファイル、変換、そして Claude Code との連携です。

2つ目の誤った想定は、プロファイルの切り替えが常に優先されるというものでした。実際はそうではありません。もし ANTHROPIC_API_KEY が存在する場合、ドキュメントによるとプロファイルはスキップされます。コマンドが間違ったワークスペースに送信されたときに、私が最初に確認するのはこの点です。

3つ目の誤った想定は、 --format raw と --raw-output は同じです。 --raw-output と jq -r を比較しています。 --format raw は生のレスポンスバイトを出力し、リストエンドポイントでは異なる挙動を示します。

デバッグとシェル補完

デバッグを行うには、 --debugを追加してください。ドキュメントによると、これは正確なHTTPリクエストとレスポンスをstderrに出力し、その際APIキーはマスクされます。エラー調査には、 --format-error と --transform-error を使用してエラーレスポンスをフィルタリングしてください。

ant --debug beta:agents list

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

またドキュメントには、bash、zsh、fish、PowerShell用の補完スクリプトが同梱されていると記載されています。コマンドツリーが広範であるため、これは重要です。補完機能により、ベータ版のリソース名、ネストされたリソース、エンドポイント固有のフラグにおけるミスを減らすことができます。

結論

型安全なアプリケーション統合、長期的なSDK抽象化、またはサービス内に組み込まれたランタイム動作が必要な場合は、使用を避けてください。このCLIは、開発者、ターミナル、プラットフォームリソース、そして構造化されたコマンド出力を読み取れるエージェントの境界において最も強力です。

FAQ

用語集

ant

Claude Platform APIリソースを操作するためのAnthropic製コマンドラインツール。

Messages API

モデルへのメッセージ送信とアシスタントからのレスポンス受信に使用されるClaude APIエンドポイント。

Managed Agent

モデル、システムプロンプト、ツール、ランタイムの動作が設定されたClaude PlatformのAgentリソース。

Workspace

APIリソースの認証情報がアクセスできる範囲を制御するClaude Consoleのスコープ。

Profile

認証情報、Workspace、および関連設定を切り替えるために使用される名前付きのCLI設定。

GJSON

以下で使用されるパス構文 --transform JSONレスポンスを抽出または整形するために使用されます。

JSONL

Newline-delimited JSON。リスト内の各項目を1行ずつストリーミングする場合に便利です。

Workload Identity Federation

CI、サーバー、コンテナ向けにドキュメントで推奨されている非対話型の認証パス。

すべての公式ソースとリンク

本投稿の公開制約に基づき、コミュニティサイト、Redditスレッド、Hacker Newsのコメント、非公式ブログ記事、サードパーティのチュートリアルは使用していません。