> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AIHubMix CLI (Kommandozeilen-Tool)

> AIHubMix CLI ist das offizielle Kommandozeilen-Tool von AIHubMix – einzelne Binärdatei, keine Abhängigkeiten. Direkt im Terminal: Kontoguthaben abfragen, API-Keys verwalten, verfügbare Modelle anzeigen – skript- und AI-Agent-freundlich.

**AIHubMix CLI** ist das offizielle Kommandozeilen-Tool von AIHubMix (ausführbare Datei `aihubmix`). Nach der Installation können Sie ohne Öffnen der Web-Konsole direkt im Terminal das Kontoguthaben abfragen, API-Keys verwalten und verfügbare Modelle anzeigen. Es ist eine einzelne Binärdatei – **ohne Installation von Python, Node oder Go** mit einem einzigen Befehl einsatzbereit; alle Befehle unterstützen JSON-Ausgabe und lassen sich direkt in Skripte, CI und AI Agents (wie Claude Code) integrieren.

**Was es kann:**

* **Guthaben abfragen**: Kontoguthaben und verbrauchtes Kontingent in Echtzeit abfragen
* **Keys verwalten**: API-Keys erstellen, anzeigen, suchen, ändern, löschen
* **Modelle anzeigen**: Die für das aktuelle Token verfügbaren Modelle auflisten
* **Skriptfähig**: JSON-Ausgabe + stabile Exit-Codes, von Natur aus geeignet für Automatisierung und AI Agents

