> ## 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 Cursor verwenden
> Ausführliche Anleitung zur Konfiguration und Nutzung des GccAi-API-Dienstes im KI-Code-Editor Cursor. Diese Anleitung hilft Ihnen, GccAi in Cursor einzurichten, um auf zahlreiche KI-Modelle für die Code-Entwicklung zuzugreifen.
## Voraussetzungen
Bevor Sie beginnen, stellen Sie sicher:
1. **Cursor ist installiert**\
Laden Sie die für Ihr Betriebssystem passende Version von der [Cursor-Website](https://cursor.sh/) herunter
2. **Sie haben einen GccAi-API-Schlüssel**\
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.
## Schritt 1: Cursor-Einstellungen öffnen
Nach dem Start von Cursor öffnen Sie die Einstellungen:
1. Klicken Sie auf das **⚙️ Settings**-Symbol (Zahnrad) oben rechts
2. Oder verwenden Sie Tastenkürzel:
* Windows/Linux: `Ctrl+Shift+J`
* macOS: `Cmd+Shift+J`
*Cursor-Hauptoberfläche — Einstellungen über das Zahnrad oben rechts öffnen*
## Schritt 2: Modelleinstellungen konfigurieren
### 2.1 Modelleinstellungen öffnen
In den Einstellungen:
1. Suchen Sie **Models** in der linken Seitenleiste
2. Öffnen Sie die Seite der Modelleinstellungen
*Finden Sie „Models" in der linken Seitenleiste*
### 2.2 OpenAI-API-Schlüssel verwenden
Auf der Modelleinstellungsseite:
1. Suchen Sie den Abschnitt **OpenAI API Key**
2. Klicken Sie auf **Add new** oder **Override OpenAI Base URL**
> [!NOTE]
>
> **Wichtig:** Cursor unterstützt OpenAI-kompatible APIs, daher kann GccAi als benutzerdefinierter Anbieter konfiguriert werden.
### 2.3 GccAi konfigurieren
Geben Sie Folgendes ein:
| Einstellung | Wert |
| - | - |
| **API Key** | Ihr GccAi-API-Schlüssel (`sk-xxxxxxxxxxxx`) |
| **Base URL** | `https://gccai.heqingsong.uk/v1` |
> [!NOTE]
>
> **Wichtig:** - Base URL muss das `/v1`-Suffix enthalten: `https://gccai.heqingsong.uk/v1` - Der API-Schlüssel muss der `sk-...`-Schlüssel aus der GccAi-Konsole sein - Nach dem Speichern verwendet Cursor GccAi-Modelle für Vervollständigung und Chat
*API-Schlüssel und Base URL eingeben*
## Schritt 3: Modelle auswählen
### 3.1 Modellauswahl
In den Modelleinstellungen können Sie wählen, welche Modelle verwendet werden sollen.
**Verfügbare Familien:**
* **GPT-4/5** — stark bei komplexer Codegenerierung und Q\&A
* `gpt-5` — neuestes GPT-5
* `gpt-4o` — GPT-4o
* `gpt-4o-mini` — schneller, kostengünstiger
* **Claude** — stark beim Verstehen und Refactoring
* `claude-sonnet-4-5-20250929` — Claude Sonnet 4.5
* `claude-haiku-4-5-20251001` — Claude Haiku 4.5
* **Andere**
* `gemini-2.0-flash-exp` — Google Gemini 2.0 Flash
> [!TIP]
>
> **Empfehlungen:** - 💰 **Vervollständigung (kosteneffizient):** `gpt-4o-mini` - 🚀 **Anspruchsvolle Aufgaben (Leistung):** `gpt-5`, `gpt-4o`, `claude-sonnet-4-5-20250929` - ⚡ **Niedrige Latenz:** `gpt-4o-mini`, `gemini-2.0-flash-exp`
### 3.2 Modelle pro Funktion
Sie können verschiedene Modelle pro Funktion wählen:
* **Chat** — Konversationen mit der KI
* **Autocomplete** — Inline-Vorschläge
* **Cmd+K** — schnelle Bearbeitung / Generierung
Wählen Sie das passendste Modell für jeden Workflow.
## Schritt 4: Loslegen
Nach der Konfiguration können Sie die KI-Funktionen von Cursor nutzen.
### 4.1 AI Chat (`Cmd+L` / `Ctrl+L`)
1. Drücken Sie `Cmd+L` (macOS) oder `Ctrl+L` (Windows/Linux)
2. Stellen Sie eine Frage oder geben Sie eine Aufgabe, z. B.:
* „Wie implementiere ich Quicksort?"
* „Hilf mir, die Leistung dieses Codes zu optimieren"
* „Erkläre, wie diese Funktion arbeitet"
*Chat mit dem Assistenten*
### 4.2 Code-Vervollständigung
1. Tippen Sie wie gewohnt im Editor
2. Cursor schlägt Vervollständigungen vor
3. Drücken Sie `Tab`, um anzunehmen
*Beispiel für Inline-Vervollständigung*
### 4.3 Schnellbearbeitung (`Cmd+K` / `Ctrl+K`)
1. Code auswählen
2. `Cmd+K` (macOS) oder `Ctrl+K` (Windows/Linux) drücken
3. Bearbeitung beschreiben, z. B.:
* „Fehlerbehandlung hinzufügen"
* „Diese Funktion refactoren"
* „Typannotationen hinzufügen"
*Schnellbearbeitung mit Cmd+K*
### 4.4 Code erklären
1. Code auswählen
2. Rechtsklick → **Explain with AI** (oder Tastenkürzel)
3. Die KI erklärt Verhalten und Logik
## FAQ
### Q1: GccAi nicht erreichbar?
**Versuchen Sie:**
1. **Base URL** — muss exakt `https://gccai.heqingsong.uk/v1` sein
2. **API-Schlüssel** — gültiger `sk-...`-Schlüssel aus der [Konsole](https://gccai.heqingsong.uk/keys)
3. **Netzwerk** — stellen Sie sicher, dass `https://gccai.heqingsong.uk` erreichbar ist; in einigen Regionen kann ein Proxy erforderlich sein
### Q2: Langsame Antworten?
**Versuchen Sie:**
1. Verwenden Sie ein leichteres Modell (`gpt-4o-mini` statt `gpt-4o` oder `gemini-2.0-flash-exp`)
2. Kontext kürzen — weniger Code senden, präzisere Fragen stellen
3. Latenz / Proxy bei Bedarf prüfen
### Q3: API-Fehler?
| Meldung | Wahrscheinliche Ursache | Was tun |
| - | - | - |
| `401 Unauthorized` | Ungültiger oder abgelaufener Schlüssel | Schlüssel neu erstellen und in Cursor aktualisieren |
| `429 Too Many Requests` | Rate-Limit | Warten und erneut versuchen |
| `500 Internal Server Error` | Vorübergehendes Serverproblem | Später erneut versuchen |
| `insufficient_quota` | Geringes Guthaben | In der Konsole aufladen |
### Q4: Nutzung und Abrechnung?
Öffnen Sie die [GccAi-Konsole](https://gccai.heqingsong.uk/overview):
* 📊 Aufrufstatistiken
* 💰 Kostenaufschlüsselung
* 📈 Nutzungstrends
* 🔍 Anfrageprotokolle
## Tipps
### 1. Kontext nutzen
* Verwandte Dateien öffnen
* Dateien mit `@filename` referenzieren
* Ordner mit `@folder` referenzieren
### 2. Klare Prompts
**❌ Schwach:**
```
optimize this
```
**✅ Stark:**
```
Optimize this function for performance:
1. Reduce nested loops
2. Prefer more efficient data structures
3. Add caching where helpful
```
### 3. Iterieren
Klein anfangen → verfeinern → testen → Prompts anpassen.
### 4. Projektregeln
Definieren Sie Stil, Benennung, Architektur und Tests in `.cursorrules`.
## Funktionen
Mit Cursor + GccAi:
* 💬 Chat zu Code-Fragen
* ⚡ Intelligente Vervollständigung
* ✏️ Bearbeitung in natürlicher Sprache
* 🔍 Tieferes Codeverständnis
* 🐛 Hilfe beim Debuggen
* 📝 Dokumentation und Kommentare
* 🔄 Refactoring
* 🧪 Test-Gerüste
## Support
* 📚 [GccAi-Dokumentation](https://gccai.heqingsong.uk)
* 💬 [Discord](https://discord.gg/V8zqssyZ5c)
* 🐦 [Twitter @GccAi\_](https://x.com/GccAi_)
* 📧 [zhihong@gccai.heqingsong.uk](mailto:zhihong@gccai.heqingsong.uk)
***
> **[Mit GccAi loslegen](https://gccai.heqingsong.uk)**
>
> Registrieren, API-Schlüssel holen und mit Cursor schneller liefern!
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.