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

# GccAi in ChatBox verwenden

> Ausführliche Anleitung zur Konfiguration und Nutzung des GccAi-API-Dienstes im ChatBox Desktop-Client. Diese Anleitung hilft Ihnen, GccAi in ChatBox einzurichten, um auf zahlreiche KI-Modellressourcen zuzugreifen.

## Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher:

1. **ChatBox ist installiert**
   Laden Sie die für Ihr Betriebssystem passende Version von [ChatBox GitHub](https://github.com/Bin-Huang/chatbox) oder der [offiziellen ChatBox-Website](https://chatboxai.app/) herunter und installieren Sie sie

2. **GccAi-API-Schlüssel vorhanden**
   Melden Sie sich in der [GccAi-Konsole](https://gccai.heqingsong.uk/keys) an, um Ihren API-Schlüssel zu erhalten (beginnt mit `sk-`)

<Note>
  **Tipp:** Wenn Sie noch kein GccAi-Konto haben, registrieren Sie sich zuerst bei [GccAi](https://gccai.heqingsong.uk) und holen Sie sich einen API-Schlüssel.
</Note>

## Schritt 1: ChatBox starten und Konfiguration beginnen

Beim ersten Start von ChatBox oder beim Hinzufügen eines neuen KI-Anbieters:

1. Starten Sie die ChatBox-Anwendung
2. Beim ersten Mal erscheint automatisch ein Konfigurationsassistent
3. Klicken Sie auf die Schaltfläche **„Eigenen API-Schlüssel oder lokales Modell verwenden"**
4. Wenn bereits konfiguriert, klicken Sie auf das **⚙️ Einstellungen**-Symbol unten links oder verwenden Sie `Ctrl+,` (Windows/Linux) / `Cmd+,` (macOS)

<Frame>
  <img src="https://mintcdn.com/apicore/60dm1rHMQir4d9rs/images/integrations/chatbox/main-interface.png?fit=max&auto=format&n=60dm1rHMQir4d9rs&q=85&s=97330aedf8be26446c3a8d9e4386f0bd" alt="ChatBox Configuration Wizard" width="1023" height="768" data-path="images/integrations/chatbox/main-interface.png" />
</Frame>

<caption>*ChatBox-Konfigurationsassistent, wählen Sie die Verwendung Ihres eigenen API-Schlüssels*</caption>

## Schritt 2: GccAi-API konfigurieren

### 2.1 KI-Modellanbieter auswählen

Auf der Einstellungsseite:

1. Suchen Sie die Einstellung **AI Provider**
2. Wählen Sie **OpenAI API** (für GPT-Modelle), **Claude API** (für Claude-Modelle) oder **Gemini API** (für Gemini-Modelle) aus dem Dropdown-Menü

<Frame>
  <img src="https://mintcdn.com/apicore/60dm1rHMQir4d9rs/images/integrations/chatbox/settings-page.png?fit=max&auto=format&n=60dm1rHMQir4d9rs&q=85&s=f53a32eb9ce38bd30aa3d631a6582a88" alt="ChatBox Settings Page" width="1023" height="768" data-path="images/integrations/chatbox/settings-page.png" />
</Frame>

<caption>*ChatBox-Einstellungsseite, wählen Sie OpenAI API als Anbieter*</caption>

### 2.2 API-Informationen konfigurieren

Nach Auswahl von OpenAI API füllen Sie die folgende Konfiguration aus:

| Feld                             | Wert                                          |
| -------------------------------- | --------------------------------------------- |
| **API Key**                      | Ihr GccAi-API-Schlüssel (`sk-xxxxxxxxxxxx`) |
| **API Host** oder **API Domain** | `https://gccai.heqingsong.uk`                      |

<Frame>
  <img src="https://mintcdn.com/apicore/60dm1rHMQir4d9rs/images/integrations/chatbox/api-config.png?fit=max&auto=format&n=60dm1rHMQir4d9rs&q=85&s=8fe2f0c256c2f0db5ee3a5226b833509" alt="API Configuration" width="1023" height="768" data-path="images/integrations/chatbox/api-config.png" />
</Frame>

Nach Auswahl von Claude API füllen Sie die folgende Konfiguration aus:

| Feld                             | Wert                                          |
| -------------------------------- | --------------------------------------------- |
| **API Key**                      | Ihr GccAi-API-Schlüssel (`sk-xxxxxxxxxxxx`) |
| **API Host** oder **API Domain** | `https://gccai.heqingsong.uk/v1`                   |

<Frame>
  <img src="https://mintcdn.com/apicore/BIebF3Cd34siboYG/images/integrations/chatbox/claude.png?fit=max&auto=format&n=BIebF3Cd34siboYG&q=85&s=cbe2d868a9b163e2429ededba1bc7586" alt="Claude Model" width="1023" height="768" data-path="images/integrations/chatbox/claude.png" />
</Frame>

Nach Auswahl von Gemini API füllen Sie die folgende Konfiguration aus:

| Feld                             | Wert                                          |
| -------------------------------- | --------------------------------------------- |
| **API Key**                      | Ihr GccAi-API-Schlüssel (`sk-xxxxxxxxxxxx`) |
| **API Host** oder **API Domain** | `https://gccai.heqingsong.uk/`                     |

<caption>*Geben Sie API-Schlüssel und API Host von GccAi ein*</caption>

<Frame>
  <img src="https://mintcdn.com/apicore/BIebF3Cd34siboYG/images/integrations/chatbox/Gemini.png?fit=max&auto=format&n=BIebF3Cd34siboYG&q=85&s=779122ac703c90f3ed009aa8dae47370" alt="Gemini" width="1023" height="768" data-path="images/integrations/chatbox/Gemini.png" />
</Frame>

<Warning>
  **Wichtig:**

  * Bei Verwendung der OpenAI API sollte der API Host `https://gccai.heqingsong.uk` sein (ohne `/v1`-Suffix)
  * Bei Verwendung der Claude API sollte der API Host `https://gccai.heqingsong.uk/v1` sein (mit `/v1`-Suffix)
  * Bei Verwendung der Gemini API sollte der API Host `https://gccai.heqingsong.uk/` sein (ohne `/v1`-Suffix)
  * API Key muss aus der GccAi-Konsole stammen und mit `sk-` beginnen
  * Stellen Sie sicher, dass Ihr API-Schlüssel ausreichend Guthaben hat
</Warning>

### 2.3 Modell auswählen

Wählen Sie nach der Konfiguration das gewünschte Modell aus dem **Model**-Dropdown:

**Empfohlene Modelle:**

| Modellname        | Modell-ID                         | Eigenschaften                   |
| ----------------- | --------------------------------- | ------------------------------- |
| GPT-5             | `gpt-5`                           | Neuestes und leistungsstärkstes |
| GPT-4o            | `gpt-4o` oder `chatgpt-4o-latest` | Hochwertiger Chat               |
| GPT-4o Mini       | `gpt-4o-mini`                     | Schnell und sparsam             |
| Claude Sonnet 4.5 | `claude-sonnet-4-5-20250929`      | Hervorragend für Code           |
| Claude Haiku 4.5  | `claude-haiku-4-5-20251001`       | Schnelle Antwort                |
| Gemini 2.0 Flash  | `gemini-2.0-flash-exp`            | Multimodale Unterstützung       |

<Warning>
  **Spezielle Hinweise zur Nutzung von Claude-Modellen:**

  Wenn Sie Claude-Modelle wählen (z. B. `claude-sonnet-4-5-20250929` oder `claude-haiku-4-5-20251001`), sind folgende zusätzliche Konfigurationen nötig:

  1. **Wechseln zum Claude-API-Anbieter**:
     * Ändern Sie den **AI Provider** in den Einstellungen auf **Claude API**
     * Behalten Sie API Host als `https://gccai.heqingsong.uk/v1`
     * Verwenden Sie Ihren GccAi-API-Schlüssel (`sk-xxxxxxxxxxxx`)

  2. **Oder benutzerdefinierte Anfrage-Header hinzufügen** (bei Verwendung des OpenAI-API-Anbieters):
     * Einige ChatBox-Versionen unterstützen das Hinzufügen benutzerdefinierter Headers
     * Fügen Sie in den erweiterten Einstellungen den Header hinzu: `anthropic-version: 2023-06-01`

  **Empfohlener Ansatz:** Verwenden Sie **OpenAI API** für GPT-Modelle, **Claude API** für Claude-Modelle und **Gemini API** für Gemini-Modelle.
</Warning>

<caption>*Wählen Sie das gewünschte KI-Modell aus der Liste*</caption>

<Tip>
  **Leistungsempfehlungen:**

  * 💰 **Kosteneffizient:** `gpt-4o-mini`, `claude-haiku-4-5-20251001`
  * 🚀 **Hochleistung:** `gpt-5`, `gpt-4o`, `claude-sonnet-4-5-20250929`
  * ⚡ **Schnelle Antwort:** `gemini-2.0-flash-exp`, `gpt-4o-mini`
</Tip>

## Schritt 3: Mit der Nutzung beginnen

Nach der Konfiguration können Sie ChatBox nutzen, um mit der KI zu chatten:

1. Kehren Sie zur Hauptoberfläche zurück
2. Geben Sie Ihre Frage oder Anforderung in das Eingabefeld ein
3. Drücken Sie `Enter` oder klicken Sie auf die Sendeschaltfläche
4. Die KI generiert eine Antwort mit den Modellen von GccAi

<Frame>
  <img src="https://mintcdn.com/apicore/60dm1rHMQir4d9rs/images/integrations/chatbox/chat-interface.png?fit=max&auto=format&n=60dm1rHMQir4d9rs&q=85&s=3bdd5a9f07e4d0610520c71d0ff2d599" alt="Chat Interface" width="1023" height="768" data-path="images/integrations/chatbox/chat-interface.png" />
</Frame>

<caption>*ChatBox-Chat-Oberfläche, beginnen Sie mit der KI zu sprechen*</caption>

### Modellparameter anpassen (optional)

Sie können folgende Parameter nach Bedarf anpassen:

| Parameter       | Beschreibung                         | Empfohlener Wert              |
| --------------- | ------------------------------------ | ----------------------------- |
| **Temperature** | Steuert die Zufälligkeit der Ausgabe | 0,7 (kreativ) / 0,3 (präzise) |
| **Max Tokens**  | Maximale Ausgabelänge                | 2000-4000                     |
| **Top P**       | Nucleus-Sampling-Parameter           | 0,9                           |

## Erweiterte Funktionen

### Multi-Session-Management

ChatBox unterstützt das Erstellen mehrerer Konversationssitzungen:

1. Klicken Sie auf **New Chat**
2. Erstellen Sie unabhängige Sitzungen für verschiedene Aufgaben
3. Wechseln Sie in der linken Sitzungsliste zwischen Konversationen

### Konversationen speichern und exportieren

1. Rechtsklick auf eine Konversationssitzung
2. Wählen Sie die Option **Export**
3. Exportieren Sie als Markdown, JSON oder in anderen Formaten

### Prompt-Vorlagen verwenden

1. Suchen Sie im Einstellungsmenü die **Prompts**-Einstellungen
2. Speichern Sie häufig verwendete Prompt-Vorlagen
3. Rufen Sie voreingestellte Prompts schnell in Konversationen auf

## FAQ

### Q1: Keine Verbindung zum GccAi-Dienst möglich?

**Lösung:**

1. **API Host prüfen**:
   * Stellen Sie sicher, dass es `https://gccai.heqingsong.uk` ist
   * Fügen Sie kein `/v1` oder andere Pfade hinzu

2. **API Key überprüfen**:
   * Bestätigen Sie, dass der API Key mit `sk-` beginnt
   * Prüfen Sie die Gültigkeit in der [GccAi-Konsole](https://gccai.heqingsong.uk/keys)

3. **Netzwerkverbindung prüfen**:
   * Stellen Sie sicher, dass Sie auf `https://gccai.heqingsong.uk` zugreifen können
   * In China kann eine Proxy-Konfiguration erforderlich sein

### Q2: GccAi-Modelle erscheinen nicht in der Modellliste?

**Lösung:**

1. **Modellname manuell eingeben**:
   * Geben Sie die Modell-ID direkt ins Modelleingabefeld ein
   * Zum Beispiel: `gpt-4o`, `gpt-4o-mini`, `claude-sonnet-4-5-20250929`

2. **Modellliste aktualisieren**:
   * Starten Sie die ChatBox-Anwendung neu
   * Konfigurieren Sie die API-Informationen neu

### Q3: Fehlermeldungen während des Gesprächs?

**Häufige Fehler und Lösungen:**

| Fehlermeldung               | Ursache                              | Lösung                                                 |
| --------------------------- | ------------------------------------ | ------------------------------------------------------ |
| `401 Unauthorized`          | Ungültiger oder abgelaufener API Key | API Key neu beschaffen und Konfiguration aktualisieren |
| `429 Too Many Requests`     | Anfragenrate überschritten           | Kurz warten und erneut versuchen                       |
| `500 Internal Server Error` | Vorübergehendes Serverproblem        | Einige Minuten warten und erneut versuchen             |
| `insufficient_quota`        | Unzureichendes Kontoguthaben         | In der Konsole aufladen                                |

### Q4: Wie sehe ich API-Nutzung und Kosten ein?

Melden Sie sich in der [GccAi-Konsole](https://gccai.heqingsong.uk/overview) an, um Folgendes zu sehen:

* 📊 API-Aufruf-Statistik
* 💰 Kostendetails
* 📈 Nutzungstrend-Diagramme
* 🔍 Detaillierte Anfrage-Logs

### Q5: Welche Plattformen unterstützt ChatBox?

ChatBox unterstützt mehrere Plattformen:

* 🪟 **Windows** – Windows 10/11
* 🍎 **macOS** – macOS 10.15+
* 🐧 **Linux** – wichtige Distributionen
* 🌐 **Web** – Browser-Version

## Nutzungstipps

### 1. Tastaturkürzel

Nutzen Sie ChatBox-Tastaturkürzel für Effizienz:

| Tastenkürzel       | Funktion                   |
| ------------------ | -------------------------- |
| `Ctrl/Cmd + Enter` | Nachricht senden           |
| `Ctrl/Cmd + N`     | Neuer Chat                 |
| `Ctrl/Cmd + K`     | Konversationen durchsuchen |
| `Ctrl/Cmd + ,`     | Einstellungen öffnen       |
| `Ctrl/Cmd + /`     | Tastaturhilfe anzeigen     |

### 2. Prompts optimieren

Schreiben Sie bessere Prompts für bessere Antworten:

**❌ Schlechter Prompt:**

```
Write code for me
```

**✅ Guter Prompt:**

```
Please help me write a Python function that:
1. Takes a list of strings as input
2. Filters out strings shorter than 3 characters
3. Returns results sorted alphabetically
Please include detailed comments and usage examples
```

### 3. Konversationsverlauf nutzen

ChatBox speichert den Konversationsverlauf:

* Die KI erinnert sich an den Kontext der aktuellen Sitzung
* Sie können basierend auf vorherigen Antworten weiterfragen
* Geeignet für tiefe Diskussionen und Iterationen

### 4. Modelle wechseln

Wechseln Sie für verschiedene Aufgaben zu passenden Modellen:

* **Schreibaufgaben** – `gpt-4o` oder `claude-sonnet-4-5`
* **Code-Aufgaben** – `claude-sonnet-4-5`
* **Schnelle Fragen** – `gpt-4o-mini`
* **Multimodal** – `gemini-2.0-flash-exp`

## Funktionen

Mit ChatBox + GccAi können Sie:

* 💬 **Flüssige Konversationen** – Echtzeit-Streaming-Ausgabe für ein flüssigeres Erlebnis
* 🎯 **Multi-Session-Management** – mehrere unabhängige Konversationen gleichzeitig verwalten
* 💾 **Lokale Speicherung** – Konversationsverläufe werden lokal gespeichert, um Privatsphäre zu schützen
* 📤 **Konversationen exportieren** – Unterstützung für Export in mehreren Formaten
* 🎨 **Klares Interface** – einfache und schöne Benutzeroberfläche
* 🔒 **Open Source & kostenlos** – vollständig quelloffen und kostenlos
* 🌍 **Plattformübergreifend** – unterstützt Windows, macOS, Linux
* 🚀 **Hervorragende Leistung** – leichtgewichtige Anwendung, läuft flüssig

## Support & Hilfe

Wenn Sie auf Probleme stoßen:

* 📚 [GccAi-Dokumentation](https://gccai.heqingsong.uk)
* 📚 [ChatBox GitHub](https://github.com/Bin-Huang/chatbox)
* 💬 [Discord-Community](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @GccAi\_](https://x.com/GccAi_)
* 📧 Technischer Support: [zhihong@gccai.heqingsong.uk](mailto:zhihong@gccai.heqingsong.uk)

***

<Card title="GccAi jetzt nutzen" icon="rocket" href="https://gccai.heqingsong.uk">
  Registrieren Sie sich jetzt bei GccAi, holen Sie sich Ihren API-Schlüssel und starten Sie Ihre KI-Reise in ChatBox!
</Card>