Häufige Fragen (FAQ)

Häufig gestellte Fragen zu Claude Code und QCode.cc

Brauchen Sie einen API-Key? Registrieren →·Endpunkte & Base-URLs →

QCode.cc-Plattform¶

Q: Wo erhalte ich meinen API-Key?¶

A: Melden Sie sich im 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
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_): Sie können ihn in der Konsole selbst zurücksetzen – auf der Key-Karte rechts in der Zeile «API Key:» auf «⋯» klicken → «API-Key zurücksetzen…». Es wird ein neuer Key erzeugt, der alte wird innerhalb von 1 Minute ungültig; Kontingent, Verbrauch und Ablaufdatum bleiben gleich. Jedes Zurücksetzen kostet eine kleine Gebühr (der Betrag wird in der Konsole angezeigt), und jeder Key kann höchstens einmal alle 3 Tage zurückgesetzt werden. Wenn Sie den Key nur vergessen haben, ist kein Zurücksetzen nötig – klicken Sie auf das 👁-Symbol daneben. Einige Keys können nur mit Hilfe des Live-Chats oder über hi@qcode.cc zurückgesetzt werden. Befolgen Sie außerdem die Sicherheits-Bewährte-Praktiken, um zu prüfen, ob der Schlüssel in Ihren Git-Verlauf oder Logs gelangt ist.
• Open-API-Zugriffstoken (beginnt mit qot_, persönlich): schreibgeschützt, erzeugt in der Konsole unter Open API (/dashboard/openapi-token); dort setzen Sie es auch zurück oder widerrufen es. Das alte Token wird sofort ungültig. Siehe Dashboard-Leitfaden.
• Partner-Zugriffstoken (beginnt mit rsk_, nur für Reseller): wird im Partner-Dashboard unter «Open API / Access Token» erzeugt, nicht in der persönlichen Konsole. Klicken Sie dort auf Reset. Das alte Token wird sofort ungültig. Siehe Partner Open API.

Nutzung & Tarife¶

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

A: Zwei Möglichkeiten:

Dashboard (empfohlen): Melden Sie sich im 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:

/cost

Die Dashboard-Abrechnung basiert auf der qcode.cc/models-Preistabelle, die genauer ist als die Anzeige in der CLI.

Q: Gibt es eine monatliche Kontingentgrenze bei Ultimate und dem Team-Tarif?¶

A: Ja. Jeder Ultimate-Tarif und jede Einheit des Team-Tarifs hat eine Obergrenze von $4,000 pro Monat (monatlicher Reset, ungenutztes Kontingent wird nicht in den nächsten Monat übertragen). Die überwiegende Mehrheit der Nutzer erreicht diese Grenze nie. 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:

• Privatpläne: 5 gleichzeitige Anfragen pro API-Key; Ultimate: 10 gleichzeitige Anfragen pro API-Key
• Nutzungspakete: 5 gleichzeitige Anfragen pro API-Key
• Team-Tarif: 35 gleichzeitige Anfragen pro Einheit, empfohlen 3–5 Nutzer pro Einheit

4-Stunden-Zeitfenster-Limit:

• Privatpläne: vollständig entfernt seit Juli 2026 — keinerlei Zeitfenster-Limit; es gilt Ihr Tageslimit (Reset um 00:00 Uhr Peking-Zeit), bei Ultimate das Monatskontingent
• Team-Tarif: 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 ($9/mo). Sobald Sie bereit sind, kaufen Sie einen Tarif mit höherem Kontingent und senden Sie eine E-Mail an 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: Was unterscheidet ein Nutzungspaket von einem Privatplan?¶

A: Ein Privatplan hat ein Tageskontingent, das um 00:00 Uhr Pekinger Zeit zurückgesetzt wird und zur täglichen Nutzung passt; ein Paket ist ein Gesamtkontingent für seine Laufzeit (Kleinpaket / Mittelpaket / Großpaket / XL-Paket, alle 7 Tage), das bis zum Ende verbraucht wird und zu Nutzungsphasen passt. Der Key wird gleich verwendet, die Parallelität beträgt 5, und die Modelle sind dieselben. Solange Sie einen aktiven Privatplan haben, können Sie kein Paket kaufen (reicht das Tageskontingent des Privatplans nicht, nutzen Sie ein Booster-Paket). Den vollständigen Vergleich finden Sie unter Den passenden Tarif wählen, die Regeln unter Nutzungspakete.

Q: Was passiert, wenn das Kontingent aufgebraucht ist?¶

A: Die Antwort ist HTTP 402 mit error.type = insufficient_quota, und code zeigt, um welches Kontingent es geht: daily_cost_limit_exceeded ist das Tageskontingent, das um 00:00 Uhr Pekinger Zeit zurückgesetzt wird (auch ein Booster-Paket hilft); total_cost_limit_exceeded ist ein Gesamtkontingent (Nutzungspakete, Ultimate-Monatskontingent), bei einem Paket kaufen Sie einfach nach; auch das Wochenlimit für Claude-Modelle liefert 402. Ein abgelaufener Key liefert 401, nicht 402, und ein Nachkauf des Pakets stellt ihn wieder her. Siehe Fehlercode-Referenz.

