Factory Droid mit Claude betreiben

Droid von Factory ist eine agentische CLI derselben Kategorie wie Claude Code. Sie können über eine Konfigurationsdatei eigene Modelle einbinden. Wenn Sie Droid auf das Gateway von AI Prime Tech ausrichten, laufen seine Agentenschleifen mit Claude neben allen anderen Modellen, die das Gateway bereitstellt.

Die Einstellungsdatei bearbeiten

Droid liest ~/.factory/settings.json. Fügen Sie ein customModels-Array hinzu, in dem jeder Eintrag ein Modell beschreibt, das verfügbar sein soll. Dies ist der aktuelle Konfigurationspfad; die ältere config.json ist veraltet und unterstützt nicht alles, was settings.json unterstützt.

Eine Datei deckt Ihre gesamte Droid-Einrichtung ab. Eine einzige customModels-Liste definiert daher alle Modelle, zwischen denen die CLI wechseln kann. Speichern Sie sie auf Benutzerebene statt pro Projekt.

Zu wissen, dass settings.json die aktuelle Datei ist, erspart viel Verwirrung, denn ältere Hinweise und Diskussionen verweisen weiterhin auf config.json, und einige Funktionen verhalten sich in den beiden Dateien unterschiedlich. Wenn etwas an einer Stelle funktioniert und an der anderen nicht, ist settings.json fast immer die verlässliche Wahl. Bei widersprüchlichen Empfehlungen löst die Bevorzugung von settings.json gegenüber config.json die meisten Unklarheiten. Die neuere Datei wird von Factory aktiv unterstützt, und dort funktioniert die Variablensyntax tatsächlich.

Das Modell beschreiben

Jeder customModels-Eintrag enthält eine Modell-ID, baseUrl, apiKey, provider und maxOutputTokens. Setzen Sie model auf die Gateway-ID, beispielsweise claude-sonnet-4-5, und baseUrl auf den Gateway-Host.

Zusammen geben diese Felder Droid genau vor, wie es das Modell erreicht. Da Droid keinen einzelnen Provider voraussetzt, geben Sie jeden Bestandteil ausdrücklich an. Dadurch ist es flexibel genug, um ein Gateway anzusprechen.

Dank dieser ausdrücklichen Angaben kann eine Droid-Installation mehrere Claude-Modelle über dasselbe Gateway bereitstellen: jeweils als eigener customModels-Eintrag mit gemeinsamer baseUrl und gemeinsamem Schlüssel. Die CLI behandelt sie als separat auswählbare Modelle, obwohl sie alle zum selben vorgelagerten Endpunkt führen. Genau diese expliziten Felder ermöglichen es einer Installation, mehrere Claude-Modelle über einen einzigen Endpunkt bereitzustellen. Jeder Eintrag verwendet dieselbe baseUrl und denselben Schlüssel, behält aber seine eigene Modell-ID. Das Gateway übernimmt also das Routing, während Droid lediglich einen Namen auswählt.

Den Provider-Modus wählen

Das Feld provider legt das Übertragungsformat fest. Verwenden Sie anthropic für die native Messages-Schnittstelle des Gateways, openai für das Responses-Format oder generic-chat-completion-api für einen /v1-Chat-Endpunkt im OpenAI-Stil. Für Claude auf dem Gateway ist anthropic die naheliegende Wahl.

Wenn provider zur tatsächlichen Schnittstelle des Gateways passt, vermeiden Sie Fehler beim ersten Start. Mit provider anthropic verwendet Droid das native Format, das das Gateway für Claude bereitstellt.

Die drei Provider-Modi entsprechen auch klar den Schnittstellen, die ein Multi-Modell-Gateway bereitstellen kann. Wenn dasselbe Gateway ein Modell im OpenAI-Stil anbietet, würden Sie dieses daher als separaten Eintrag mit generic-chat-completion-api hinzufügen. Die Regel, den provider jedes Eintrags auf dessen Schnittstelle abzustimmen, hält eine gemischte Einrichtung fehlerfrei. Den provider bei jedem Eintrag auf die Schnittstelle abzustimmen, ist die Regel für eine reibungslose gemischte Gateway-Einrichtung. Ein nativer Claude-Eintrag und ein Eintrag im OpenAI-Stil können problemlos nebeneinander bestehen.

Den API-Schlüssel hinterlegen

Tragen Sie den Schlüssel in apiKey ein, idealerweise als ${VAR}-Referenz wie ${AIPRIME_API_KEY}, damit das Geheimnis in Ihrer Umgebung statt in der Datei bleibt. Beachten Sie, dass die ${VAR}-Ersetzung in settings.json funktioniert, in der veralteten config.json jedoch nicht.

Das Feld apiKey darf auch dann nicht leer sein, wenn ein Gateway technisch eine anonyme Anfrage akzeptieren würde. Droid prüft, ob das Feld einen Wert enthält. Geben Sie daher immer den Schlüssel oder die Variable an, die ihn enthält.

Diese beiden Fakten erklären zusammen einen häufigen Stolperstein: Nutzer tragen ${VAR} in die alte config.json ein, wo keine Ersetzung erfolgt, und Droid sieht eine wörtliche, nicht aufgelöste Zeichenfolge. Verwenden Sie für die Variablenform settings.json und stellen Sie sicher, dass die Variable tatsächlich in der Shell exportiert ist, aus der Droid gestartet wird. Die Prüfung, ob die Variable in der startenden Shell exportiert ist, ist der letzte Schritt, den viele übersehen. Droid sieht nur Variablen, die in der Umgebung vorhanden sind, aus der es gestartet wurde.

Wechseln und ausführen

Wechseln Sie innerhalb der Droid CLI mit dem Befehl /model zwischen konfigurierten Modellen. Fügen Sie einen weiteren Eintrag für claude-opus-4-8 hinzu, damit Sie für schwierigere Aufgaben darauf umschalten können, ohne die Konfiguration erneut zu bearbeiten.

Anschließend führt Droid seine Agentenschleife mit Claude auf dem Gateway aus. Da die Einrichtung in settings.json gespeichert ist, gilt dieselbe Konfiguration bei jedem Start der CLI.

Wenn sowohl ein Sonnet- als auch ein Opus-Eintrag bereitsteht, können Sie das Modell spontan an die Aufgabe anpassen — Sonnet für kontinuierliche Implementierungsarbeit, Opus für Probleme, die anspruchsvolleres Schlussfolgern erfordern — alles über das Gateway und ohne Neukonfiguration. Mit /model lässt sich das mitten in der Sitzung mit einer einzigen Zeile ändern. Genau dieser einzeilige /model-Wechsel während der Sitzung macht die Anpassung des Modells an die Aufgabe so mühelos. Sie wechseln von Sonnet zu Opus, ohne die Sitzung zu verlassen.

// ~/.factory/settings.json
{
  "customModels": [
    {
      "model": "claude-sonnet-4-5",
      "baseUrl": "https://aiprimetech.io",
      "apiKey": "${AIPRIME_API_KEY}",
      "provider": "anthropic",
      "maxOutputTokens": 8192
    }
  ]
}
// export AIPRIME_API_KEY=<key>   (apiKey must NOT be empty)
// Switch models in the CLI with /model

Häufig gestellte Fragen

AI Prime Tech ist ein unabhängiges API-Gateway. Es ist weder mit Anthropic verbunden noch von Anthropic empfohlen und auch kein Wiederverkäufer von Anthropic. Claude und zugehörige Modellnamen sind Marken ihrer jeweiligen Inhaber.