FreeLLMAPI · Open Source · MIT
Claude Code weiter nutzen, mit kostenlosen Modellen.
FreeLLMAPI sammelt die Gratis-Kontingente von 34 KI-Anbietern und stellt sie hinter einem einzigen Endpoint auf deinem Rechner bereit. Laut README sind das 635 kostenlose Modell-Endpoints. Claude Code spricht mit diesem Endpoint, und ist ein Modell am Limit, nimmt der Router das nächste.
Wie der Router arbeitet
Viele Gratis-Kontingente, ein Endpoint.
FreeLLMAPI ist nicht von mir, sondern ein Open-Source-Projekt von Tashfeen Ahmed auf GitHub. Ich zeige es dir, weil es ein Problem löst, das jeder kennt, der viel mit Claude Code arbeitet.
- 01
Jedes Gratis-Kontingent ist klein
Das Problem
Fast jeder KI-Anbieter hat ein kostenloses Kontingent, aber jedes für sich reicht nicht weit. Alle von Hand zu verbinden heißt: viele Keys, viele Limits, viele Stellen, an denen eine Anfrage scheitert. Zusammen kommen laut README rund 7,4 Milliarden Tokens im Monat zusammen, wenn du für alle Anbieter Keys hinterlegst.
Die Zahl gilt nur mit Keys für alle 34 Anbieter.
- 02
Ein Endpoint auf deinem Rechner
Router mit Fallback-Kette
Du trägst deine Anbieter-Keys im Dashboard ein, verschlüsselt gespeichert. Der Router wählt für jede Anfrage das beste verfügbare Modell. Kommt ein Rate-Limit (429) oder ein Serverfehler, probiert er automatisch das nächste Modell in deiner Kette.
# Dashboard und API laufen lokal http://localhost:3001 http://localhost:3001/v1Deine Apps sehen nur einen einzigen freellmapi-Key.
- 03
Claude Code redet mit dem Router
Anthropic-Format unter /v1/messages
Der Router versteht das Nachrichtenformat von Anthropic, deshalb läuft Claude Code direkt dagegen. Wechselt das Modell mitten im Gespräch, kann FreeLLMAPI dem neuen Modell eine kurze Übergabenotiz mitgeben. Diese Kontext-Übergabe ist standardmäßig aus, du schaltest sie in der .env ein.
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchLaut README: keine Frontier-Modelle, schwankende Antwortzeiten, keine Garantie.
Installieren · zum Kopieren
Ein Prompt, und der Router läuft.
FreeLLMAPI ist öffentlich auf GitHub und steht unter MIT-Lizenz. Du brauchst Node.js ab Version 20 oder Docker, auf Mac und Windows gibt es auch eine Desktop-App. Der Router selbst kostet nichts, die Anbieter-Keys holst du dir bei den Anbietern.
- FreeLLMAPI geklont, Abhängigkeiten installiert
- ENCRYPTION_KEY in .env erzeugt
- Dashboard läuft auf http://localhost:3001
- Offen: Konto anlegen, Anbieter-Keys eintragen, Unified Key kopieren
- Claude Code noch nicht verbunden, wartet auf dein Go
Die Anbieter-Keys trägst du selbst im Dashboard ein
Installiere mir FreeLLMAPI aus diesem Repo und verbinde danach Claude Code damit:
https://github.com/tashfeenahmed/freellmapi
1. Prüf node --version (mindestens 20) und npm --version.
Installier Node.js nicht selbst, sag mir nur, was fehlt.
2. Installiere FreeLLMAPI laut docs/en/install/01-install.md,
Abschnitt Local development: Repo klonen, npm install,
einen ENCRYPTION_KEY in die .env schreiben, npm run dev.
Das Dashboard läuft dann auf http://localhost:3001.
3. Sag mir, dass ich im Dashboard ein Konto anlege, unter Keys
meine Anbieter-Keys eintrage und die Fallback-Kette sortiere.
Die Keys trage ich selbst ein, frag mich nicht danach.
4. Wenn ich dir den Unified Key aus dem Dashboard gebe: Zeig mir
zuerst mit
npx freellmapi setup-claude --url http://localhost:3001 --dry-run
was sich an ~/.claude/settings.json ändern würde. Schreib erst
nach meinem OK. Erklär mir auch die Alternative
npx freellmapi launch, die nichts auf die Platte schreibt.
5. Sag mir, wie ich die Umstellung wieder rückgängig mache.
Verbinde Claude Code noch nicht, bevor ich dir Bescheid gebe.In vier Schritten
So richtest du FreeLLMAPI ein.
Einmal eingerichtet, läuft der Wechsel zwischen den Modellen von allein.
- 01
Prompt einfügen
Claude installiert selbst
Kopier den Install-Prompt in deine Claude-Code-Session. Claude prüft Node.js, klont das Repo und startet den Router. Wenn du lieber Docker oder die Desktop-App nimmst, steht beides im README.
git clone https://github.com/tashfeenahmed/freellmapi.git cd freellmapi && npm install npm run dev - 02
Anbieter-Keys eintragen
Im Dashboard, einmalig
Öffne http://localhost:3001, leg ein Konto an und trag unter Keys die Gratis-Keys deiner Anbieter ein, zum Beispiel Google, Groq oder Mistral. Je mehr Anbieter du verbindest, desto länger hält die Kette. Oben auf derselben Seite steht dein Unified Key.
Die Keys liegen verschlüsselt in einer lokalen SQLite-Datenbank.
- 03
Claude Code verbinden
setup-claude oder launch
setup-claude trägt Adresse, Key und Modell in ~/.claude/settings.json ein, legt vorher eine Sicherung an und zeigt dir mit --dry-run erst den Diff. Mit launch startest du Claude Code nur für diesen einen Lauf über den Router, ohne dass etwas gespeichert wird.
npx freellmapi setup-claude --url http://localhost:3001 --dry-run npx freellmapi launchNach setup-claude läuft jede Session über den Router, bis du den env-Block wieder entfernst.
- 04
Weiterarbeiten
Mit freien Modellen
Ab jetzt beantworten freie Modelle deine Anfragen. Jede Antwort trägt den Header X-Routed-Via, im Dashboard siehst du, welcher Anbieter geantwortet hat. Für echte Projekte empfiehlt das README selbst, vor dem Livegang auf eine bezahlte API umzusteigen.
KI Agenten Club
FreeLLMAPI ist ein Werkzeug für Experimente. Im KI Agenten Club zeige ich dir, wie ich mein ganzes Setup aufbaue, von Skills über Agenten bis zu den Tools, mit denen ich jeden Tag arbeite.
KI Agenten Club
Vom Skill zum kompletten Setup.
Richtig Zeit sparst du, wenn Skills, Agenten, MCP-Server und deine CLAUDE.md zusammenspielen. Im KI Agenten Club zeigen wir dir das an unserem eigenen Setup, damit du es für deine Arbeit nachbauen kannst.
Vishal Punia · KI Agenten Club
Setup zum Übernehmen
Die Skills, MCP-Server und Vorlagen aus unserem Alltag, plus Orbit. 3 Tage kostenlos testen.