Claude Platform ant CLI: Offizielles Entwicklerhandbuch

Was wurde veröffentlicht

Die Kurzfassung: Die Claude Platform verfügt jetzt über eine offizielle API CLI namens ant.

Der Launch-Tweet ist nützlich, da er den Zweck des Produkts beschreibt: API-Aufrufe,

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

Definition in einem Satz

Die ant CLI is Anthropic's command-line interface for calling Claude API resources from a terminal.Sie ist kein Ersatz für die Python- oder TypeScript-SDKs. Sie ist eine Shell-native Oberfläche

Mentales Modell: Vier Teile

Lesen ant als kleiner Adapter zwischen Shell-Workflows und der Claude Platform.

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

• Anmeldedaten: OAuth-Login, API key, Federation oder benanntes Profil.
• Befehle: ein resource action Muster, bei dem verschachtelte Ressourcen durch Doppelpunkte getrennt sind.
• Eingabe: Flags, stdin YAML/JSON und @file Referenzen für Inline-Dateiinhalte.
• Ausgabe: formatiertes JSON, YAML, JSONL, Rohausgabe, interaktiver Explorer und GJSON-Transforms.

Installation und Überprüfung

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

Die Dokumentation besagt zudem, dass jede bereitgestellte API-Ressource in der lokalen Hilfe-Ausgabe erscheint. ant --helpaus und hängen Sie dann --help an die Ressource an, ant messages create --help.

Authentifizierung: OAuth, API Keys und Profile

Die offizielle Dokumentation unterteilt die Authentifizierung in lokale Entwicklung und nicht-interaktive ant auth login öffnet einen browserbasierten OAuth-Flow gegen die Claude Console. Für Remote-Hosts ohne lokalen Browser gibt das --no-browser Flag eine Autorisierungs-URL aus und fordert Sie auf, den zurückgegebenen Code einzufügen.

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

Das wichtige Detail zum Workspace: Während des OAuth-Logins wählen Sie eine Organisation und einen Workspace aus. Das Token ist auf diesen Workspace beschränkt. Um in mehreren Workspaces zu arbeiten, erstellen Sie ein Profil pro Workspace und wechseln explizit zwischen den Profilen.

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

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

Für CI, Container und Server rät die CLI-Dokumentation vom interaktiven Login ab und empfiehlt stattdessen Workload Identity Federation. Das hält die Post-Install-Regel sauber: OAuth für Ihre lokale Maschine, Federation für die Automatisierung und API keys, wenn Sie gezielt eine schlüsselbasierte Authentifizierung wünschen.

Kleinste End-to-End-Anfrage

Sobald ant installiert und authentifiziert ist, beginnt die Dokumentation mit der Messages API. Dies ist die minimale Struktur: Modell, max tokens und eine Benutzernachricht.

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

Die Dokumentation zeigt die Antwort als vollständiges API-Objekt: Modell-ID, Nachrichten-ID, Assistant-Rolle, Content-Array, Stop-Grund und Usage. Die CLI gibt dieses Objekt formatiert aus, wenn stdout ein Terminal ist.

Befehlsstruktur

Befehle folgen einer resource action Struktur. Verschachtelte Ressourcen verwenden Doppelpunkte, und Beta-Ressourcen befinden sich unter beta:. Die Dokumentation führt Agents, Sessions, Deployments, Environments und Skills als Beta-Ressourcen auf.

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...

Das Beta-Präfix ist wichtig, da diese Befehle automatisch den entsprechenden anthropic-beta Header für die jeweilige Ressource senden. Die Dokumentation empfiehlt, --betanur dann zu verwenden, wenn Sie die Standard-Schemaversion überschreiben müssen.

Ausgabeformate und GJSON-Transformationen

Die Ausgabe ist der Punkt, an dem ant wird zu mehr als nur einem praktischen Wrapper um curl. auto, json, jsonl, yaml, pretty, raw, und explore. Listen-Endpunkte paginieren automatisch, und die Listenausgabe kann sauber in Shell-Befehle gestreamt werden.

Die Transformationssprache ist GJSON. Bei Listen-Endpunkten wird die Transformation auf jedes Element angewendet, nicht auf das gesamte Envelope. Deshalb kann dieses Muster eine Agent-Zusammenfassung pro Zeile ausgeben:

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

Meine praktische Einschätzung: Verwenden Sie --format jsonl wenn der nächste Befehl ein Shell-Tool ist, --transform id --raw-output wenn Sie eine Ressourcen-ID für den nächsten benötigen ant Aufruf.

Request-Bodies ohne manuell geschriebenes JSON übergeben

Die CLI-Dokumentation beschreibt drei Eingabemodi: Flags, stdin und Dateireferenzen. Skalare Felder werden auf Flags abgebildet. Strukturierte Felder akzeptieren eine lockere YAML-ähnliche Syntax oder striktes JSON. Vollständige Request-Bodies können als JSON oder YAML über stdin gepiped werden.

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

Für Dateiinhalte verwendet die Dokumentation @path. Damit können Sie eine Prompt-Datei in ein String-Feld einbetten oder ein PDF an die Messages API senden, wobei die CLI Binärdateien automatisch erkennt und per base64 kodiert.

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-Ressourcen versionskontrollieren

