
Free Claude Code: Einrichtung für $0 und fünf Stolperfallen
Free Claude Code mit NVIDIA NIM und OpenRouter einrichten: 10-Minuten-Plan, 1,3-Milliarden-Token-Versprechen, Kostenanzeige und fünf Stolperfallen.
Was für $0 verfügbar ist
Free Claude Code (FCC) verbindet den Claude-Code-Client mit kostenlosen Modellendpunkten anderer Anbieter. Der vertraute Ablauf bleibt erhalten: Code lesen → Dateien ändern → Werkzeuge ausführen → Ergebnis prüfen. Das nächste Vorgehen erzeugt dabei ein anderes Modell. Das proprietäre Claude-Modell gehört nicht zu diesem Angebot. FCC ist ein unabhängiges Communityprojekt; Zugang, Kontingente und Bedingungen bestimmt weiterhin jeder Anbieter selbst. [1]
Dieser Leitfaden plant ungefähr zehn Minuten Konfiguration ein, nachdem Anbieterkonten und Telefonnummernprüfung bereit sind. Downloads, regionale Prüfungen und Fehlerbehebung können länger dauern. Wir haben den Quellcode von FCC v6.16.16 und die Anbieterdokumentation am 23. Oktober 2026 geprüft und die Testdatei lokal validiert. Eine NVIDIA-Registrierung und echte Modellanfragen haben wir nicht durchgeführt. Es handelt sich um eine anhand der Quellen geprüfte Anleitung, nicht um einen gestoppten Praxistest.
Was bezahlt wird und was in der Agentenschleife bleibt
Die direkte Claude-Nutzung kann in einem Abonnementkontingent enthalten sein oder über ein API-Konto abgerechnet werden. Bei API-Nutzung beeinflussen Eingabe, Ausgabe und Caching die Rechnung. Eine lange Programmiersitzung sendet wiederholt Kontext, Werkzeugergebnisse und Folgeanfragen. Ein Nutzerauftrag kann mehrere Modellaufrufe auslösen. Monatsabonnement und tokenbasierte API-Rechnung sind unterschiedliche Zahlungsmodelle. [2]
FCC ändert die Route zur Modellausführung. Claude Code verwaltet weiterhin Unterhaltung und lokale Werkzeuge; das Ersatzmodell wählt innerhalb dieses Ablaufs die Aktionen. FCC übersetzt Anfragen und Antworten, ordnet Modellstufen zu und kann Ersatzmodelle versuchen. Der Orchestrierungsalgorithmus des Clients wird dadurch nicht neuer. Schlussfolgern und Werkzeugnutzung können beim Ersatzmodell anders ausfallen. Der Starter setzt ANTHROPIC_BASE_URL auf FCC und entfernt geerbte ANTHROPIC_*-Umgebungsvariablen für den Kindprozess. Verwenden Sie für diese Route fcc-claude; eine gewöhnliche claude-Sitzung belegt die Proxyverbindung nicht. [1]
PAS7-Schema anhand des FCC-Start- und Routingcodes. Dateien und Werkzeuge bleiben unter Kontrolle des lokalen Agenten; zur Inferenz gesendeter Kontext erreicht den externen Anbieter. Keine Aufzeichnung des Netzwerkverkehrs. [1]
Screenshot des Abschnitts agent-loopMinute 0–4: eine dokumentierte Version installieren
Der Hauptweg verwendet macOS/Linux und ein Terminal. Windows-PowerShell-Befehle stehen ebenfalls unten. Das Installationsskript verwaltet die benötigten Python-/uv-Versionen und bietet die Installation von Agenten an. Wählen Sie Claude Code und lassen Sie Sprache, Messenger und Ausgabekompression beim ersten Lauf aus. Für NVIDIA und OpenRouter werden diese Extras nicht benötigt. Laden Sie das Skript zunächst herunter und lesen Sie es. Das Beispiel fixiert sowohl den Installer-Quellstand als auch die FCC-Paketversion. [1]
curl -fL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/3d2ae2306752dbdf504714a5489bcfcf69b2d04a/scripts/install.sh" -o fcc-install.sh
less fcc-install.sh
FCC_INSTALL_VERSION=6.16.16 sh fcc-install.shWindows PowerShell:
Invoke-WebRequest "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/3d2ae2306752dbdf504714a5489bcfcf69b2d04a/scripts/install.ps1" -OutFile fcc-install.ps1
Get-Content .\fcc-install.ps1
$env:FCC_INSTALL_VERSION = "6.16.16"
& .\fcc-install.ps1Falls fcc-server nach der Installation nicht im PATH gefunden wird, öffnen Sie das Terminal erneut. Starten Sie den Server ausdrücklich im Terminal und lassen Sie es offen. Öffnen Sie zunächst nicht den Desktopstarter: Diese Anleitung soll die Bindeadresse selbst festlegen. Die Versionsbefehle sollten die installierten Versionen von FCC und Claude Code anzeigen.
Im geprüften FCC-Stand gelten standardmäßig HOST=0.0.0.0 und PORT=8082; die Proxyauthentifizierung ist ausgeschaltet. Der HOST-Wert unten begrenzt diese Sitzung auf Loopback. Verwenden Sie unter Windows den zweiten Block. Öffnen Sie die Admin-Adresse aus dem Serverprotokoll; 8082 ist der Standardport, die tatsächlich ausgegebene Adresse hat Vorrang. [10]
fcc-server --version
claude --version
HOST=127.0.0.1 fcc-serverWindows PowerShell:
$env:HOST = "127.0.0.1"
fcc-servercurl --fail http://127.0.0.1:8082/healthEine erfolgreiche Statusantwort bestätigt die Erreichbarkeit des lokalen Prozesses. Sie bestätigt weder API-Schlüssel noch Modell oder kostenlosen Tarif.
Minute 4–6: NVIDIA-Schlüssel, Verifikation und 40 RPM
Öffnen Sie NVIDIAs Seite für API-Schlüssel, registrieren Sie sich oder melden Sie sich an und erledigen Sie die verlangte Verifikation. Erzeugen Sie einen eigenen Schlüssel. Öffnen Sie FCC Admin → Providers → NVIDIA NIM → Add key, fügen Sie ihn ein und wählen Sie Save. Danach Modell unter MODEL auswählen und Apply anklicken. Das aktuelle README-Beispiel lautet nvidia_nim/nvidia/nemotron-3-ultra-550b-a55b. Prüfen Sie auf der Modellseite, ob weiterhin ein kostenloser gehosteter Endpunkt mit den benötigten Werkzeugfunktionen angeboten wird. Für die gehostete API ist keine NVIDIA-Grafikkarte nötig. [1][3]
Für eine „Verifikation aus der GUS“ gibt es keinen einheitlich verlässlichen Ablauf. Land und Konto beeinflussen Zugang und SMS-Optionen. Im NVIDIA-Forum gibt es einen Bericht über Russland +7 als fehlende Länderauswahl und eine Bitte um manuelle Prüfung. Der Beitrag belegt weder einen genehmigten Umweg noch eine garantierte Freigabe. Wird Ihr Land oder Ihre Nummer nicht unterstützt, beenden Sie diesen Zweig, kontaktieren Sie den offiziellen Support oder nutzen Sie einen für Sie verfügbaren Anbieter. Geliehene Schlüssel und gemietete Bestätigungsnummern bieten keine verlässliche Kontokontrolle. [5]
Ein NVIDIA-Moderator bestätigt eine veröffentlichte Obergrenze von 40 Anfragen pro Minute für persönliche kostenlose Konten. Das ist eine Anfragegrenze unter den jeweiligen Endpunktbedingungen und möglicher Drosselung, kein Tokenpaket und keine garantierte Leistung. Parallele Agenten können sie durch kurze Lastspitzen erreichen. Beachten Sie 429-Antworten und Wartezeiten; zusätzliche Schlüssel sind kein tragfähiger Kapazitätsplan. [4]
Minute 6–8: OpenRouter als zweiten Anbieter ergänzen
Erzeugen Sie unter https://openrouter.ai/keys einen OpenRouter-Schlüssel. Fügen Sie ihn in FCC Admin → Providers → OpenRouter hinzu und speichern Sie ihn. Für den ersten Versuch unter MODEL open_router/openrouter/free auswählen und Apply anklicken. Dieser Router wählt passende kostenlose Modelle aus; das ausführende Modell kann sich ändern. Für wiederholbare Programmieraufgaben empfiehlt sich ein aktuell gelistetes :free-Modell mit Werkzeugunterstützung und dokumentierter exakter Kennung. Ein beliebiges kostenpflichtiges Modell erhält durch Anhängen von :free keinen kostenlosen Endpunkt. [1][7][8]
Prüfen Sie NVIDIA und OpenRouter zunächst einzeln als Hauptmodell. Setzen Sie anschließend NVIDIA als primäre Route und tragen Sie die geprüfte kostenlose OpenRouter-Route unter Model Config in die geordnete Liste Fallback Models ein. Kontrollieren Sie auch die Modellstufen: Fable, Opus, Sonnet und Haiku sollen das gewünschte Modell erben oder ausdrücklich auf geprüfte kostenlose Routen zeigen. Hauptmodell, alle Überschreibungen und jeder Ersatz gehören zur Prüfung. Ein kostenpflichtiger Fallback kann echte Gebühren auslösen; OpenRouter dokumentiert dieses Verhalten ausdrücklich. [1][8]
Für den strikten $0-Weg laden Sie kein Guthaben auf und ergänzen keine kostenpflichtige Route. OpenRouters veröffentlichte Basisgrenzen für kostenlose Modelle betragen kontoweit 20 Anfragen pro Minute und 50 pro Tag. Die dokumentierte Stufe mit 1.000 pro Tag setzt insgesamt $10 an Guthabenkäufen voraus. Ein Einstieg ohne Geldausgabe ist das nicht. Prüfen Sie das tatsächlich verbleibende Kontingent vor einer längeren Aufgabe. [6][13]
Minute 8–10: einen Werkzeugzyklus mit festen Tests prüfen
Verwenden Sie ein leeres temporäres Verzeichnis, Node.js (die Testdatei wurde mit v24.9.0 geprüft) und die unten verlinkte Testdatei. Unter Windows erstellen Sie den Ordner und laden die Datei per PowerShell oder Browser herunter; starten Sie darin anschließend fcc-claude. Behalten Sie Claude Codes normale Werkzeugfreigaben bei. Diese Aufgabe benötigt keine Optionen zum Umgehen von Berechtigungen. [12]
mkdir fcc-smoke
cd fcc-smoke
curl -fL https://pas7.com.ua/downloads/free-claude-code/acceptance.test.mjs -o acceptance.test.mjs
fcc-claudeGeben Sie dem Agenten diese begrenzte Aufgabe:
Lies acceptance.test.mjs. Erstelle total.mjs mit dem Export totalCents(items). Jeder Eintrag hat unitCents und qty als nichtnegative sichere Ganzzahlen. Summiere ganze Cent; lehne ungültige Werte, unsichere Produkte und einen unsicheren Zwischenstand ab. Keine Abhängigkeiten. Die Testdatei nicht ändern. Führe node --test acceptance.test.mjs aus, prüfe Fehler und repariere total.mjs. Nenne abschließend den tatsächlichen Exitcode und die geänderten Dateien.Führen Sie anschließend selbst node --test acceptance.test.mjs aus. Die unveränderte Datei enthält acht Tests: einen 697-Cent-Warenkorb, leere Eingabe, Menge null, ungültige Werte und Überläufe. Prüfen Sie die entstandenen Dateien. Ein Erfolg bei diesem kleinen Beispiel kontrolliert grundlegende Werkzeugnutzung und belegt keine Produktionsqualität. PAS7s Referenzimplementierung bestand alle acht Tests lokal ohne Modellanfrage.
Gleichen Sie für den Routennachweis den Zeitpunkt mit FCCs Anbieter-/Modellprotokoll und gegebenenfalls der Nutzungsansicht des Anbieters ab. Prüfen Sie jeden Anbieter einzeln, bevor Sie dem automatischen Ersatz vertrauen. Ein Verbindungsfehler weist auf den Server, 401 auf Authentifizierung, 429 auf Kapazität und ein fehlendes Modell auf den aktuellen Katalog. Bei 402 sollte das $0-Experiment für eine Abrechnungs- und Routingprüfung stoppen, anstatt automatisch Guthaben aufzuladen.
Warum „Sonnet 5“ und ein Dollarzähler erscheinen können
Eine Sonnet-Bezeichnung im Client kann die angeforderte Modellstufe oder einen Kompatibilitätsalias beschreiben. FCC ordnet solche Anfragen konfigurierten Anbietern und Modellen zu; aktuelle Versionen unterstützen außerdem die Modellermittlung über das Gateway. Zeigt Ihre Version „Sonnet 5“, beweist der Name allein weder eine Antwort von Anthropic noch Sonnet-Fähigkeiten des Ersatzmodells. Auch die Selbstauskunft des Modells ist schwache Evidenz. Prüfen Sie die aufgelöste Route. [1]
Bei Geldbeträgen gilt eine ähnliche Unterscheidung. Die aktuelle Claude-Code-Dokumentation erklärt, dass /usage Sitzungsdollar lokal aus Tokenzahlen und Listenpreisen berechnet, sofern keine andere Preistabelle gilt. Ältere Versionen zeigen /cost. Die Clientschätzung kann deshalb steigen, während der kostenlose Endpunkt des Anbieters keine Inferenzgebühr verursacht. Für die Abrechnung zählen Nutzungsnachweis des Anbieters und konfigurierte Route. Eine tatsächliche Abbuchung, ein kostenpflichtiger Fallback oder eine separate direkte Claude-Sitzung sollte nicht als harmloser Anzeigefehler abgetan werden. [2][8]
Wo das Versprechen von 1,3 Milliarden Token endet
FCC wirbt mit über 1,3 Milliarden kostenlosen Token innerhalb seines Anbieterangebots. Das geprüfte README liefert kein nachvollziehbares persönliches Monatskontingent für das Paar NVIDIA und OpenRouter. Deshalb bleiben die veröffentlichten Einheiten bei den jeweiligen Grenzen. [1][4][6][13]
| Route | Veröffentlichtes Anfragelimit | Bedeutung für diese Anleitung |
|---|---|---|
| Kostenloser gehosteter NVIDIA-Endpunkt | Veröffentlichte Grenze: 40 Anfragen/Minute | Modellzugang, Kontobedingungen und aktuelle Drosselung gelten weiterhin |
| OpenRouter ohne Guthabenkauf | 20 Anfragen/Minute; 50/Tag | Der Weg ohne Aufladung |
| OpenRouter nach insgesamt $10 Guthabenkäufen | 20 Anfragen/Minute; 1.000/Tag | Kostenlose Modellaufrufe können $0 kosten; diese Stufe erfordert vorherige Ausgaben |
Aufgaben aus Anfragen planen, dann Token schätzen
Unser Planungsbeispiel: 50 Anfragen/Tag ÷ zehn Modellaufrufe/Aufgabe = fünf Aufgaben/Tag, vor weiteren Aufrufen oder Wiederholungen. Über 30 Tage ergeben 50 × 30 × angenommene 4.000 gezählte Token/Anfrage sechs Millionen Token. Sowohl die zehn Aufrufe als auch der Durchschnitt von 4.000 Token sind Annahmen, keine gemessenen Aufgaben oder Anbieterzusagen. Wiederholter Kontext kann einen großen Anteil ausmachen; die Token entsprechen nicht ausschließlich neu erzeugtem Code.
Aus einer Minutengrenze lassen sich ohne Anfragegröße, Tageslimits, Latenz, Verfügbarkeit und dauerhafte Nutzung keine Monatstoken ableiten. Eine sinnvolle Ersparnis ist eine erledigte begrenzte Aufgabe ohne Inferenzgebühr innerhalb des verfügbaren Kontingents. Zählen Sie abgenommene Änderungen und Prüfzeit neben der Tokenmenge.
1. Qualität: dieselben Werkzeuge können schlechtere Entscheidungen ausführen
Das Ersatzmodell kann größere Änderungen wählen, Werkzeugargumente falsch setzen oder zusätzliche Reparaturrunden benötigen. Beginnen Sie mit kleinen Änderungen und festen Abnahmekriterien. Vergleichen Sie Diff und Testergebnis an derselben Aufgabe, bevor Sie ein ganzes Projekt umstellen. Ein günstigerer Aufruf kann dennoch eine längere, weniger nützliche Sitzung erzeugen.
2. Halluzinationen: ein behaupteter Test ist kein Testergebnis
Verlangen Sie echte Werkzeugausgabe und Exitcode und wiederholen Sie den Test selbst. Paketnamen und API-Versionen gehören mit der Dokumentation abgeglichen. Ein plausibles „alle Tests bestanden“ ist leicht erzeugt und ersetzt kein Ausführungsprotokoll. Deshalb liegt die Testdatei unseres Beispiels außerhalb des erlaubten Bearbeitungsumfangs.
3. Kostenlose Tarife verschwinden oder laufen voll
Ein kostenloser Endpunkt kann verschwinden, sein Limit senken oder Ihre Region ausschließen. NVIDIA behält sich Dienständerungen vor; OpenRouter weist auf abweichende Verfügbarkeit kostenloser Varianten hin. Halten Sie einen separat geprüften kostenlosen Ersatz bereit und lassen Sie die Aufgabe stoppen, wenn keine Route verfügbar ist. Ersetzen Sie eine fehlende :free-Kennung nicht unbemerkt durch ihre kostenpflichtige Variante. [8][11]
4. Updates verändern die Kompatibilität
Ein Clientupdate kann Anfrageformate, Modellermittlung oder Werkzeugverhalten ändern; auch FCC und Anbieter entwickeln sich weiter. Dokumentieren Sie beide Versionen nach einem erfolgreichen Kurztest und wiederholen Sie ihn nach jedem Update einer Seite. Der geprüfte FCC-Starter deaktiviert Claudes automatisches Update im Kindprozess. Prüfen Sie daher bewusst auf unterstützte Updates, statt den Stand dauerhaft einzufrieren. Sichern Sie die Konfiguration und dokumentieren Sie das zuletzt funktionierende Versionspaar. [1]
5. Sicherheit: ein lokaler Proxy bedeutet keine lokale Inferenz
Codeausschnitte und Werkzeugergebnisse verlassen den Rechner, sobald sie an ein gehostetes Modell gehen. OpenRouter beschreibt anbieterspezifische Trainings- und Protokollregeln sowie separate Einstellungen für kostenlose Modelle. Halten Sie Geheimnisse und Kundendaten aus dem Testprojekt heraus, prüfen Sie die Datenregeln, binden Sie FCC an Loopback und aktivieren Sie bei gemeinsamem Zugriff Proxy Authentication mit einem eigenen eindeutigen Token. Die geprüften Standardwerte für Adresse und Authentifizierung machen diese Kontrolle besonders relevant. Veröffentlichen Sie Admin nicht über einen öffentlichen Tunnel, nur um die Zehn-Minuten-Einrichtung abzuschließen. [9][10]
Die Konfiguration nach der ersten abgenommenen Änderung sichern
Eine brauchbare Konfiguration hat ein dokumentiertes Client-/Proxy-Versionspaar, zwei einzeln geprüfte kostenlose Routen, ein sauberes Testergebnis und einen sichtbaren Stopp bei erschöpfter Kapazität. Beginnen Sie mit einer kleinen Repositoryänderung, deren Ergebnis Sie beurteilen können. So liefert das $0-Experiment einen Nutzen, auch wenn die beworbene Tokenmilliarde ausbleibt.