---
title: KI-Konten und Abonnements
description: Verbinden Sie die KI-Quelle für AI Chat (API-Keys, OpenRouter, Google) und nutzen Sie Ihr Claude-, ChatGPT- oder Gemini-Abo über offizielle CLIs.
url: https://nexcmp.com/de/docs/configure-with-ai/ai-accounts-and-subscriptions/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# KI-Konten und Abonnements {#ai-accounts-and-subscriptions}

> **Wo im Admin-Bereich:** System › Settings › AI accounts (`/agent/accounts`), Registerkarten **Accounts** und **Use your own AI subscription**. Das optionale Terminal ist AI Console (`/agent/console`), das nur dann unter AI Chat angezeigt wird, wenn es eingeschaltet ist.

## Funktion {#what-it-does}

AI Chat benötigt eine Antwortquelle. Auf dieser Seite können Sie diese Quelle für Ihr eigenes Administratorkonto verbinden:

- **API-Quellen**: OpenAI, Anthropic (Claude), Google Gemini und OpenRouter, mit einem API-Schlüssel oder einer Anmeldung.
- **Der Panel-KI-Anbieter**, falls Sie bereits einen unter System › Settings › AI provider festgelegt haben.
- **Ihr eigenes KI-Abonnement** (Claude, ChatGPT, Gemini) über das **offizielle Befehlszeilentool** des Anbieters, entweder auf dem Panel-Server oder auf Ihrem eigenen Computer.

Alles, was Sie verbinden, gehört zu Ihrem Administratorkonto. Schlüssel und Token werden verschlüsselt nur für Sie gespeichert; ein anderer Administrator kann sie nicht verwenden.

## Anforderungen {#requirements}

| Komponente | Anforderung |
|---|---|
| Rolle | Ein angemeldeter Administrator. Auf einem Demopanel kann nichts verbunden oder entfernt werden. |
| API-Quellen | Ein Konto und ein API-Schlüssel beim Anbieter (die Karte enthält einen Link **Get API key**, der die Anbieterseite öffnet). |
| CLI auf dem Panel-Server | AI Console eingeschaltet (siehe unten), ausgehendes HTTPS vom Server zum Anbieter und zu `nodejs.org` sowie zur npm-Registry und **2 GB RAM oder mehr** (eine CLI benötigt im laufenden Betrieb etwa 1 GB freien Speicher; das Installationsprogramm warnt unter 2 GB). Node.js 20 oder neuer wird verwendet, falls vorhanden, andernfalls lädt das Installationsprogramm Node.js 22 mit einer Prüfsummenüberprüfung herunter. |
| CLI auf Ihrem Computer | Node.js 20 oder neuer zur Installation der CLI und Ihr eigenes Abonnement. |

## API-Quelle verbinden {#connect-an-api-source}

1. Öffnen Sie **System › Settings › AI accounts** und bleiben Sie auf **Accounts**.
2. Klicken Sie auf der Karte der Quelle auf **Connect**. Die Schlüsselseite des Anbieters öffnet sich in einem neuen Tab; erstellen Sie dort einen Schlüssel.
3. Fügen Sie den Schlüssel in das Feld ein und speichern Sie. Die Karte zeigt einen verbundenen Status mit den letzten vier Zeichen.
4. Wählen Sie das **default model**, falls Sie ein anderes wünschen, und klicken Sie dann auf **Test**. Ein gutes Ergebnis sieht etwa so aus: "Connected - example-model, 850 ms".

