CLI, SDKs und Bibliothekenant CLI

CLI-Scripting und Automatisierung

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

Diese Seite behandelt aufgabenorientierte Workflows, die auf der ant-CLI aufbauen. Für die zugrunde liegenden Flags und Ausgabeoptionen siehe Verwendung der CLI.

Versionskontrolle von API-Ressourcen

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

Weitere Informationen zu diesen Ressourcen findest du unter Managed Agents.

Definiere deinen Agent

Schreibe die Agent-Definition in summarizer.agent.yaml:

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

Erstelle den Agent
ant beta:agents create < summarizer.agent.yaml
Output
{ "id": "agent_011CYm1BLqPXpQRk5khsSXrs", "version": 1, "name": "Summarizer", "model": "claude-sonnet-4-6" /* ... */ }
Notiere dir die id aus der Antwort. Du übergibst sie in einem späteren Schritt an den Befehl zum Erstellen der Session.
Checke summarizer.agent.yaml in dein Repository ein und halte es in deiner CI-Pipeline mit der API synchron. Der Update-Befehl benötigt die Agent-ID und die aktuelle Version als Flags:
CLI
ant beta:agents update --agent-id agent_011CYm1BLqPXpQRk5khsSXrs --version 1 < summarizer.agent.yaml
Definiere das Environment
Eine Session läuft in einem Environment (Umgebung), das die Sandbox definiert, in der sie ausgeführt wird. Schreibe die Environment-Definition in summarizer.environment.yaml:
summarizer.environment.yaml
name: summarizer-env config: type: cloud networking: type: unrestricted
Erstelle das Environment
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.
Checke summarizer.environment.yaml in dein Repository ein und halte es in deiner CI-Pipeline mit der API synchron. Der Update-Befehl benötigt die Environment-ID als Flag:
CLI
ant beta:environments update --environment-id env_01595EKxaaTTGwwY3kyXdtbs < summarizer.environment.yaml

Starte eine Session

Füge die Agent-id und die Environment-id 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"
  /* ... */
}

Sende eine Benutzernachricht

Kopiere die Session-id 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."}]}'

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 standardmäßig in einem Terminal ö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.
```
Um eine Session während der Ausführung zu beobachten, verwende ant beta:sessions:events stream --session-id session_01JZCh78XvmxJjiXVy3oSi7K. Events werden nach stdout geschrieben, sobald sie eintreffen.

Scripting-Muster

Die CLI ist so konzipiert, dass sie sich mit Standard-Shell-Tools 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 Standard-Tools 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 direkt 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 Agent-Sessions auf und fasse zusammen, welche davon Fehler hatten."
„Lade jede PDF in ./reports in die Files API hoch und gib die resultierenden IDs aus."
„Rufe die Events für 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 analysiert die Ergebnisse (kein benutzerdefinierter Integrationscode erforderlich).

Was this page helpful?

CLI, SDKs und Bibliothekenant CLI

CLI-Scripting und Automatisierung

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

Diese Seite behandelt aufgabenorientierte Workflows, die auf der ant-CLI aufbauen. Für die zugrunde liegenden Flags und Ausgabeoptionen siehe Verwendung der CLI.

Versionskontrolle von API-Ressourcen

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

Weitere Informationen zu diesen Ressourcen findest du unter Managed Agents.

Definiere deinen Agent

Schreibe die Agent-Definition in summarizer.agent.yaml:

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

Erstelle den Agent
ant beta:agents create < summarizer.agent.yaml
Output
{ "id": "agent_011CYm1BLqPXpQRk5khsSXrs", "version": 1, "name": "Summarizer", "model": "claude-sonnet-4-6" /* ... */ }
Notiere dir die id aus der Antwort. Du übergibst sie in einem späteren Schritt an den Befehl zum Erstellen der Session.
Checke summarizer.agent.yaml in dein Repository ein und halte es in deiner CI-Pipeline mit der API synchron. Der Update-Befehl benötigt die Agent-ID und die aktuelle Version als Flags:
CLI
ant beta:agents update --agent-id agent_011CYm1BLqPXpQRk5khsSXrs --version 1 < summarizer.agent.yaml
Definiere das Environment
Eine Session läuft in einem Environment (Umgebung), das die Sandbox definiert, in der sie ausgeführt wird. Schreibe die Environment-Definition in summarizer.environment.yaml:
summarizer.environment.yaml
name: summarizer-env config: type: cloud networking: type: unrestricted
Erstelle das Environment
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.
Checke summarizer.environment.yaml in dein Repository ein und halte es in deiner CI-Pipeline mit der API synchron. Der Update-Befehl benötigt die Environment-ID als Flag:
CLI
ant beta:environments update --environment-id env_01595EKxaaTTGwwY3kyXdtbs < summarizer.environment.yaml

Starte eine Session

Füge die Agent-id und die Environment-id 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"
  /* ... */
}

Sende eine Benutzernachricht

Kopiere die Session-id 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."}]}'

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 standardmäßig in einem Terminal ö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.
```
Um eine Session während der Ausführung zu beobachten, verwende ant beta:sessions:events stream --session-id session_01JZCh78XvmxJjiXVy3oSi7K. Events werden nach stdout geschrieben, sobald sie eintreffen.

Scripting-Muster

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

List-Ausgabe in einen zweiten Befehl verketten

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

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 direkt 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 Agent-Sessions auf und fasse zusammen, welche davon Fehler hatten."
„Lade jede PDF in ./reports in die Files API hoch und gib die resultierenden IDs aus."
„Rufe die Events für 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 analysiert die Ergebnisse (kein benutzerdefinierter Integrationscode erforderlich).

Was this page helpful?