---
title: "CLI-Befehle"
description: "Übersicht aller AI Glot CLI-Befehle für Konten, Nutzung, bestehende Übersetzungen, Glossare, Sprachsuche, direkten API-Zugriff und MCP-Bridging."
canonical: "https://ai-glot.com/docs/de/cli/commands"
updated: "2026-08-12"
---

# CLI-Befehle

Führen Sie `aiglot help --json` aus, um eine maschinenlesbare Beschreibung zu erhalten, die aus dem installierten Befehlsbaum generiert wird.

## Konto und Nutzung

```bash
aiglot account
aiglot credits
aiglot usage --from 2026-07-01 --to 2026-07-31 --granularity day
aiglot languages
```

Ohne Datumsangaben gibt `usage` die letzten 30 Tage zurück. Datumsangaben werden im Format `YYYY-MM-DD` oder als vollständige ISO-Zeitstempel akzeptiert.

`languages` ist der einzige Befehl, der ohne jegliche Anmeldedaten funktioniert. So kann ein Agent einen Sprach-Tag gegen den Katalog validieren, bevor die Authentifizierung erfolgt oder ein Glossar erstellt wird.

## Bestehende Übersetzungen

```bash
aiglot batches list --status completed --limit 50
aiglot batches list --archived --search "produktkatalog"
aiglot batches list --quality-tier lite --created-after 2026-07-01 --created-before 2026-07-31
aiglot batches list --status completed --all
aiglot batches get <id>
aiglot batches rename <id> "Französischer Produktkatalog"
aiglot batches archive <id>
aiglot batches archive <id> --undo
aiglot batches download <id> --output ./translated.csv
```

Archivierte Übersetzungen werden ausgeschlossen, sofern `--archived` nicht angegeben ist. `--search` durchsucht den Namen der Übersetzung oder den Namen der hochgeladenen Datei. `--quality-tier` akzeptiert nur `standard` oder `lite`. `--created-after` und `--created-before` akzeptieren `YYYY-MM-DD` oder einen vollständigen ISO-Zeitstempel.

Verwenden Sie `--cursor` mit dem `next_cursor` aus der vorherigen Listen-Antwort oder `--all`, um dem Cursor bis zum Ende zu folgen – siehe [Pagination](/docs/cli/automation#pagination). `download --output -` schreibt die CSV-Datei in den Standard-Output.

> **Info: In der Web-App erstellt**
>
> Diese Befehle steuern Übersetzungen, die bereits über die Web-App erstellt wurden. Die CLI kann in Version 1 noch keine Übersetzungen hochladen oder starten.

## Glossare

Sprachpaare verwenden kombinierte unterstützte Tags, wie zum Beispiel `en-US-fr`.

```bash
aiglot glossaries list --limit 25 --cursor <cursor>
aiglot glossaries list --expand-terms
aiglot glossaries list --all
aiglot glossaries get en-US-fr
aiglot glossaries create en-US-fr --from terms.csv
aiglot glossaries add en-US-fr --term "checkout=commande"
aiglot glossaries add en-US-fr --from additions.json
aiglot glossaries remove en-US-fr --term checkout
aiglot glossaries replace en-US-fr --from complete.csv --dry-run
aiglot glossaries replace en-US-fr --from complete.csv
aiglot glossaries delete en-US-fr
```

Die Eingabe kann eine zwei-spaltige CSV-Datei oder eine JSON-Term-Map sein. `add` und `remove` arbeiten präzise auf Einzeltermen. `replace` löscht jeden Term, der nicht in der Datei enthalten ist; `delete` entfernt das gesamte Glossar. Destruktive Befehle fordern in einem interaktiven Terminal eine Bestätigung an und erfordern bei nicht-interaktiver Nutzung `--force`.

`--expand-terms` schließt die Terme jedes Glossars in die Auflistung ein und begrenzt die Seite auf maximal 10 Einträge.

> **Warning: Vorschau vor dem Ersetzen**
>
> `glossaries replace --dry-run` liest das Glossar aus, vergleicht es lokal mit Ihrer Datei und gibt die Änderungen aus, ohne Daten zu senden. Unter `removed_terms` werden genau die Begriffe aufgeführt, die gelöscht würden, weil sie in Ihrer Datei fehlen. Dies ist das einzige Sicherheitsnetz für den Befehl, der Terme löscht, die vom Aufrufer nicht explizit benannt wurden. Führen Sie diesen Befehl daher immer zuerst aus und brechen Sie ab, falls die Liste länger ist als erwartet.

## Authentifizierung

```bash
aiglot auth login
aiglot auth login --device
aiglot auth login --key "$AIGLOT_API_KEY"
aiglot auth status
aiglot auth logout
```

`logout` löscht die gespeicherten Anmeldedaten und widerruft diese serverseitig, sofern der Typ der Anmeldedaten einen Widerruf unterstützt.

## Notausgänge und Utilities

```bash
aiglot api GET /v1/account
aiglot api PATCH /v1/batches/<id> --data '{"archived":true}'
aiglot api PUT /v1/glossaries/en-fr --data @terms.json
echo '{"upsert":{"cart":"panier"}}' | aiglot api PATCH /v1/glossaries/en-fr --data -
aiglot api GET /v1/account --header "X-Request-Source: ci"
aiglot mcp
aiglot doctor
aiglot completion zsh
```

`aiglot api` sendet eine rohe, authentifizierte Anfrage, sodass neue REST-Endpunkte genutzt werden können, bevor ein dedizierter CLI-Befehl existiert. `--data` akzeptiert Inline-JSON, `@datei` oder `-` zum Lesen vom Standard-Input. `--header "Name: Wert"` kann mehrfach angegeben werden, darf jedoch nicht für `Authorization` verwendet werden, da die CLI die Anmeldedaten selbst bereitstellt. `aiglot mcp` verbindet lokale, rein auf stdio basierende MCP-Clients mit dem Remote-HTTP-Server von AI Glot.
