Claude Platform Docs

CLI-Scripting und Automatisierung

Versioniere API-Ressourcen als YAML, verkette ant-CLI-Befehle in Skripten, arbeite mit Ressourcen aus Claude Code heraus und authentifiziere curl-Aufrufe mit CLI-Anmeldedaten.

Diese Seite behandelt aufgabenorientierte Workflows, die auf der ant-CLI aufbauen. Die zugrunde liegenden Flags und Ausgabeoptionen findest du unter Die CLI verwenden.

API-Ressourcen versionieren

Du kannst die CLI verwenden, um API-Ressourcen wie Skills, Agenten, Umgebungen oder Deployments als YAML-Dateien in deinem Repository zu versionieren und sie mit der Claude API synchron zu halten.

  1. Definiere deinen Agenten

    Schreibe die Agentendefinition in summarizer.agent.yaml:

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

  2. Erstelle den Agenten

    ant beta:agents create < summarizer.agent.yaml
    Output
    {
  "id": "agent_011CYm1BLqPXpQRk5khsSXrs",
  "version": 1,
  "name": "Summarizer",
  "model": "claude-opus-5"
  /* ... */
}

    Notiere dir die id aus der Antwort. Du übergibst sie in einem späteren Schritt an den Befehl zum Erstellen der Session.

  3. Definiere die Umgebung

    Eine Session läuft in einer Umgebung (environment), die die Sandbox definiert, in der sie ausgeführt wird. Schreibe die Umgebungsdefinition in summarizer.environment.yaml:

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

  4. Erstelle die Umgebung

    ant beta:environments create < summarizer.environment.yaml
    Output
    {
  "id": "env_01595EKxaaTTGwwY3kyXdtbs",
  "name": "summarizer-env"
  /* ... */
}

    Notiere dir die id aus der Antwort. Du übergibst sie in einem späteren Schritt an den Befehl zum Erstellen der Session.

  5. Starte eine Session

    Füge die id des Agenten und die id der Umgebung aus den vorherigen Ausgaben in den Befehl zum Erstellen der Session ein:

    ant beta:sessions create \
  --agent agent_011CYm1BLqPXpQRk5khsSXrs \
  --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
  --title "Summarization task"
    Output
    {
  "id": "session_01JZCh78XvmxJjiXVy3oSi7K",
  "status": "running"
  /* ... */
}

  6. Sende eine Benutzernachricht

    Kopiere die id der Session aus der vorherigen Ausgabe in --session-id:

    ant beta:sessions:events send \
  --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
  --event '{type: user.message, content: [{type: text, text: "Summarize the benefits of type safety in one sentence."}]}'

  7. Lies die Konversation

    --transform wird auf jedes aufgelistete Event angewendet, sodass dies den Text jeder Nachricht der Reihe nach ausgibt. --format auto überschreibt den interaktiven Explorer, den List-Befehle in einem Terminal standardmäßig öffnen:

    ant beta:sessions:events list \
  --session-id session_01JZCh78XvmxJjiXVy3oSi7K \
  --transform 'content.0.text' --format auto --raw-output
    Output
    Summarize the benefits of type safety in one sentence.
Type safety catches errors at compile time rather than runtime, reducing bugs, improving code clarity, enabling better tooling support, and making codebases easier to maintain and refactor with confidence.

Scripting-Muster

Die CLI ist so konzipiert, dass sie sich mit Standard-Shell-Werkzeugen kombinieren lässt.

List-Ausgabe in einen zweiten Befehl verketten

--transform id --raw-output auf einem List-Endpunkt gibt eine reine ID pro Zeile aus, sodass Standardwerkzeuge wie head und xargs direkt anwendbar sind. Erfasse das erste Ergebnis und übergib es dann an einen Folgebefehl:

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

Fehler untersuchen

Die Flags --transform-error und --format-error wenden dieselbe Filterung auf Fehlerantworten an. --raw-output gilt nicht für Fehler, verwende daher --format-error yaml für einen Skalar ohne Anführungszeichen. Extrahiere nur die Fehlermeldung:

ant beta:agents retrieve --agent-id bogus \
  --transform-error error.message --format-error yaml 2>&1
Output
GET "https://api.anthropic.com/v1/agents/bogus?beta=true": 404 Not Found
Agent not found.

Die CLI aus Claude Code heraus verwenden

Claude Code kann die ant-CLI ohne weitere Konfiguration verwenden. Wenn die CLI installiert und authentifiziert ist, kannst du Claude Code bitten, direkt mit deinen API-Ressourcen zu arbeiten. Zum Beispiel:

  • „Liste meine letzten Agenten-Sessions auf und fasse zusammen, welche davon Fehler hatten.“
  • „Lade jede PDF-Datei in ./reports in die Files API hoch und gib die resultierenden IDs aus."
  • „Rufe die Events für die Session session_01... ab und sag mir, wo der Agent stecken geblieben ist."

Claude Code ruft ant über die Shell auf, parst die strukturierte Ausgabe und zieht Schlüsse aus den Ergebnissen (kein eigener Integrationscode erforderlich).

curl-Anfragen mit CLI-Anmeldedaten authentifizieren

Skripte, die die API mit curl oder einem anderen HTTP-Client aufrufen, können die von ant auth login gespeicherten Anmeldedaten anstelle eines statischen API-Keys verwenden. Das OAuth-Access-Token gehört als Bearer-Token in den Authorization-Header; der x-api-key-Header ist nur für statische API-Keys vorgesehen.

ant auth print-credentials --access-token gibt das Access-Token des aktiven Profils aus und erneuert es zuvor, falls es abgelaufen ist oder kurz vor dem Ablauf steht:

cURL
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"}]
  }'

Führe ant auth status aus, um zu überprüfen, bei welcher Organisation und welchem Workspace du angemeldet bist; der Befehl warnt dich, wenn eine Umgebungsvariable deinen Login überschreibt.

Was this page helpful?