Q: Sind Rückerstattungen möglich?¶

A: Wir verkaufen digitale Netzgüter. Nach Aktivierung sind die Ressourcen belegt, daher werden keine Rückerstattungen unterstützt. Auch Nutzungspakete sind nicht erstattungsfähig, und das Restkontingent verfällt nach Ablauf.

Die eine Ausnahme ist ein Upgrade: Nach dem Kauf eines Tarifs mit höherem Kontingent senden Sie eine E-Mail an 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 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.

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.

Q: Unterstützen Sie Firmenüberweisungen?¶

A: Der Team-Tarif unterstützt geschäftliche Banküberweisung und einen formellen Dienstleistungsvertrag. Siehe Leitfaden zum Team-Tarif.

Q: Ich habe daily_cost_limit_exceeded (HTTP 402) 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, 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 an.

Das kommt als HTTP 402 mit error.type = insufficient_quota und code = daily_cost_limit_exceeded (siehe Fehlercode-Referenz).

Das 4-Stunden-Gleitzeitfenster-Limit wurde im Juli 2026 von allen Privatplänen entfernt, daher kann diese Meldung nur vom Tageslimit stammen, nie von einem Zeitfenster-Limit.

Q: Was bedeutet total_cost_limit_exceeded („Gesamtkostenlimit“)?¶

A: Ihr Gesamtkontingent ist aufgebraucht: HTTP 402 mit error.type = insufficient_quota und code = total_cost_limit_exceeded. Das Gesamtkontingent gilt für Keys mit Abrechnung nach Gesamtkontingent, z. B. Nutzungspakete und das Monatskontingent des Ultimate-Tarifs. Der Betrag in Klammern in der Meldung (z. B. $100) ist das kumulierte Limit des Keys, nicht das Restguthaben.

Die Wiederherstellung richtet sich nach den Regeln Ihres Tarifs: Bei einem Paket genügt ein Nachkauf. Das Ultimate-Monatskontingent wird z. B. beim monatlichen Reset aufgefüllt. Ist es vor dem Reset aufgebraucht oder sind Sie unsicher, welcher Fall zutrifft, schreiben Sie an hi@qcode.cc oder nutzen Sie den Live-Chat. Ein solcher 402 verschwindet nicht durch erneutes Senden, eine Retry-Schleife ist also sinnlos. Siehe Fehlercode-Referenz.

Q: Sind Cloud-Server und AI-Service dasselbe? Brauche ich zusätzlich einen AI-Plan?¶

A: Es sind zwei getrennte Produkte, die unabhängig verkauft werden und nur das Kontoguthaben teilen. Ein Cloud-Server ist eine Maschine im Ausland mit eigener öffentlicher IPv4 und vollen root-Rechten, abgerechnet für die gewählte Laufzeit (1, 3, 6 oder 12 Monate); der AI-Service wird pro Token abgerechnet. Sie können einen Cloud-Server ohne jeden AI-Plan kaufen: Installieren Sie darauf Claude Code oder Codex und rufen Sie die Modelle mit Ihrem QCode-Key auf. Die Maschine auswählen: Cloud-Server: Auswahl, Kauf und Betrieb; die Regeln auf der Serverseite: Abrechnung und Regeln für Cloud-Server; Einrichtung und langlebig laufende Agenten: Agenten auf einem Cloud-Server betreiben.

Schnelle Referenz¶

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

A: Drei Schritte, etwa 60 Sekunden:

1. Key holen: Konsole aufrufen → „API-Key-Verwaltung“ und den Key kopieren, der mit cr_ beginnt.
2. Konfigurieren: das One-Click-Setup-Skript ausführen oder ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN manuell setzen (siehe Endpunkte & API-Formate).
3. Tool wählen: Ihre IDE oder CLI unter Tool verbinden 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:

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

Detaillierte Schritte (inklusive Anleitung für alle drei Plattformen) → Installationsanleitung

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

A: Setzen Sie folgende Umgebungsvariablen:

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

Q: Wie wechsle ich in den Plan Mode?¶

A: Shift+Tab so oft drücken, bis die Modusanzeige auf plan steht (dreimal vom standardmäßigen Auto-Modus, zweimal vom manuellen default-Modus). Sie können auch mit --permission-mode plan starten, oder den Standardmodus in .claude/settings.json setzen:

{ "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:

/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 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).

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.

Weitere Hilfe¶

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

Support kontaktieren: Live-Chat in der rechten unteren Ecke der Website verwenden, oder hi@qcode.cc schreiben.

Enterprise →