Crush-Einrichtung

QCode.cc als benutzerdefinierten Anbieter in Charm Crush hinzufügen: type=anthropic und base_url in crush.json – Claude im Terminal nutzen

Zuletzt überprüft: 2026-09-18 · 📄 Laut offizieller Dokumentation (Crush v0.95.0, veröffentlicht 2026-09-16)

Auf einen Blick¶

Hinweis zur Namensgebung: Das Repository hieß ursprünglich charmbracelet/opencode und heißt nun crush (die alte URL leitet per 301 weiter; der Grund wurde vom Upstream nie genannt). Es handelt sich um ein anderes Projekt als OpenCode (opencode.ai) – beachten Sie außerdem, dass Crush auch einen integrierten Modell-Upstream namens opencode mitbringt, noch eine weitere Charm-Komponente, die nicht verwechselt werden sollte.

Welches Protokoll¶

Crush benutzerdefinierte Anbieter akzeptieren anthropic und openai-compat als type. Für Claude verwenden Sie anthropic – der OpenAI-Endpunkt von QCode akzeptiert keine Claude-Modelle (siehe Endpunkte & API-Pfade).

Installation¶

# Homebrew
brew install charmbracelet/tap/crush

# or download a prebuilt binary from Releases
# https://github.com/charmbracelet/crush/releases

Überprüfen (verlassen Sie sich auf die tatsächliche Ausgabe, nicht auf eine Versionsnummer in einer Dokumentation):

crush --version

Konfiguration¶

Erstellen Sie crush.json im Projektstamm oder auf Benutzerebene unter ~/.config/crush/crush.json (= $XDG_CONFIG_HOME/crush/crush.json; beachten Sie, dass ~/.local/share/crush/ Zustandsdateien enthält, die laut offizieller Dokumentation nicht bearbeitet werden sollten). Neuere Upstream-Versionen empfehlen auch ein crushrc-Format (Bash-DSL); JSON-Konfiguration wird weiterhin gelesen:

{
  "$schema": "https://charm.land/crush.json",
  "providers": {
    "qcode": {
      "type": "anthropic",
      "base_url": "https://api.qcode.cc/api",
      "api_key": "$QCODE_KEY",
      "extra_headers": { "anthropic-version": "2023-06-01" },
      "models": [
        {
          "id": "claude-sonnet-5",
          "name": "QCode Sonnet 5",
          "cost_per_1m_in": 2,
          "cost_per_1m_out": 10,
          "context_window": 1000000,
          "default_max_tokens": 8192,
          "cost_per_1m_in_cached": 0.2,
          "cost_per_1m_out_cached": 2.5,
          "can_reason": true,
          "supports_attachments": true
        },
        {
          "id": "claude-haiku-4-5",
          "name": "QCode Haiku 4.5",
          "cost_per_1m_in": 1,
          "cost_per_1m_out": 5,
          "context_window": 200000,
          "default_max_tokens": 4096,
          "cost_per_1m_in_cached": 0.1,
          "cost_per_1m_out_cached": 1.25,
          "can_reason": true,
          "supports_attachments": true
        }
      ]
    }
  }
}

Übergeben Sie den API-Key über die Umgebung, anstatt ihn in die Datei zu schreiben:

export QCODE_KEY="cr_your_qcode_key"

Festlandchina: Ersetzen Sie den Host durch https://asia.qcode.cc/api (Asien-Knoten, nächstliegender von Korea / Taiwan / Hongkong); der API-Key bleibt unverändert. cost_per_1m_* (einschließlich der beiden *_cached-Schlüssel, die das offizielle Schema erfordert) beeinflusst nur die Nutzungsanzeige in Crush, nicht die tatsächliche Abrechnung; die Beispielwerte folgen einem typischen Cache-Verhältnis – passen Sie diese an die tatsächlichen Cache-Preise auf qcode.cc/models an.

Überprüfen¶

crush run "reply with exactly: OK"

OK bedeutet, dass die Verbindung steht.

Um zu belegen, dass der Datenverkehr tatsächlich an QCode geht, setzen Sie base_url gezielt auf einen nicht existierenden Pfad und führen den Befehl erneut aus. Sie sollten einen eindeutigen 404-Fehler sehen, der die vollständige URL wiedergibt:

404 Not Found {"error":"Not Found","message":"Route /api/xxx/v1/messages not found"}

Dieser Fehler belegt, dass Crush base_url + /v1/messages zusammensetzt und Ihre Konfiguration wirksam ist. (Das ist eine Negativkontrolle: Ein Erfolg allein beweist nicht, dass Ihr Anbieter verwendet wurde – Crush könnte auf einen anderen zurückgefallen sein.)

Alltägliche Nutzung¶

# interactive
crush

# non-interactive
crush run "make this function async"

# pipes
cat README.md | crush run "make this clearer" > README.new.md

# specific directory with debug logging
crush --debug --cwd /path/to/project

# auto-accept every permission (use with care)
crush --yolo

Fehlerbehebung¶

model_not_available_on_endpoint¶

type steht auf openai-compat, während das Modell ein Claude-Modell ist. Wechseln Sie zu type: "anthropic" mit base_url = https://api.qcode.cc/api.

401 Invalid API key¶

Die Umgebungsvariable wurde nicht übergeben, oder der Key enthält überflüssige Leerzeichen. Prüfen Sie, ob echo $QCODE_KEY mit cr_ beginnt.

Das Modell erscheint nicht in der Auswahl¶

Crush zeigt nur Modelle an, die explizit in models[] aufgeführt sind. Fügen Sie einen Eintrag hinzu und starten Sie Crush neu.

Verwandte Themen¶

• Endpunkte & API-Pfade — Tabelle Protokoll × Modellfamilie
• OpenCode-Integration — ein anderer Terminal-Agent (nicht dasselbe Projekt)
• Chinesische Modelle — GLM / Kimi / DeepSeek / Qwen