<Info>
  **Verwechseln Sie die beiden Anmeldedaten nicht**: Die CLI meldet sich mit dem „System-Zugriffstoken“ (Manage Key, Format `fd***`) an. Diesen erhalten Sie in der Konsole unter [console.aihubmix.com/setting](https://console.aihubmix.com/setting) per Klick auf „System-Zugriffstoken generieren“. Er dient der **Kontoverwaltung** und ist nicht derselbe wie der API-Key (`sk-***`), den Sie für Modellaufrufe verwenden.
</Info>

<Tip>
  Suchen Sie das alte Python-Skript (`aihubmix_cli.py`)? Siehe [Kontoinformationen per API abrufen](/de/api/Cli). Diese Seite beschreibt dessen Nachfolger der nächsten Generation – einfacher und schneller.
</Tip>

## Installation

### Schnellinstallation (empfohlen)

Kopieren Sie den Befehl für Ihr System, fügen Sie ihn im Terminal ein und führen Sie ihn aus. Damit wird die Binärdatei heruntergeladen und automatisch zum `PATH` hinzugefügt:

<CodeGroup>
  ```bash macOS / Linux theme={null}
  curl -fsSL https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.sh | sh
  ```

  ```powershell Windows PowerShell theme={null}
  irm https://raw.githubusercontent.com/AIhubmix/platfrom-cli/main/install.ps1 | iex
  ```
</CodeGroup>

Nach der Installation **öffnen Sie ein neues Terminal** und führen `aihubmix login` aus, um loszulegen.

<Info>
  Sie können die passende Binärdatei für Ihre Plattform auch manuell von [Releases](https://github.com/AIhubmix/platfrom-cli/releases) herunterladen (für Windows `aihubmix_windows_amd64.exe`) und in ein `PATH`-Verzeichnis legen; unter Unix-ähnlichen Systemen ist `chmod +x` erforderlich.
</Info>

Bei Bedarf können Sie das Installationsverhalten über Umgebungsvariablen anpassen:

| Variable           | Beschreibung                                    | Standard                                                                           |
| ------------------ | ----------------------------------------------- | ---------------------------------------------------------------------------------- |
| `AIHUBMIX_VERSION` | Bestimmte Version installieren (z. B. `v0.2.0`) | `latest`                                                                           |
| `AIHUBMIX_BIN_DIR` | Benutzerdefiniertes Installationsverzeichnis    | Unix: `/usr/local/bin` oder `~/.local/bin`; Windows: `%LOCALAPPDATA%\aihubmix\bin` |

## Schnellstart

Nach der Anmeldung stehen Ihnen alle Befehle zur Verfügung:

```bash theme={null}
# 1. Anmelden: öffnet automatisch den Browser zur Token-Generierungsseite, Manage Key einfügen (Eingabe wird nicht angezeigt)
aihubmix login

# 2. Aktuelle Identität und Kontostand anzeigen
aihubmix whoami

# 3. Vollständige Kontoinformationen anzeigen
aihubmix me

# 4. Ihre API-Keys auflisten
aihubmix keys list
```

## Befehlsübersicht

| Befehl                                  | Funktion                                                |
| --------------------------------------- | ------------------------------------------------------- |
| `aihubmix login`                        | Anmelden (Manage Key einfügen)                          |
| `aihubmix logout`                       | Abmelden, lokale Anmeldedaten löschen                   |
| `aihubmix whoami`                       | Aktuelle Anmeldeidentität und Kontostand anzeigen       |
| `aihubmix me`                           | Vollständige Kontoinformationen und Kontostand anzeigen |
| `aihubmix models list`                  | Aktuell verfügbare Modelle anzeigen                     |
| `aihubmix keys list [--num N]`          | API-Keys auflisten                                      |
| `aihubmix keys search <Schlüsselwort>`  | Keys per Schlüsselwort suchen                           |
| `aihubmix keys get <id>`                | Details eines bestimmten Keys anzeigen                  |
| `aihubmix keys create [Parameter]`      | Neuen Key erstellen                                     |
| `aihubmix keys update <id> [Parameter]` | Key ändern                                              |
| `aihubmix keys delete <id>`             | Key löschen                                             |

<Tip>
  Fügen Sie einem beliebigen Befehl `--help` hinzu, um alle Parameter anzuzeigen, z. B. `aihubmix keys create --help`.
</Tip>

## Häufige Operationen

### API-Keys verwalten

```bash theme={null}
# Einen Key mit $10 Limit erstellen, beschränkt auf bestimmte Modelle
aihubmix keys create -n prod-key -q 10 -m "gpt-4o,claude-3.5-sonnet"

# Einen Key ohne Limit und ohne Ablaufdatum erstellen
aihubmix keys create -n ci-key -u

# Key umbenennen (alle anderen Einstellungen bleiben unverändert)
aihubmix keys update 123 -n new-name

# Einen Key deaktivieren
aihubmix keys update 123 --status 0

# Key löschen
aihubmix keys delete 123
```

Dabei bedeutet `-q 10`, dass der Key auf \$10 limitiert ist, und `-u` bedeutet kein Limit. Beim Löschen wird standardmäßig eine Bestätigung verlangt; im CI-Szenario kann diese mit `--yes` übersprungen werden.

### Verwendung in Skripten / AI Agents

Die CLI ist sehr automatisierungsfreundlich und kann von CI, Skripten oder AI Agents (wie Claude Code) direkt gesteuert werden:

* **Anmeldefrei**: Manage Key über die Umgebungsvariable `AIHUBMIX_TOKEN` oder `--token` übergeben, um die interaktive Anmeldung zu überspringen (Priorität: `--token` > `AIHUBMIX_TOKEN` > Konfigurationsdatei).
* **JSON-Ausgabe**: Fügen Sie einem beliebigen Befehl `--json` (`-j`) hinzu; reguläre Ergebnisse gehen an stdout, Fehler an stderr – praktisch für die Auswertung mit `jq`.
* **Stabile Exit-Codes**: Skripte können daran Erfolg oder Misserfolg erkennen.

```bash theme={null}
# Per Umgebungsvariable steuern, alle Key-Namen extrahieren
AIHUBMIX_TOKEN=fd*** aihubmix keys list --json | jq '.data[].name'

# Kontostand abfragen
AIHUBMIX_TOKEN=fd*** aihubmix whoami --json | jq -r '.balance'
```

Bedeutung der Exit-Codes:

| Exit-Code | Bedeutung                                                    |
| --------- | ------------------------------------------------------------ |
| `0`       | Erfolg                                                       |
| `1`       | Allgemeiner Fehler (Parameterfehler, Business-Fehler usw.)   |
| `2`       | Authentifizierungsfehler (nicht angemeldet / Token ungültig) |
| `3`       | Netzwerk-/Verbindungsfehler                                  |

## Globale Parameter

Die folgenden Parameter gelten für alle Befehle:

| Parameter          | Kurzform | Beschreibung                                                     |
| ------------------ | -------- | ---------------------------------------------------------------- |
| `--token <token>`  | `-t`     | Manage Key direkt übergeben (CI-/Skript-Szenario)                |
| `--json`           | `-j`     | Ausgabe im JSON-Format                                           |
| `--base-url <url>` | `-b`     | Benutzerdefinierte API-Adresse (Standard `https://aihubmix.com`) |
| `--no-color`       |          | Farbige Ausgabe deaktivieren                                     |
| `--config <path>`  |          | Pfad zur Konfigurationsdatei angeben                             |
| `--version`        |          | Version anzeigen                                                 |

## Konfigurationsdatei

Die Anmeldedaten werden in `~/.aihubmix/config.json` gespeichert (Windows: `%USERPROFILE%\.aihubmix\config.json`), mit auf **nur für den aktuellen Benutzer les- und schreibbar** eingeschränkten Berechtigungen. Bei der Anmeldung wird der Manage Key nicht angezeigt und nicht protokolliert.

<Warning>
  Übergeben Sie den Manage Key niemals an ein Code-Repository und teilen Sie ihn nicht mit anderen. Sollte er offengelegt werden, generieren Sie ihn in der Konsole neu – das alte Token wird sofort ungültig.
</Warning>

## Häufige Fragen

**Muss ich Python / Node / Go installieren?**

Nein. Die CLI ist eine einzelne Binärdatei, herunterladen und sofort verwenden.

**Was ist der Unterschied zwischen Manage Key und API Key?**

Der Manage Key (`fd***`) dient der Kontoverwaltung (Guthaben abfragen, Keys verwalten) und wird von der CLI verwendet; der API Key (`sk-***`) dient Modellaufrufen. Beide werden an unterschiedlichen Stellen in der Konsole generiert und dürfen nicht verwechselt werden.

**Wird Windows unterstützt?**

Ja. Für Windows, macOS und Linux werden native Binärdateien bereitgestellt.

**Wie verwende ich die CLI interaktionsfrei in CI / Skripten?**

Übergeben Sie den Manage Key über die Umgebungsvariable `AIHUBMIX_TOKEN` und kombinieren Sie ihn mit `--json` und Exit-Codes – `aihubmix login` ist dann nicht erforderlich.

**Was tun, wenn der Manage Key vergessen oder offengelegt wurde?**

Generieren Sie ihn unter [console.aihubmix.com/setting](https://console.aihubmix.com/setting) neu – das alte Token wird damit ungültig.

***

*Verwandte Dokumentation: [Plattform-API · CliEndpoints](/de/api/CliEndpoints/get-self) · [Altes Python-Skript](/de/api/Cli) · [AIHubMix-Konsole](https://console.aihubmix.com)*

***

Zuletzt aktualisiert: 2026-06-22