# FAQ

## QCode.cc-Plattform

### Q: Wo erhalte ich meinen API-Key?

**A:** Melden Sie sich im [QCode.cc-Dashboard](https://qcode.cc/dashboard) an und erstellen oder verwalten Sie Ihren API-Key auf der Seite „API Key Management“.

### Q: Welches Präfix verwendet der API-Key?

**A:** QCode.cc-API-Keys beginnen mit `cr_`, z. B. `cr_xxxxxxxxxxxxxx`.

### Q: Warum funktioniert mein API-Key nicht?

**A:** Häufige Ursachen:

1. **Kopierfehler**: Überprüfen Sie auf zusätzliche Leerzeichen oder fehlende Zeichen
2. **Abo abgelaufen**: Prüfen Sie Ihren Kontostatus im [Dashboard](https://qcode.cc/dashboard)
3. **Umgebungsvariable nicht übernommen**: Öffnen Sie Ihr Terminal erneut oder führen Sie `source ~/.zshrc` aus
4. **Falscher API-Endpunkt**: Stellen Sie sicher, dass `ANTHROPIC_BASE_URL` auf `https://api.qcode.cc/api` gesetzt ist

### Q: Mein API-Key ist durchgesickert — wie ersetze ich ihn?

**A:** Es hängt davon ab, welcher Schlüssel betroffen ist:

- **Haupt-API-Key (beginnt mit `cr_`)**: Eine Selbstbedienungs-Zurücksetzung ist derzeit nicht verfügbar. Kontaktieren Sie [Live-Chat](javascript:void(Tawk_API.toggle())) oder senden Sie eine E-Mail an [hi@qcode.cc](mailto:hi@qcode.cc), so bald wie möglich. Befolgen Sie außerdem die [Sicherheits-Bewährte-Praktiken](/docs/advanced/security), um zu prüfen, ob der Schlüssel in Ihren Git-Verlauf oder Logs gelangt ist.
- **Open-API-Zugriffstoken (beginnt mit `rsk_`, für Partner)**: Öffnen Sie «Open API / Access Token» in der Konsole und klicken Sie auf **Reset**. Das alte Token wird sofort ungültig. Siehe [Partner Open API](/docs/reference/partner-api).

---

## Nutzung & Tarife

### Q: Wie überprüfe ich meine aktuelle Sitzungsnutzung?

**A:** Zwei Möglichkeiten:

**Dashboard (empfohlen)**: Melden Sie sich im [Dashboard](https://qcode.cc/dashboard) an und sehen Sie Modellaufrufe, Kostenaufschlüsselung und Tarifverbrauch auf der Seite „Nutzungsstatistik“ ein.

**Schnellprüfung in der CLI**: Verwenden Sie den Befehl `/cost`, um eine Übersicht der aktuellen Sitzung anzuzeigen:
```text
/cost
```

> Die Dashboard-Abrechnung basiert auf der [qcode.cc/models-Preistabelle](https://qcode.cc/models), die genauer ist als die Anzeige in der CLI.

### Q: Gibt es eine Obergrenze für die Max-x20-Kontoresourcen bei Premium- und Enterprise-Team-Tarifen?

**A:** Ja. Jedes Max-x20-Konto hat eine Obergrenze von **$4,000** pro Monat (monatlicher Reset, ungenutztes Kontingent wird nicht in den nächsten Monat übertragen; der tatsächliche Verbrauch liegt typischerweise bei $3,500–$3,900). Wir planen über einen Kontoresourcen-Pool, sodass die überwiegende Mehrheit der Nutzer diese Grenze nie erreicht. Bei ungewöhnlich hohem Nutzungsbedarf wenden Sie sich bitte an den Support.

### Q: Wie hoch sind die Concurrent-Limits und Zeitfenster-Limits für jeden Tarif?

**A:**

**Concurrent-Limits:**
- Persönliche Tarife (Basic / Pro / Premium): **5 gleichzeitige** Anfragen pro API-Key
- Enterprise Team: **35 gleichzeitige** Anfragen pro Kontoresource, unterstützt 3–5 simultane Nutzer

**4-Stunden-Zeitfenster-Limit:**
- Persönliche Tarife: **vollständig entfernt seit Juli 2026** — keinerlei Zeitfenster-Limit
- Enterprise Team: **kein** Zeitfenster-Limit, unterstützt kontinuierliche Entwicklung

### Q: Ich bin mir unsicher, welchen Tarif ich wählen soll — kann ich upgraden, wenn ich zu klein anfange?

**A:** Ja. Wenn Sie unsicher sind, wie viel Kontingent Sie benötigen, beginnen Sie mit dem Starter-Tarif ($8.57/mo). Sobald Sie bereit sind, kaufen Sie einen Tarif mit höherem Kontingent und senden Sie eine E-Mail an [hi@qcode.cc](mailto:hi@qcode.cc), um den alten Tarif zu schließen — die nicht genutzte Zeit wird anteilig Ihrem QCode-Guthaben gutgeschrieben, Bearbeitung innerhalb von 1 Werktag. Teams und Reseller können die Integration zuerst auf Starter validieren und danach upgraden.

### Q: Sind Rückerstattungen möglich?

**A:** Wir verkaufen digitale Netzgüter. Nach Aktivierung sind die Kontoresourcen belegt, daher werden **keine Rückerstattungen unterstützt**.

**Die eine Ausnahme ist ein Upgrade**: Nach dem Kauf eines Tarifs mit höherem Kontingent senden Sie eine E-Mail an [hi@qcode.cc](mailto:hi@qcode.cc), und die nicht genutzte Zeit des alten Tarifs wird anteilig Ihrem QCode-Guthaben gutgeschrieben (auf Ihr Guthaben, nicht auf das ursprüngliche Zahlungsmittel).

**Alternative Guthabenübertragung**: Übertragungen zwischen QCode-Mitgliedern werden unterstützt. Sobald Sie einen Käufer gefunden haben, senden Sie eine E-Mail an [hi@qcode.cc](mailto:hi@qcode.cc) mit dem Überweisungsbetrag und der E-Mail-Adresse des QCode-Kontos des Empfängers. Übertragungen werden innerhalb von 1 Werktag abgeschlossen.

Rückerstattungen können nur in folgenden Fällen nach Einzelfallprüfung gewährt werden: eine Plattformstörung mit mehr als 24 Stunden Dienstunterbrechung; die Plattform beendet den Dienst einseitig, während ein Guthaben besteht; oder eine fehlerhafte Aufladung wird innerhalb von 24 Stunden gemeldet, ohne dass eine Nutzung stattgefunden hat.

### Q: Ich habe ein Claude-Pro- / ChatGPT-Plus-Abo — kann ich es mit QCode nutzen?

**A:** Nein. Ein Abo ist die Mitgliedschaft in den offiziellen Apps und umfasst kein API-Kontingent; QCode rechnet pro Token ab. Die beiden Systeme sind unabhängig und können parallel bestehen — Details in [Abos vs. API-Keys vs. QCode-Keys](/docs/reference/subscription-vs-api-key).

### Q: Welche Tools werden unterstützt?

**A:** Claude Code, Codex, IDE-/CLI-Erweiterungen und Desktop-Clients haben alle Einrichtungsseiten unter „Verbinden Sie Ihr Tool“; welches Protokoll jedes Tool spricht und ob Claude-Modelle damit funktionieren, erfahren Sie in der [Tool-Kompatibilitätsübersicht](/docs/ide/tool-compatibility).

### Q: Kann ich eine Rechnung erhalten (für die Spesenabrechnung)?

**A:** Ja, Rechnungen können für die betriebliche Spesenabrechnung verwendet werden. Es fällt eine Verwaltungsgebühr an: **¥80 bei einem Nennwert unter ¥2,000**, oder **5 % des Nennwerts über ¥2,000**. Stellen Sie sicher, dass Ihr Kontoguthaben dies abdeckt, und senden Sie dann eine E-Mail an [hi@qcode.cc](mailto:hi@qcode.cc).

Der Enterprise-Team-Tarif unterstützt zusätzlich **geschäftliche Banküberweisung** und **offizielle MwSt.-Rechnungen** mit einem formellen Dienstleistungsvertrag. Siehe [Enterprise-Leitfaden](/docs/reference/enterprise-guide).

### Q: Ich habe „daily cost limit reached“ erhalten — was nun?

**A:** Das Tageslimit ist die **Obergrenze für API-Ausgaben pro Tag** und wird um **00:00 Pekinger Zeit** zurückgesetzt. Zwei Lösungen:

1. **Booster-Pack kaufen**: Kaufen Sie es selbst in der [Konsole](https://qcode.cc/dashboard), um das heutige Kontingent sofort zu erweitern. Booster-Packs werden separat um **02:00 Pekinger Zeit am nächsten Tag** zurückgesetzt — zwei Stunden nach dem Tageslimit, was einen Puffer lässt, wenn Sie nach Mitternacht arbeiten.
2. **Tageslimit erhöhen**: Passen Sie Ihren Tarif unter [qcode.cc/pricing](https://qcode.cc/pricing) an.

> Das 4-Stunden-Gleitzeitfenster-Limit wurde im Juli 2026 von allen persönlichen Tarifen entfernt, daher kann diese Meldung nur vom Tageslimit stammen, nie von einem Zeitfenster-Limit.

---

## Schnelle Referenz

### Q: Ich habe gerade einen Plan gekauft – wie fange ich an?

**A:** Drei Schritte, etwa 60 Sekunden:

1. **Key holen**: [Konsole](https://qcode.cc/dashboard) aufrufen → „API-Key-Verwaltung“ und den Key kopieren, der mit `cr_` beginnt.
2. **Konfigurieren**: das [One-Click-Setup-Skript](/docs/getting-started/one-click-install) ausführen oder `ANTHROPIC_BASE_URL` und `ANTHROPIC_AUTH_TOKEN` manuell setzen (siehe [Endpunkte & API-Formate](/docs/getting-started/endpoints-and-api-paths)).
3. **Tool wählen**: Ihre IDE oder CLI unter [Tool verbinden](/docs/ide) finden und der Anleitung auf der Seite folgen.

Ein Key steuert Claude Code, Codex, Gemini und die chinesischen Modelle gleichzeitig – alle teilen dasselbe Plan-Kontingent.

### Q: Wie installiere ich Claude Code?

**A:** Global über npm installieren und dann die Umgebungsvariablen konfigurieren:

```bash
npm install -g @anthropic-ai/claude-code
```

Detaillierte Schritte (inklusive Anleitung für alle drei Plattformen) → [Installationsanleitung](/docs/getting-started/installation)

### Q: Wie konfiguriere ich den QCode.cc-Proxy?

**A:** Setzen Sie folgende Umgebungsvariablen:

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_api_key"
```

Empfehlung: diese in die Shell-Konfigurationsdatei (`~/.zshrc` oder `~/.bashrc`) aufnehmen. Siehe → [Installationsanleitung](/docs/getting-started/installation)

### Q: Wie wechsle ich in den Plan Mode?

**A:** `Shift+Tab` zweimal drücken, oder den Standardmodus in `.claude/settings.json` setzen:

```json
{ "permissions": { "defaultMode": "plan" } }
```

Im Plan Mode analysiert Claude Ihre Anfrage, führt aber keine Aktionen aus.

### Q: Wie wechsle ich das Modell?

**A:** Den Befehl `/model` verwenden:

```text
/model opus
/model sonnet
```

### Q: Wie lasse ich Claude Code committen oder reviewen?

**A:** `/commit` erzeugt einen Commit, `/review` führt ein Code-Review durch. Sie können Claude auch direkt anweisen: „committe diese Änderungen“ oder „reviewe diesen PR“.

### Q: Wie melde ich einen Bug?

**A:** Rufen Sie [GitHub Issues](https://github.com/anthropics/claude-code/issues) auf und stellen Sie Reproduktionsschritte sowie relevante Fehlerinformationen bereit.

### Q: Kann Claude Bilder generieren?

**A:** Claude-Modelle können **Bilder lesen, aber nicht generieren** (zum Bild-Input siehe [Bild-Input](/docs/usage/vision-input)).

Zur Bildgenerierung `gpt-image-2` verwenden – der bestehende `cr_`-Key wird geteilt, das Modell ist vollständig OpenAI-kompatibel und unterstützt Text-zu-Bild sowie Bildbearbeitung. Siehe [gpt-image-2 Bildgenerierung und -bearbeitung](/docs/usage/image-2).

---

## Weitere Hilfe

Nicht gefunden, was Sie suchen? Prüfen Sie diese themenspezifischen Dokumente:

| Thema | Dokumentation |
|------|---------|
| Kontextverwaltung, /compact, Überlauf bei langen Sessions | [Kontextverwaltung](/docs/usage/context-management) |
| Berechtigungskonfiguration, Allow-/Deny-Regeln | [Berechtigungen](/docs/usage/permissions) |
| CLAUDE.md-Projektkonfiguration | [CLAUDE.md-Konfiguration](/docs/usage/claude-md) |
| MCP-Server-Konfiguration und Debugging | [MCP-Server](/docs/advanced/mcp) |
| Fehlercodes und Problembehandlung | [Fehlercodes](/docs/reference/errors) |
| Abrechnungsmechanik und Preise | [Abrechnung](/docs/reference/billing) |

**Support kontaktieren**: Live-Chat in der rechten unteren Ecke der Website verwenden, oder [hi@qcode.cc](mailto:hi@qcode.cc) schreiben.