![KI-Konten-Seite mit den API-Quellenkarten, einer verbundenen OpenAI-Karte und der Panel-KI-Anbieterkarte](https://nexcmp.com/de/docs/images/configure-with-ai/ai-accounts-and-subscriptions-01-accounts.webp)

| Source | Anmeldealternative |
|---|---|
| OpenRouter | **Sign in with OpenRouter** öffnet OpenRouter in einem Popup oder Tab; nach der Bestätigung kehren Sie verbunden zu dieser Seite zurück. |
| Google Gemini | **Sign in with Google** erscheint nach dem Speichern unter **Set up Google sign-in (optional)** auf der Karte, sofern ein OAuth-Client in **Ihrem eigenen** Google Cloud-Projekt erstellt wurde (Client-ID, die auf `.apps.googleusercontent.com` endet, plus zugehöriges Secret). NexCMP liefert keinen gemeinsam genutzten Google-Client aus. |
| Panel-KI-Anbieter | Verwendet den bereits unter System › Settings › AI provider ([AI provider](https://nexcmp.com/de/docs/ai/ai-providers/)) konfigurierten Anbieter. Es muss nichts eingefügt werden. |

Um eine Quelle zu trennen, klicken Sie auf ihrer Karte auf **Remove**. Dadurch wird der gespeicherte Schlüssel für Ihr Konto gelöscht.

### Standardwerte, Tageslimit und Berechtigungen {#defaults-daily-cap-and-permissions}

Am unteren Rand des Tabs **Accounts** hat **Defaults for AI Chat** drei Einstellungen:

| Einstellung | Bedeutung |
|---|---|
| Standardquelle und -modell | Wofür neue Chats verwendet werden. Sie können die Quelle pro Nachricht weiterhin ändern. |
| Tägliches Ausgabenlimit (USD, 0 = kein Limit) | Standard 5. Die Seite zeigt "used today". Siehe [AI Chat in the admin](https://nexcmp.com/de/docs/configure-with-ai/ai-chat-in-admin/#daily-spending-cap). |
| Chat-Sitzungsberechtigungen | Die Bereiche, die der Assistent verwenden darf. `admin:read` ist immer aktiv; `secrets:write` ist standardmäßig deaktiviert. Siehe [Admin API keys](https://nexcmp.com/de/docs/configure-with-ai/admin-api-keys/#scopes). |

Klicken Sie auf **Save defaults**.

## Eigenes KI-Abonnement verwenden {#use-your-own-ai-subscription}

Sie können NexCMP mit einem Claude-, ChatGPT- oder Gemini-Tarif steuern, für den Sie bereits bezahlen, ganz ohne separaten API-Schlüssel. Dafür gibt es zwei Wege.

### Weg 1 (empfohlen): Die CLI auf Ihrem eigenen Computer {#way-1-recommended-the-cli-on-your-own-computer}

Sie verwenden das eigene Tool des Anbieters auf Ihrem Computer und melden sich wie gewohnt mit Ihrem Konto an. NexCMP empfängt lediglich MCP-Aufrufe, die mit einem kurzlebigen Schlüssel signiert sind. Öffnen Sie **AI accounts › Use your own AI subscription**; dort werden drei Schritte pro Tool angezeigt.

1. Klicken Sie auf **Create a 7-day key** und wählen Sie die Stufe aus: **Read only** (`admin:read`) oder **Read + configuration** (`admin:read`, `catalog:write`, `infra:write`, `settings:write`). Die Befehle unten enthalten dann den echten Schlüssel.
2. Installieren Sie die CLI und melden Sie sich an. Der Schlüssel wird nur auf dieser Seite und nur einmal angezeigt.

   | Tool | Installation | Anmelden |
   |---|---|---|
   | Claude Code | `npm install -g @anthropic-ai/claude-code` | führen Sie `claude` aus, dann `/login` |
   | Codex CLI | `npm install -g @openai/codex` | `codex login` |
   | Gemini CLI | `npm install -g @google/gemini-cli` | führen Sie `gemini` aus, wählen Sie "Login with Google" |

3. Verbinden Sie es mit einem Befehl oder einem Block, der von der Seite kopiert wurde, mit Ihrem Panel:

   ```bash
   # Claude Code
   claude mcp add --transport http nexcmp https://cloud.example.com/mcp/admin \
     --header "Authorization: Bearer ak_XXXX"
   ```

   ```toml
   # Codex CLI: ~/.codex/config.toml, then: export NEXCMP_KEY=ak_XXXX
   [mcp_servers.nexcmp]
   url = "https://cloud.example.com/mcp/admin"
   bearer_token_env_var = "NEXCMP_KEY"
   ```

   ```json
   // Gemini CLI: ~/.gemini/settings.json
   { "mcpServers": { "nexcmp": {
       "httpUrl": "https://cloud.example.com/mcp/admin",
       "headers": { "Authorization": "Bearer ak_XXXX" } } } }
   ```

4. Starten Sie das Tool und fragen Sie beispielsweise "what is left to set up in nexcmp?". Alle Details zur MCP-Verbindung finden Sie unter [Connect an AI client](https://nexcmp.com/de/docs/configure-with-ai/mcp-admin/).

Derselbe Tab zeigt die URL für die Konnektoren von **claude.ai** und **ChatGPT**, die sich per OAuth anmelden und keinen Schlüssel benötigen: [OAuth connectors](https://nexcmp.com/de/docs/configure-with-ai/oauth-connectors/).

![Tab „Use your own AI subscription“ mit der 7-Tage-Schlüssel-Schaltfläche sowie den Befehlen zum Installieren, Anmelden und Verbinden für drei CLIs](https://nexcmp.com/de/docs/images/configure-with-ai/ai-accounts-and-subscriptions-02-subscription.webp)

### Weg 2: Die CLI auf dem Panel-Server (Installieren / Anmelden-Schaltflächen) {#way-2-the-cli-on-the-panel-server-install-login-buttons}

Die Karten unter „Subscription through a CLI (Claude, ChatGPT, Gemini)“ ermöglichen es NexCMP, die offizielle CLI auf dem Panel-Server zu installieren und einen eigenen Anmeldeablauf zu starten, sodass **AI Chat** mit Ihrem Abonnement antworten kann.

**Wie die Isolierung funktioniert.** Die CLIs laufen in einem separaten Prozess (`nexcmp-ai.service`) als eigener Systembenutzer `nexcmp-ai`, ohne sudo, ohne Zugriff auf die Daten- und Konfigurationsordner von NexCMP sowie mit einem Speicherlimit. Für jede AI Chat-Nachricht wird die CLI gestartet, wobei nur die NexCMP-MCP-Tools erlaubt sind (Shell- und Dateitools sind deaktiviert) und ein Schlüssel verwendet wird, der nur vom Server aus funktioniert. NexCMP liest oder kopiert die Anmeldung der CLI nicht: Die CLI speichert diese in einem privaten Ordner für Ihr Administratorenkonto.

Es muss nichts aktiviert werden: Das Panel richtet den `nexcmp-ai`-Benutzer und -Dienst bei der Installation oder beim Update auf 1.4.0 automatisch ein, sodass die Karten sofort einsatzbereit sind.

**Installieren und Anmelden (pro Administrator):**

1. Klicken Sie auf der Karte der CLI auf **Login**. Wenn die CLI noch nicht installiert ist, installiert das Panel sie zuerst: Ein Fortschrittsbalken und ein kurzes Protokoll zeigen den Download (Node.js falls erforderlich, gefolgt von der CLI). Eine Warnung wird angezeigt, wenn der Server über weniger als 2 GB RAM verfügt.
2. Die Karte zeigt an, was die CLI anfordert:
   - **Codex CLI**: Klicken Sie auf **Open the sign-in page** und geben Sie den Einmalcode ein, der auf der Karte angezeigt wird. (Die Geräteanmeldung von OpenAI muss in Ihren ChatGPT-Sicherheitseinstellungen aktiviert sein.)
   - **Claude Code und Gemini CLI**: Klicken Sie auf **Open the sign-in page**, melden Sie sich an, fügen Sie dann den Bestätigungscode von der Seite des Anbieters in **Paste the verification code here** ein und klicken Sie auf **Send code**.
3. Die Karte wechselt zu „Signed in“ mit Angabe des Kontos und der Version. Eine Anmeldung, die nicht innerhalb von 10 Minuten abgeschlossen wird, wird abgebrochen; klicken Sie erneut auf **Login**.
4. In **AI Chat** erscheint die Quelle nun im Auswahlmenü (z. B. „ChatGPT (via Codex CLI)“).
5. **Abmelden** entfernt die CLI-Anmeldung für Ihr Konto.

Für Claude verfügt die Karte über einen zusätzlichen Schalter **I understand and accept the vendor's terms for using a subscription this way**, der standardmäßig deaktiviert ist. Die Quelle wird im AI Chat erst angeboten, wenn dieser Schalter aktiv ist.

![CLI-Abonnementkarten mit Installieren und Anmelden, einem Einmalcode auf der Codex-Karte und dem „I understand“-Schalter auf der Claude-Karte](https://nexcmp.com/de/docs/images/configure-with-ai/ai-accounts-and-subscriptions-03-cli.webp)

### Bedingungen der KI-Anbieter {#terms-of-the-ai-vendors}

Die Anmeldung mit einem Endkundenabonnement unterliegt den jeweiligen Anbieterbedingungen, die sich ändern können. Die folgenden Hinweise fassen das zusammen, was die Anbieter Stand Oktober 2026 veröffentlichen; dies stellt keine Rechtsberatung und keine Erklärung im Namen der Anbieter dar. Lesen Sie die aktuellen Seiten, bevor Sie diese Funktion aktivieren.

| Anbieter | Was die Seite des Anbieters abdeckt | Source |
|---|---|---|
| Anthropic (Claude) | Die Anmeldung bei dem unmodifizierten Claude Code mit einem eigenen Tarif ist abgedeckt. Die Nutzung eines Abonnements über andere Produkte oder die Erfassung bzw. Weiterleitung der Anmeldung durch ein Produkt wird unterschiedlich gehandhabt, und Tarifierungsgrenzen gehen von der üblichen privaten Nutzung aus. Aus diesem Grund enthält die Claude-Karte einen Hinweis sowie den Schalter **I understand**, und deshalb ist Weg 1 die sauberere Wahl. | https://code.claude.com/docs/en/legal-and-compliance |
| OpenAI (Codex) | Codex unterstützt die Anmeldung mit einem ChatGPT-Konto oder einem API-Schlüssel. OpenAI empfiehlt API-Schlüssel für die Automatisierung und rät davon ab, Codex in nicht vertrauenswürdigen oder öffentlichen Umgebungen offenzulegen. Verwenden Sie die Karte nur für sich selbst. | https://developers.openai.com/codex/auth |
| Google (Gemini CLI) | Unterstützt Sign in with Google, einen API-Schlüssel und Vertex AI; die Bedingungen hängen von der Art der Anmeldung ab, und die Kontingente Ihres Tarifs finden Anwendung. | https://geminicli.com/docs/get-started/authentication |

Wenn Sie die Frage komplett umgehen möchten, verwenden Sie eine **API key**-Quelle oder Weg 1 auf Ihrem eigenen Computer.

## AI Console {#ai-console}

Die AI Console ist eine optionale Terminalseite zum Ausführen einer der angemeldeten CLIs auf dem Panel-Server. Sie ist **standardmäßig deaktiviert**.

- Schalten Sie sie ein oder aus und verwalten Sie die CLIs auf dem Server:

  ```bash
  sudo nexcmp ai-console enable          # turn on (also creates the nexcmp-ai user and service)
  sudo nexcmp ai-console disable         # turn off
  sudo nexcmp ai-console status          # runner, console state and installed CLIs
  sudo nexcmp ai-console install claude  # or codex, or gemini
  ```

  `status` gibt aus, ob der AI-Runner-Socket bereit ist, ob die AI Console aktiviert oder deaktiviert ist und für jede CLI „installed“ oder „not installed“. `sudo nexcmp status` zeigt zudem „AI runner: active“ an.
- Nach der Aktivierung erscheint ein **AI Console**-Tab unter AI Chat. Wählen Sie eine angemeldete CLI, geben Sie Ihr Admin-Passwort (und Ihren 2FA-Code, falls verwendet) erneut ein und öffnen Sie eine Sitzung. Ein Banner erinnert Sie daran, dass Befehle hier NexCMP nur über seine MCP-Tools verwalten können; Shell- und Dateitools sind deaktiviert.
- Demo-Installationen erstellen niemals den `nexcmp-ai`-Benutzer.

![AI Console-Startbildschirm mit CLI-Auswahl, Passwortfeld und der Warnbanner nur für MCP](https://nexcmp.com/de/docs/images/configure-with-ai/ai-accounts-and-subscriptions-04-console.webp)

## Verifizierung {#verify}

1. **Test** bei einer API-Quelle gibt den Modellnamen zurück.
2. Auf der CLI-Karte lautet der Status mit dem Konto „Signed in“.
3. Auf dem Server: `sudo nexcmp ai-console status` listet die CLI als installiert auf und `systemctl is-active nexcmp-ai` gibt `active` aus.
4. Wählen Sie im AI Chat die Quelle aus, fragen Sie „Check my setup progress“ und es erscheint eine Werkzeugkarte.

## Limits & Hinweise {#limits-notes}

- Eine CLI-Antwort ist auf 5 Minuten und eine Antwort gleichzeitig pro Administrator begrenzt. Das tägliche Limit rechnet CLI-Antworten nicht ein.
- Jede Änderung von einer CLI-Quelle ist im AI Chat weiterhin eine Bestätigungskarte; die CLI kann Änderungen nicht selbstständig anwenden.
- Abonnementpläne haben ihre eigenen Nutzungslimits. Wenn der Anbieter „usage limit“ oder „not logged in“ meldet, zeigt der Chat diese Nachricht an.
- Das Entfernen einer Quelle löscht keine Konversationen.
- Halten Sie den Server aktuell: Die CLIs werden zum Zeitpunkt des Klickens auf Installieren aus den öffentlichen Paketen der Anbieter installiert.

## Fehlerbehebung {#troubleshooting}

| Symptom | Ursache | Behebung |
|---|---|---|
| Die Anmeldung ist deaktiviert und die Karte besagt „AI tools are not ready on the server yet“ | Der `nexcmp-ai`-Dienst läuft nicht | Aktualisieren Sie das Panel auf die neueste Version und prüfen Sie dann `sudo nexcmp status`. In der Read-Only-Demo ist dies so erwartet. |
| „AI tools are not installed on this server yet“ | Der `nexcmp-ai`-Dienst läuft nicht (älteres Panel oder Demo-Panel) | Aktualisieren Sie das Panel und führen Sie dann `sudo nexcmp ai-console install claude` (oder `codex`, `gemini`) aus. |
| Warnung vor RAM unter 2 GB | Der Server ist klein | Die Installation verläuft möglicherweise langsam oder schlägt fehl; fügen Sie Speicher hinzu oder verwenden Sie Weg 1. |
| „Node.js download checksum mismatch“ oder „download failed“ | Der Server kann nodejs.org nicht erreichen oder ein Proxy hat den Download verändert | Erlauben Sie ausgehendes HTTPS und versuchen Sie es erneut. |
| Die Installation endet mit einem Fehler | npm konnte das Paket nicht installieren | Lesen Sie das Protokoll auf der Karte, prüfen Sie den ausgehenden Zugriff auf die npm-Registry und versuchen Sie es erneut. |
| Die Anmeldung endet mit einem Fehler oder Zeitüberschreitung | Das 10-Minuten-Fenster ist abgelaufen oder der Code war falsch | Klicken Sie erneut auf **Login** und schließen Sie den Vorgang schneller ab. |
| Die Claude-Quelle fehlt im AI Chat | Der Schalter **I understand** ist aus oder die CLI ist nicht angemeldet | Schalten Sie den Schalter nach dem Lesen der Anbieterseite ein und melden Sie sich an. |
| „Sign in with Google“ fehlt bei Gemini | Noch kein Google OAuth-Client gespeichert | Erstellen Sie den Client in Ihrem eigenen Google Cloud-Projekt und speichern Sie ihn unter **Set up Google sign-in (optional)** auf der Karte oder fügen Sie stattdessen einen API-Schlüssel ein. |
| "Sign in with OpenRouter" liefert einen Fehler | Sie haben abgebrochen oder das Pop-up wurde blockiert | Erlauben Sie Pop-ups und versuchen Sie es erneut. |
| Die CLI-Antwort gibt "usage limit" aus | Das Kontingent des Tarifs ist aufgebraucht | Warten Sie oder wechseln Sie die Quelle. |