# Dashboard-Handbuch

Melden Sie sich auf [qcode.cc](https://qcode.cc) an und öffnen Sie die Konsole auf
[qcode.cc/dashboard](https://qcode.cc/dashboard). Die Konsole beschreibt sich selbst in einem Satz —
*„Verwalten Sie Ihre API-Keys, Aufladung und Nutzung“* — und besteht aus einer einzigen Seite: Keys,
Guthaben, Pläne, Nutzung, Empfehlungsprämien und Support befinden sich alle darauf.

> Nicht sicher, was ein QCode-Key im Vergleich zu einem Claude-/ChatGPT-Abo ist? Lesen Sie zuerst
> [Abos vs. API-Keys vs. QCode-Keys](/docs/reference/subscription-vs-api-key).
> Außerhalb Festland-Chinas? Beginnen Sie mit [QCode für Nutzer außerhalb Festland-Chinas](/docs/getting-started/international-users).

## Inhalt der Konsole

| Block | Was Sie dort tun |
|---|---|
| Benutzerleiste (oben rechts) | Ihre Anmelde-E-Mail und `ID: …`, das Guthaben in beiden Währungen sowie die Schaltflächen **Recharge** / **Buy Plan** einsehen |
| API Access Address | Die Adresse kopieren, die in `ANTHROPIC_BASE_URL` / `base_url` eingetragen wird |
| API Key Management | Einen Key erstellen, dessen Wert anzeigen und kopieren, erneuern, abgelaufene Keys aufklappen |
| One-Click Setup (in jeder Key-Karte) | Den Installationsbefehl für Claude Code oder Codex kopieren |
| Open API | Das schreibgeschützte Access-Token verwalten, das Ablaufdatum und Nutzung Ihrer Keys meldet |
| Usage Statistics | Kontingentverbrauch pro aktivem Key sowie monatliche Gesamtsummen |
| Docs & Resources | IDE-Integrationen und beliebte Anleitungen |
| Service Guide / Referral Rewards / Quick Links | Betriebsregeln, Ihr Empfehlungslink, Prämienabholung, Hilfeartikel, Fehlercodes, Servicezeiten |

## API Access Address

Der Block trägt den Titel **API Access Address**, und jede Zeile verfügt über eine eigene Kopierschaltfläche. **Welche Zeile als empfohlen hervorgehoben ist, hängt von der Sprache der Konsole ab, in der Sie angemeldet sind**:

- **Chinesische Oberfläche** — `https://asia.qcode.cc/api` wird als empfohlene Zeile hervorgehoben, und der Hinweis *„Nutzer in Festland-China sollten die beschleunigte Adresse verwenden; andere nutzen die globale Adresse. Beide bieten identische Leistung“* wird darunter angezeigt.
- **Alle nicht-chinesischen Oberflächen** (derzeit Englisch, Japanisch, Russisch) — `https://api.qcode.cc` wird hervorgehoben, und die Zeilen darunter sind mit **Backup** beschriftet (USA: `https://us.qcode.cc/api`, Asien: `https://asia.qcode.cc/api`).

Die kopierte Adresse muss weiterhin den richtigen **Pfad-Präfix** für das von Ihnen verwendete Tool tragen — siehe
[Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths). Für Claude Code sieht das Paar folgendermaßen aus:

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

## API-Keys: erstellen, anzeigen und kopieren

**API Key Management** ist der Block mit der Schaltfläche **Create Key & Activate Service**. Falls Sie noch keinen Key besitzen, zeigt der Leerzustand die Reihenfolge der Schritte auf: **Top Up Balance** → **Buy a Plan** → **Start Using**.

1. Aufladen auf [qcode.cc/recharge](https://qcode.cc/recharge) (siehe
   [Zahlungsübersicht](/docs/reference/payment-methods)).
2. Einen Plan auf [qcode.cc/subscribe](https://qcode.cc/subscribe) auswählen — entweder **Recommended Plans**
   oder **Custom Configuration** — und bestätigen. Ein erfolgreicher Kauf zeigt den Hinweis
   *„Subscription Activated — Your API Key is created and ready to use“* an und stellt den Key mit einer Kopierschaltfläche und einem Link **Go to Dashboard** dar.
3. Zurück in der Konsole wird der Key-Wert **standardmäßig nicht angezeigt**: Die Zeile zeigt *Loading…*
   an, bis Sie auf das Auge-Symbol klicken, um ihn sichtbar zu machen, anschließend auf **Copy**. Falls Sie kopieren, bevor der Wert geladen wurde, teilt Ihnen die Konsole dies mit, anstatt eine leere Zeichenfolge zu kopieren.

Weitere Elemente im selben Block:

- Ein gerade bestellter Key kann *„API key is being activated, we will process it as soon as
  possible"* anzeigen, mit einem Link zum Online-Support.
- Ein bereits vorhandener Key kann eine **Renew**-Schaltfläche anzeigen (eine schnelle Verlängerung, die von Ihrem Guthaben bezahlt wird).
- Aufgebrauchte Keys erscheinen unter der eingeklappten Liste **Expired keys**, markiert mit
  *Key expired or disabled*.
- Jede Karte verlinkt die drei Clients, denen ein Key dient: Claude, Codex und Gemini.
## One-Click-Setup-Befehle

Jede aktive API-Key-Karte enthält einen Block **One-Click Setup (Empfohlen)** mit einem
**macOS / Linux**- und einem **Windows**-Tab, jeweils eine Befehlszeile für Claude Code und eine für
Codex, jede mit eigenem **Kopieren**-Button:

```bash
curl -fsSL https://qcode.cc/install/claude-code.sh | bash
curl -fsSL https://qcode.cc/install/codex.sh | bash
```

Der Hinweis der Konsole unter dem Block: *„Fügen Sie Ihren API-Key oben ein, wenn das Skript danach
fragt."* Auf dem Windows-Tab sind die Befehle die `irm … | iex`-Entsprechungen, und ein darunter
eingeklappter Abschnitt ergänzt eine CMD-Einzelzeile sowie einen herunterladbaren Launcher für
Rechner, auf denen `irm` nicht verfügbar oder durch die Ausführungsrichtlinie blockiert ist. Die
vollständige Anleitung, einschließlich der Methode, die Oberflächensprache des Skripts zu erzwingen,
finden Sie im [One-Click-Setup-Skript](/docs/getting-started/one-click-install).

## Nutzungsstatistik

Der Block **Nutzungsstatistik** ist auf Ihren aktiven API-Key bezogen (*„Kontingentnutzung des
aktuellen aktiven Keys"*) und kann automatisch auf einem Timer (Aus / 5 / 10 / 30 / 60 Minuten)
oder manuell per **Aktualisieren** aktualisiert werden.

| Abschnitt | Was er berichtet |
|---|---|
| Tägliches Kostenlimit | Die maximalen Ausgaben pro Tag; wird um Mitternacht Pekinger Zeit zurückgesetzt, und die API pausiert bei Erreichen und setzt am nächsten Tag wieder ein |
| Zeitfensterlimit | Anzahl der Anfragen und Kosten innerhalb eines rollenden 4-Stunden-Fensters. Persönliche Tarife *„haben das 4h-Rate-Fenster im Juli 2026 vollständig entfernt – nur das tägliche Limit bleibt“*, daher kann dieser Abschnitt *Kein Fensterlimit* anzeigen |
| Opus-Wochenlimit | Ein separates Wochenkontingent für die Opus-Stufe, es wird jeden Montag (Pekinger Zeit) zurückgesetzt; Tarife ohne Opus-Zugang weisen hier darauf hin |
| Monatliche Nutzungsübersicht | Gesamt-Tokens, Gesamt-Requests, Gesamtkosten – gezählt ab dem Tag der API-Key-Erstellung |
| Heutige Modellaufrufe | Pro Modell Input- / Output- / Cache-Write- / Cache-Read-Tokens für den aktuellen Tag |
| Booster | Ob ein Booster-Paket aktiv ist; siehe unten |

Der Haftungsausschluss des Panels selbst: *„Die hier angezeigten Daten können leicht abweichen,
tatsächliche Limits basieren auf Claude-Code-Antworten."* Für einen groben
Sitzungs-Kostenwert nutzen Sie `/cost` innerhalb von Claude Code, und zur Berechnung der Kosten
siehe [Abrechnungsbeschreibung](/docs/reference/billing).

## Aufladung, Tarife, Booster und Upgrades

- **Das Guthaben ist pro Währung getrennt.** *„CNY- und USD-Guthaben sind getrennt. Der
  Aufladebetrag wird dem entsprechenden Währungsguthaben gutgeschrieben."* Die
  Benutzerleiste zeigt beide Beträge nebeneinander an.
- **Aufladelimits** auf der Aufladeseite: Minimum **¥100** für CNY, Minimum **$1** und
  Maximum **$2,000** für USD, zusätzlich pro Methode Limits, die die Seite erklärt, wenn Sie sie
  erreichen.
- **Nach einer Aufladung zurückkehren**: Der Banner der Konsole lautet *„Guthaben erhalten –
  Sie können jetzt einen Tarif aktivieren."* mit einem **Tarif auswählen**-Button.
  Ein Restbetrag geht nicht verloren – *„Ein Guthaben, das nach Ihrer Aufladung übrig bleibt,
  ist nicht verloren: Nutzen Sie es später für ein Upgrade oder ein Booster-Paket."*
- **Monatsweise Mehrfachbuchung** ist rabattiert: *„Abonnieren Sie 3+ Monate für bis zu 25 %
  Rabatt (12 Monate)."*
- **Booster-Pakete** (*Selbstbedienungs-Booster-Paket*) können mit Guthaben aus der Konsole
  gekauft werden und erweitern Ihr Kontingent sofort; sie setzen um 2 Uhr Pekinger Zeit (UTC+8)
  zurück.
- **Upgrades** sind kein Konsolen-Button: Kaufen Sie zuerst den höheren Tarif, schreiben Sie dann
  an [hi@qcode.cc](mailto:hi@qcode.cc), damit der alte geschlossen und sein ungenutzter Wert
  Ihrem Guthaben gutgeschrieben wird.

## Sub-Keys und Team-Funktionen

Die persönliche Konsole verwaltet **einen Haupt-Key pro Tarif** – es gibt keine
Self-Service-Oberfläche für Sub-Keys. Sub-Keys sind Teil der Team-Produkte:

- Die Seite **Enterprise Team Edition** beschreibt ein *Sub-API-Key-Management-Center* mit
  *„detaillierter Konfiguration und Verwaltung für jedes Teammitglied“*, und die
  Tarifvergleichstabelle listet *unbegrenzte Sub-Keys, jeder mit eigenem Kontingent* auf.
  Diese Edition listet außerdem **Banküberweisung möglich**, **Offizielle Rechnungen verfügbar**
  und **Individuelle Serviceverträge**. Schritte: [Enterprise-Team-Leitfaden](/docs/reference/enterprise-guide).
- Auf der Abonnierungsseite wirbt die Team-Karte mit *„Flexibles Kontingent & Sub-Key-Verwaltung“*
  und verweist auf [hi@qcode.cc](mailto:hi@qcode.cc).
- Die Konsole selbst bietet nur **Orientierung** für Teams – einen Eintrag **Team / Enterprise**
  im Willkommensdialog und einen *Team-Funktionen*-Dialog für die Max-X20-Team-Edition
  („Multi-Account-Verwaltung für Teamzusammenarbeit“, „Individueller Service…“,
  „Dedizierter technischer Support…“).
- **Reseller** erhalten ein separates Partner-Dashboard mit Sub-Key-Ausstellung, behandelt im
  [Partner-Open-API-Leitfaden](/docs/reference/partner-api).

## Open-API-Zugangs-Token

Die Karte **Open API** sagt: *„Verwenden Sie ein Zugangs-Token, um Ablaufdatum und tägliche Nutzung Ihrer API-Keys programmatisch abzufragen.“* **Token verwalten** öffnet `/dashboard/openapi-token`, wo Sie das Token generieren, zurücksetzen oder widerrufen können:

```bash
curl -H "Authorization: Bearer qot_..." \
  https://qcode.cc/api/v1/openapi/keys
```

- Auf dieser Seite sind zwei schreibgeschützte Endpunkte aufgeführt: einer für Ablaufdatum und Nutzung all Ihrer aktiven Keys, einer für die Nutzungsübersicht auf Kontoebene.
- Das Token wird **einmal** angezeigt: *„Ihr neues Token (wird nur einmal angezeigt) — kopieren Sie es jetzt“*, und *„Wir speichern nur einen Hash — falls Sie es verlieren, setzen Sie es zurück, um ein neues zu erhalten (das alte Token funktioniert sofort nicht mehr).“*
- Beim Zurücksetzen und Widerrufen wird jeweils eine Bestätigung angefordert, und ein Widerruf deaktiviert den Open-API-Zugriff, bis Sie ein neues Token generieren.

## Support und Bestellfragen

- Die **Support**-Zeile der Konsole: *„Werktags 10:00 - 21:00 (UTC+8) Online-Betreuung“*, mit den Hinweisen *„außerhalb der Geschäftszeiten werden Nachrichten in unregelmäßigen Abständen geprüft, Antworten können sich verzögern“* und *„E-Mail jederzeit verfügbar: hi@qcode.cc“*.
- Live-Support ist die Schaltfläche **Kontakt** unten rechts (Telegram oder E-Mail).
- **Dringende Bearbeitung anfragen** erläutert die Wartezeit: Neue Anbieterkonten erfordern innerhalb der Geschäftszeiten ein bis zwei Stunden für Beantragung und Konfiguration.
- Unter **Quick Links** finden Sie außerdem **Nutzungshilfe** (die Wissensdatenbank) und **Häufige Fehlercodes**; für Symptome und Lösungen siehe [Fehlerbehebungsleitfaden](/docs/reference/troubleshooting) und [Fehlercode-Referenz](/docs/reference/errors).

## Verwandte Seiten

- [Übersicht der Zahlungsmethoden](/docs/reference/payment-methods) — welche Kanäle die Aufladung unterstützt
- [Abrechnungsbeschreibung](/docs/reference/billing) — wie Nutzung in Beträge umgewandelt wird
- [Endpunkte & API-Pfade](/docs/getting-started/endpoints-and-api-paths) — Adresse und Pfadpräfix
- [Umgebungsvariablen](/docs/getting-started/environment) — wo sie gesetzt werden
- [One-Click-Setup-Skript](/docs/getting-started/one-click-install) — was die Konsolenbefehle tun
- [Abos vs. API-Keys vs. QCode-Keys](/docs/reference/subscription-vs-api-key)
- [Enterprise-Team-Leitfaden](/docs/reference/enterprise-guide) — Sub-Keys und Rechnungsstellung
- [Partner-Open-API-Leitfaden](/docs/reference/partner-api)
- [FAQ](/docs/reference/faq)