Das wichtigste Detail des Launches für Plattform-Teams ist nicht der einzeilige Messages-Aufruf. Es ist der Dokumentationsabschnitt darüber, wie API-Ressourcen in YAML-Dateien verwaltet werden. Das Beispiel umfasst einen Managed Agent, eine Umgebung, eine Session, ein User-Event und eine Auflistung von Session-Events.

# 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"

Dieses Muster macht Plattform-Ressourcen zu Dateien, die Sie überprüfen, in einem Repo speichern und per CI aktualisieren können. Die CLI ersetzt zwar nicht die Notwendigkeit für Governance, macht aber das operative Objektmodell für Shell-Skripte sichtbar.

Verwenden von ant aus Claude Code

Der Launch-Tweet besagt ant wird von Coding-Agents gut verstanden, und die CLI-Dokumentation macht das Verhalten von Claude Code explizit: mit ant installiert und authentifiziert, kann Claude Code Befehle an diese weiterleiten, strukturierte Ausgaben parsen und über die Ergebnisse nachdenken.

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."

Die praktische Konsequenz: Claude Code benötigt kein maßgeschneidertes Skript mehr, um viele Claude Platform-Ressourcen zu verstehen. Installieren Sie ant, authentifizieren Sie es für den richtigen Workspace, und Claude Code erhält eine strukturierte Befehlsoberfläche, die es nutzen kann.

Was ich beim Lesen des Launches falsch verstanden habe

Meine erste falsche Annahme war, dass ant nur ein schönerer Wrapper für die Messages API sei. Die Dokumentation macht das breitere Ziel deutlich: API-Ressourcenoperationen, Beta Managed Agents, Umgebungen, Sessions, Dateien, Profile, Transforms und die Übergabe an Claude Code.

Die zweite falsche Annahme war, dass der Profilwechsel immer Vorrang hat. Das stimmt nicht. Wenn ANTHROPIC_API_KEY vorhanden ist, werden laut Dokumentation Profile übersprungen. Das ist das Erste, was ich überprüfen würde, wenn ein Befehl den falschen Workspace trifft.

Die dritte falsche Annahme war, dass --format raw und --raw-output sind identisch. --raw-output mit jq -r für Strings. --format raw gibt die rohen Antwort-Bytes aus und verhält sich bei Listen-Endpunkten anders.

Debugging und Shell-Vervollständigung

Für das Debugging fügen Sie --debughinzu. Die Dokumentation besagt, dass es die exakte HTTP-Anfrage und -Antwort nach stderr ausgibt, wobei API-Schlüssel unkenntlich gemacht werden. Zur Fehleranalyse verwenden Sie --format-error und --transform-error um Fehlerantworten zu filtern.

ant --debug beta:agents list

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

Die Dokumentation erwähnt außerdem, dass Vervollständigungsskripte für bash, zsh, fish und PowerShell mitgeliefert werden. Das ist wichtig, da der Befehlsbaum sehr umfangreich ist. Die Vervollständigung reduziert Fehler bei Beta-Ressourcennamen, verschachtelten Ressourcen und endpunktspezifischen Flags.

Das Fazit

Verzichten Sie darauf, wenn Sie typisierte Anwendungsintegration, langlebige SDK-Abstraktionen oder Laufzeitverhalten benötigen, das in einen Dienst eingebettet ist. Das CLI ist am stärksten an der Schnittstelle zwischen einem Entwickler, einem Terminal, Plattform-Ressourcen und einem Agenten, der strukturierte Befehlsausgaben lesen kann.

FAQ

Glossar

ant

Das Kommandozeilen-Tool von Anthropic für Claude Platform API-Ressourcen.

Messages API

Der Claude API-Endpunkt, der zum Senden von Modellnachrichten und zum Empfangen von Assistenten-Antworten verwendet wird.

Managed Agent

Eine Claude Platform Agenten-Ressource, die mit Modell, System-Prompt, Tools und Laufzeitverhalten konfiguriert ist.

Workspace

Ein Bereich in der Claude Console, der steuert, auf welche API-Ressourcen Anmeldedaten zugreifen können.

Profile

Eine benannte CLI-Konfiguration, die zum Wechseln von Anmeldedaten, Workspace und zugehörigen Einstellungen verwendet wird.

GJSON

Eine Pfadsyntax, die von --transform verwendet wird, um JSON-Antworten zu extrahieren oder umzustrukturieren.

JSONL

Newline-delimited JSON, nützlich, wenn jedes aufgelistete Element als eine Zeile gestreamt werden soll.

Workload Identity Federation

Ein nicht-interaktiver Authentifizierungspfad, der laut Dokumentation für CI, Server und Container empfohlen wird.

Alle offiziellen Quellen und Links

Gemäß den Veröffentlichungsvorgaben für diesen Beitrag wurden keine Community-Seiten, Reddit-Threads, Hacker News-Kommentare, inoffiziellen Blog-Posts oder Tutorials von Drittanbietern verwendet.