Droid (Factory) Einrichtung

QCode.cc als BYOK-Modell in Factory's Droid CLI hinzufügen: provider=anthropic plus baseUrl in ~/.factory/settings.json

Zuletzt überprüft: 2026-09-18 · 📄 Gemäß offizieller Dokumentation (Droid CLI v0.222.0 veröffentlicht am 2026-09-18; häufige Releases — verlassen Sie sich auf droid --version)

Auf einen Blick¶

Welches Protokoll¶

Droid wählt das Protokoll über das Feld provider. Für Claude verwenden Sie anthropic — der OpenAI-Endpunkt von QCode akzeptiert keine Claude-Modelle (siehe Endpunkte & API-Pfade).

🔴 Schreiben Sie nicht "provider": "openai" — upstream reserviert es für die OpenAI Responses API (“Use provider: "generic-chat-completion-api" unless you are calling OpenAI's or Anthropic's official API”, BYOK-Dokumentation). GPT / chinesische Modelle auf QCode sprechen Chat Completions, verwenden Sie daher generic-chat-completion-api.

Installation¶

curl -fsSL https://app.factory.ai/cli | sh

Installiert wird nach ~/.local/bin/droid. Falls der Installer meldet, dass PATH nicht konfiguriert ist, fügen Sie die angezeigte Zeile zu ~/.zshrc / ~/.bashrc hinzu.

Überprüfen Sie (verlassen Sie sich auf die tatsächliche Ausgabe):

droid --version

Konfiguration¶

Bearbeiten Sie ~/.factory/settings.json (sie wird bei der ersten droid-Ausführung automatisch erstellt; eine projektweite .factory/settings.local.json funktioniert ebenfalls — sie wird darüber zusammengeführt, vergessen Sie nicht, sie in die gitignore aufzunehmen):

{
  "customModels": [
    {
      "model": "claude-sonnet-5",
      "displayName": "QCode Sonnet 5",
      "baseUrl": "https://api.qcode.cc/api",
      "apiKey": "${QCODE_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 8192
    },
    {
      "model": "claude-haiku-4-5",
      "displayName": "QCode Haiku 4.5",
      "baseUrl": "https://api.qcode.cc/api",
      "apiKey": "${QCODE_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 4096
    }
  ]
}

Injizieren Sie den API-Key über die Umgebung:

export QCODE_KEY="cr_your_qcode_key"

Laut Factory-Dokumentation bleiben API-Keys lokal und werden nicht auf Factory-Server hochgeladen. Von Festland-China aus ersetzen Sie den Host durch https://asia.qcode.cc/api (Asien-Knoten, nächstgelegener von Korea / Taiwan / Hongkong).

Überprüfung¶

droid exec --model "claude-sonnet-5" "reply with exactly: OK"

OK bedeutet, dass die Verbindung hergestellt ist.

Negativkontrolle (zum Nachweis, dass die Konfiguration tatsächlich greift): Ändern Sie baseUrl vorübergehend auf einen nicht existierenden Pfad und führen Sie den Befehl erneut aus — er sollte fehlschlagen. Ein Erfolg allein beweist nicht, dass Ihre Leitung verwendet wurde.

Tägliche Verwendung¶

# interactive
droid

# non-interactive
droid exec "run the tests and fix the failures"

# specific working directory
droid --cwd /path/to/project

# run inside a git worktree (isolated changes)
droid -w feature-x

# autonomy level
droid --auto medium

Fehlerbehebung¶

model_not_available_on_endpoint¶

Der provider ist ein OpenAI-kompatibler Wert, während das Modell ein Claude-Modell ist. Setzen Sie "provider": "anthropic" mit baseUrl = https://api.qcode.cc/api.

401 / Authentifizierungsfehler¶

${QCODE_KEY} wurde nicht expandiert (die Variable ist nicht exportiert), oder der API-Key enthält Leerzeichen. Prüfen Sie, dass echo $QCODE_KEY mit cr_ beginnt. Eine weitere Falle: die Konfiguration in die Legacy-Datei ~/.factory/config.json (snake_case-Felder) geschrieben — laut Dokumentation expandiert die Legacy-Datei keine apiKey-Umgebungsreferenzen, sodass ${QCODE_KEY} unverändert als Key gesendet würde. Verwenden Sie settings.json.

Das Modell fehlt in der Auswahl¶

Es erscheinen nur Modelle, die in customModels[] aufgeführt sind. Fügen Sie einen Eintrag hinzu und starten Sie neu.

Weiterführendes¶

• Endpunkte & API-Pfade — Tabelle Protokoll × Modellfamilie
• Crush Einrichtung — ein anderer Coding-Agent im Terminal
• Chinesische Modelle — GLM / Kimi / DeepSeek / Qwen