---
title: Die CLI verwenden
url: https://platform.claude.com/docs/de/cli-sdks-libraries/cli/using
description: Befehlsstruktur, Ausgabeformate, GJSON-Transformationen, Request-Bodies und Debugging für die ant CLI.
---

Diese Seite behandelt die Ein- und Ausgabemechanismen der `ant` CLI, die für jeden Endpunkt gelten. Zur Installation und Authentifizierung siehe den [Schnellstart](https://platform.claude.com/docs/de/cli-sdks-libraries/cli/quickstart). Um Befehle zu verketten und Ressourcen unter Versionskontrolle zu stellen, siehe [CLI-Scripting und Automatisierung](https://platform.claude.com/docs/de/cli-sdks-libraries/cli/scripting).

## Befehlsstruktur

Befehle folgen einem `resource action`-Muster. Verschachtelte Ressourcen verwenden Doppelpunkte:

```text wrap
ant <resource>[:<subresource>] <action> [flags]
```

Führe `ant --help` aus, um die vollständige Ressourcenliste zu erhalten, oder hänge `--help` an einen beliebigen Unterbefehl an, um dessen Flags anzuzeigen.

Ressourcen in der Beta-Phase (einschließlich Agents, Sessions, Deployments und Environments) befinden sich unter dem Präfix `beta:`. Befehle in diesem Namespace senden automatisch den passenden `anthropic-beta`-Header für diese Ressource, sodass du ihn nicht selbst übergeben musst. Verwende `--beta <header>` nur, um den Standardwert zu überschreiben (zum Beispiel, um eine andere Schema-Version zu wählen).

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

### Globale Flags

| Flag                                  | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--profile`                           | Benanntes Profil, das für diesen Aufruf verwendet werden soll (entspricht dem Setzen von `ANTHROPIC_PROFILE`). Siehe [Zwischen Workspaces wechseln](https://platform.claude.com/docs/de/cli-sdks-libraries/cli/authentication#switch-between-workspaces).                                                                                                                                                                                                                                                  |
| `--format`                            | Ausgabeformat: `auto`, `json`, `jsonl`, `yaml`, `pretty`, `raw`, `explore`                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `--transform`                         | Filtere oder forme die Antwort mit einem [GJSON-Pfad](https://platform.claude.com/docs/de/cli-sdks-libraries/cli/using#transform-output-with-gjson) um                                                                                                                                                                                                                                                                                                                                                     |
| `-r`, `--raw-output`                  | Gib String-Ergebnisse ohne umschließende Anführungszeichen aus, wie `jq -r`                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `--base-url`                          | Überschreibe die Basis-URL der API                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `--workspace-id`                      | Optional. Workspace-ID (`wrkspc_...`), die als `anthropic-workspace-id`-Header gesendet wird, für API-Keys mit Zugriff auf mehrere Workspaces (entspricht dem Setzen von `ANTHROPIC_WORKSPACE_ID`). Siehe [Einen Workspace auswählen](https://platform.claude.com/docs/de/manage-claude/authentication#select-a-workspace). [Admin API](https://platform.claude.com/docs/de/manage-claude/admin-api)-Befehle haben ihr eigenes `--workspace-id`, das stattdessen den Workspace benennt, den sie verwalten. |
| `--debug`                             | Gib den vollständigen HTTP-Request und die Response auf stderr aus                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `--format-error`, `--transform-error` | Wie `--format` und `--transform`, aber angewendet auf [Fehlerantworten](https://platform.claude.com/docs/de/cli-sdks-libraries/cli/scripting#inspect-errors)                                                                                                                                                                                                                                                                                                                                               |

## Ausgabeformate

`auto` gibt JSON formatiert (pretty-printed) aus und ist der Standard für Befehle, die Ressourcen erstellen oder ändern. List- und Retrieve-Befehle verwenden standardmäßig den [interaktiven Explorer](https://platform.claude.com/docs/de/cli-sdks-libraries/cli/using#interactive-explorer), wenn sie in ein Terminal schreiben, und formatiertes JSON, wenn die Ausgabe weitergeleitet (gepiped) wird. Überschreibe beide Standardwerte mit `--format`:

```bash
ant models retrieve --model-id claude-opus-5-5 --format yaml
```

```yaml Output
type: model
id: claude-opus-5-5
display_name: Claude Opus 5.5
created_at: "2026-09-22T00:00:00Z"
...
```

List-Endpunkte paginieren automatisch. In den Standardformaten wird jedes Element separat geschrieben (ein kompaktes JSON-Objekt pro Zeile im `jsonl`-Modus, ein Stream von YAML-Dokumenten im `yaml`-Modus), was sich sauber in `head`, `grep` und `--transform`-Filter streamen lässt.

### Interaktiver Explorer

Der Explorer ist eine TUI zum Auf- und Zuklappen sowie Durchsuchen großer Antworten. Pfeiltasten klappen Knoten auf und zu, `/` sucht, `q` beendet. List- und Retrieve-Befehle öffnen ihn standardmäßig, wenn sie mit einem Terminal verbunden sind. Übergib `--format explore`, um ihn explizit zu öffnen:

```bash
ant models list --format explore
```

## Ausgabe mit GJSON transformieren

Verwende `--transform`, um Antworten vor der Ausgabe umzuformen. Der Ausdruck ist ein [GJSON-Pfad](https://github.com/tidwall/gjson/blob/master/SYNTAX.md). Bei List-Endpunkten wird die Transformation auf jedes Element einzeln angewendet, nicht auf den Umschlag (Envelope):

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

```jsonl Output
{"id": "agent_011CYm1BLqPX...", "name": "Docs CLI Test Agent", "model": "claude-opus-5-5"}
{"id": "agent_011CYkVwfaEt...", "name": "Coffee Making Assistant", "model": "claude-opus-5-5"}
{"id": "agent_011CYixHhtUP...", "name": "Coding Assistant", "model": "claude-opus-5-5"}
```

### Einen Skalar extrahieren

Um ein einzelnes Feld als String ohne Anführungszeichen zu erfassen (zum Beispiel die ID einer neu erstellten Ressource), kombiniere `--transform` mit `--raw-output`. Das Ergebnis wird ohne JSON-Anführungszeichen ausgegeben und kann direkt einer Shell-Variablen zugewiesen werden:

```bash
AGENT_ID=$(ant beta:agents create \
  --name "My Agent" \
  --model '{id: claude-opus-5-5}' \
  --transform id --raw-output)

printf '%s\n' "$AGENT_ID"
```

```text Output wrap
agent_011CYm1BLqPXpQRk5khsSXrs
```

<Note>
  `--raw-output` unterscheidet sich von `--format raw`. `--raw-output` entfernt JSON-Anführungszeichen von String-Ergebnissen, wie `jq -r`. `--format raw` gibt die rohen JSON-Bytes des Response-Bodys ohne automatische Paginierung aus; bei List-Endpunkten wendet es `--transform` auf den Paginierungs-Umschlag statt auf jedes Element an.
</Note>

## Request-Bodies übergeben

Der richtige Eingabemechanismus hängt von der Form der Daten ab: Verwende **Flags** für skalare Felder und kurze strukturierte Werte, leite ein **stdin**-Dokument für verschachtelte oder mehrzeilige Bodies weiter und verwende **`@file`-Referenzen**, um Dateiinhalte in ein beliebiges String- oder Binärfeld zu übernehmen.

### Flags

Skalare Felder werden direkt auf Flags abgebildet. Strukturierte Felder akzeptieren eine lockere YAML-ähnliche Syntax (Schlüssel ohne Anführungszeichen, optionale Anführungszeichen um Strings) oder striktes JSON:

```bash
ant beta:sessions create \
  --agent '{type: agent, id: agent_011CYm1BLqPXpQRk5khsSXrs, version: 1}' \
  --environment-id env_01595EKxaaTTGwwY3kyXdtbs \
  --title "CLI docs test session"
```

Wiederholbare Flags bauen Arrays auf. Jedes `--tool` oder `--event` hängt ein Element an:

```bash
ant beta:agents create \
  --name "Research Agent" \
  --model '{id: claude-opus-5-5}' \
  --tool '{type: agent_toolset_20260401}' \
  --tool '{type: custom, name: search_docs, input_schema: {type: object, properties: {query: {type: string}}}}'
```

### Stdin

Leite ein JSON- oder YAML-Dokument an stdin weiter, um den vollständigen Request-Body bereitzustellen. Felder aus stdin werden mit Flags zusammengeführt, wobei Flags Vorrang haben. Hier ist `version` das Optimistic-Locking-Token, das von einem früheren `retrieve` zurückgegeben wurde, und `$AGENT_ID` wurde wie in [Einen Skalar extrahieren](https://platform.claude.com/docs/de/cli-sdks-libraries/cli/using#extract-a-scalar) erfasst:

```bash
echo '{"description": "Updated test agent.", "version": 1}' | \
  ant beta:agents update --agent-id "$AGENT_ID"
```

Heredocs funktionieren genauso und sind praktisch für mehrzeiliges YAML. Setze den Begrenzer in Anführungszeichen (wie in `<<'YAML'`), um die Variablenexpansion innerhalb des Bodys zu deaktivieren.

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

### Dateireferenzen

Flags, die einen Dateipfad entgegennehmen, wie `--file` beim Upload-Befehl, akzeptieren einen einfachen Pfad:

```bash
ant files upload --file ./report.pdf
```

Um den Inhalt einer Datei in ein Feld mit String-Wert einzubetten, stelle dem Pfad ein `@` voran:

```bash
ant beta:agents create \
  --name "Researcher" --model '{id: claude-opus-5-5}' \
  --system @./prompts/researcher.txt
```

Innerhalb strukturierter Flag-Werte setze den Pfad in Anführungszeichen. Um ein PDF an die Messages API zu senden:

```bash
ant messages create \
  --model claude-opus-5-5 \
  --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.#(type=="text").text' --raw-output
```

Die CLI erkennt den Dateityp und kodiert Binärdateien automatisch als base64. Um eine bestimmte Kodierung zu erzwingen, verwende `@file://` für Klartext oder `@data://` für base64. Maskiere ein wörtliches führendes `@` mit einem Backslash (`\@username`).

## Debugging

Füge `--debug` zu einem beliebigen Befehl hinzu, um den exakten HTTP-Request und die Response (Header und Body) auf stderr auszugeben. API-Keys werden unkenntlich gemacht.

```bash
ant --debug beta:agents list
```

```text Output wrap
GET /v1/agents?beta=true HTTP/1.1
Host: api.anthropic.com
Anthropic-Beta: managed-agents-2026-04-01
Anthropic-Version: 2023-06-01
X-Api-Key: <REDACTED>
...
```

## Verfügbare Ressourcen

Jede API-Ressource, die die CLI bereitstellt, ist in der [API-Referenz](https://platform.claude.com/docs/de/api/cli/messages/create) dokumentiert. Für eine lokale Auflistung führe `ant --help` aus und hänge `--help` an einen beliebigen Unterbefehl an, um dessen Flags und Parameter anzuzeigen.

## Nächste Schritte

<CardGroup cols={3}>
  <Card title="CLI-Scripting und Automatisierung" icon="code" href="https://platform.claude.com/docs/de/cli-sdks-libraries/cli/scripting">
    API-Ressourcen unter Versionskontrolle stellen, Scripting-Muster und Nutzung aus Claude Code
  </Card>

  <Card title="API-Referenz" icon="book" href="https://platform.claude.com/docs/de/api/cli/messages/create">
    Endpunktspezifische Parameter, Request-Felder und Response-Schemas
  </Card>

  <Card title="CLI-Authentifizierungsoptionen" icon="lock" href="https://platform.claude.com/docs/de/cli-sdks-libraries/cli/authentication">
    API-Keys, Headless-Hosts, mehrere Workspaces und benannte Profile
  </Card>
</CardGroup>