Source: https://aiprimetech.io/de/learn/use-claude-api-with-factory-droid/

[Startseite](/de/) / [Lernen](/de/learn/) / Factory Droid mit Claude ausführen 

# 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. 

Kopieren

```
// ~/.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 

 Wie führe ich Factory Droid mit Claude aus?

Fügen Sie in ~/.factory/settings.json einen customModels-Eintrag mit provider anthropic, baseUrl https://aiprimetech.io,, Ihrer Modell-ID und apiKey hinzu. Wechseln Sie mit /model. Welcher provider-Wert ist für Claude geeignet?

anthropic für die native Messages-Schnittstelle. openai oder generic-chat-completion-api sprechen stattdessen Endpunkte im OpenAI-Stil an. Darf apiKey leer sein?

Nein — Droid verlangt einen Wert. Verwenden Sie eine ${VAR}-Referenz wie ${AIPRIME_API_KEY}; die Ersetzung funktioniert in settings.json, nicht in der veralteten config.json. Wie wechsle ich zwischen Modellen?

Verwenden Sie den Befehl /model in der Droid CLI, um zwischen beliebigen Einträgen Ihrer customModels-Liste zu wechseln.  

Claude in wenigen Minuten nutzen

Holen Sie sich einen API-Schlüssel – ohne Anthropic-Konto oder Warteliste.[API-Schlüssel erhalten](/register) 

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.    

## Weitere Anleitungen zur Claude API

[So erhalten Sie einen Claude API-Schlüssel](/de/learn/how-to-get-a-claude-api-key/)[Claude-API-Preise erklärt](/de/learn/claude-api-pricing-explained/)[Die günstigste Möglichkeit, die Claude API zu nutzen](/de/learn/cheapest-way-to-use-claude-api/)[Cursor unbegrenzt mit der Claude API nutzen](/learn/use-claude-api-with-cursor/)[Unbegrenzter Zugang zu Claude Code](/de/learn/use-claude-api-with-claude-code/)[Claude API-Gateway vs. direkter Zugang zu Anthropic](/de/learn/claude-api-vs-anthropic-direct/)[Claude über eine OpenAI-kompatible API nutzen](/de/learn/openai-compatible-claude-api/)[Claude-Modelle erklärt: ein Vergleich von Claude Opus, Sonnet, Haiku und Fable — alle Claude-API-Modelle, Anthropic-Modellnamen und Preise (2026)](/de/learn/claude-api-models-compared/)[Die Claude API mit Kryptowährungen bezahlen](/de/learn/claude-api-with-crypto-payment/)[Zugang zur Claude API ohne Warteliste](/de/learn/claude-api-without-waitlist/)[So reduzieren Sie den Token-Verbrauch von Claude](/de/learn/how-to-reduce-claude-token-usage/)[Cline unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-cline/)[Roo Code unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-roo-code/)[Claude unbegrenzt in JetBrains-IDEs nutzen](/de/learn/use-claude-api-with-jetbrains/)[Aider unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-aider/)[Claude unbegrenzt in VS Code nutzen](/de/learn/use-claude-api-with-vscode/)[OpenCode-Konfiguration für Claude: Einrichtung von opencode.json, Modelle und häufige Fehler](/de/learn/use-claude-api-with-opencode/)[Einen unbegrenzten Hermes-Agenten mit Claude betreiben](/de/learn/run-hermes-agent-with-claude-api/)[OpenClaw unbegrenzt mit Claude betreiben](/de/learn/run-openclaw-with-claude-api/)[Was eine Anthropic-kompatible API bedeutet](/de/learn/anthropic-compatible-api/)[Claude Code-API-Schlüssel — ANTHROPIC_API_KEY: So erhalten und konfigurieren Sie ihn, und wann Sie stattdessen claude setup-token verwenden sollten](/de/learn/claude-code-api-key-setup/)[Claude Code-API-Kosten — Preise und Möglichkeiten zur Kostensenkung](/de/learn/claude-code-api-costs/)[Claude API-Fehler erklärt: Serverfehler 500, Überlastung 529, Ratenlimit 429, fehlerhafte Anfrage 400 — und die jeweilige Lösung](/de/learn/claude-api-errors-troubleshooting/)[So kaufen Sie Claude API-Guthaben – und warum Claude-Guthaben besser ist als jedes Angebot zum „Kauf eines Claude-Kontos“](/de/learn/buy-claude-api-credits/)[Kostenlose Claude API: Gibt es einen kostenlosen Claude API-Schlüssel, und was ist in 2026 tatsächlich kostenlos?](/de/learn/claude-api-free-trial/)[Claude API vs. Claude Pro/Max-Abonnement — welche Option wählen?](/de/learn/claude-api-vs-subscription/)[Die Codex CLI mit Claude ausführen](/de/learn/use-claude-api-with-codex/)[Claude mit n8n verbinden](/de/learn/use-claude-api-with-n8n/)[LiteLLM-Anfragen an Claude weiterleiten](/de/learn/use-claude-api-with-litellm/)[Claude in Kilo Code verwenden](/de/learn/use-claude-api-with-kilo-code/)[Claude in GitHub Copilot integrieren](/de/learn/use-claude-api-with-github-copilot/)[Zed über das Gateway mit Claude verbinden](/de/learn/use-claude-api-with-zed/)[Cherry Studio mit Claude verbinden](/de/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic in LangChain: Import, base_url, Streaming, Tools und Fehler](/de/learn/use-claude-api-with-langchain/)[Anthropic Python SDK: installieren, base_url setzen, streamen und Fehler behandeln](/de/learn/anthropic-python-sdk/)[Claude mit dem Vercel AI SDK: createAnthropic baseURL, Streaming und Fehlerbehebung](/de/learn/use-claude-api-with-vercel-ai-sdk/)[Die Claude Code API erklärt](/de/learn/claude-code-api/)[Die Claude API in Ihre Anwendung integrieren](/de/learn/claude-api-integration/)[So nutzen Sie Claude unbegrenzt – und warum es kein „gecracktes Claude Code“ gibt](/de/learn/get-unlimited-claude-usage/)