Claude Code installieren und den ersten sicheren Lauf starten
Aktuelle Anleitung für Installation, Anmeldung, Gateway-Konfiguration, sichere erste Änderung und Prüfung mit Git.
Claude Code ist der Coding-Agent von Anthropic für Terminal und Entwicklungsumgebungen. Für einen sicheren Start installieren Sie den aktuellen Client, öffnen ein kleines Testprojekt, verwenden default oder plan und prüfen jede erste Änderung mit git diff.
Wenn Sie Claude Code über eine unabhängige Pay-as-you-go API verwenden möchten, erstellen Sie Ihren eigenen Key nach der BetterToken-Claude-Code-Anleitung. BetterToken ist ein Anthropic-compatible API-Zugang für Claude Code; er aktiviert weder Claude Chat noch Cowork und ersetzt kein Claude-Abonnement.
Was Sie vor der Installation brauchen
Bereiten Sie ein Terminal, ein kleines veränderbares Git-Projekt und möglichst einen sauberen git status vor. Für die offizielle Anmeldung benötigen Sie ein unterstütztes Claude- oder Console-Konto; ein Gateway folgt einem getrennten Provider-Ablauf. Bewahren Sie Keys außerhalb von Code, Screenshots und Shell-Historie auf.
Native Install statt alter npm-Anleitung
Anthropic empfiehlt Native Install. Für macOS, Linux und WSL verwenden Sie:
Native Install ersetzt keinen Browser-Login und keine Gateway-Konfiguration; es installiert nur den Client. Andere Installationsmethoden und ihre Voraussetzungen sollten Sie in der aktuellen offiziellen Dokumentation prüfen.
Windows: PowerShell, CMD und WSL
PowerShell verwendet:
CMD verwendet:
Unter nativem Windows wird Git for Windows empfohlen, damit Claude Code Bash nutzen kann. In WSL ist Git for Windows nicht erforderlich; installieren Sie dort die Linux-Version und arbeiten Sie möglichst im WSL-Dateisystem.
Installation und Authentifizierung prüfen
Öffnen Sie nach der Installation ein neues Terminal und führen Sie aus:
Starten Sie anschließend claude und schließen Sie den offiziellen Browser-Login ab. Für einen Kontowechsel verwenden Sie /login in der Sitzung. Eine API Key gehört nie in einen normalen Prompt oder in das Repository.
Drittanbieter-Gateway korrekt einrichten
Ein Gateway benötigt API Key, unterstützten Model-Namen und die passende Base URL. Bei BetterToken verwenden Sie die aktuelle Anleitung und die Anthropic-compatible Base URL https://bettertoken.ai. Diese Base URL ist nicht die rohe Messages-HTTP-URL: der Client ergänzt den Protokollpfad selbst. Prüfen Sie nach einer Änderung einen kleinen Request, statt Key, Modell und URL gleichzeitig zu ändern.
Erstes Projekt und reine Leseaufgabe
Bitten Sie zuerst: „Erkläre Struktur, Einstiegspunkt und Startbefehl. Ändere keine Dateien und führe keine Netzwerkbefehle aus.“ Plan mode erlaubt Lesen und Erkundungsbefehle, bearbeitet aber keine Quelldateien.
Eine kleine, reversible erste Änderung
Nach dem Plan erlauben Sie eine Datei, etwa:
Prüfen Sie die angeforderte Aktion und danach:
Kontrollieren Sie Dateigrenze, Inhalt, Secrets und unerwartete Konfigurations- oder Abhängigkeitsänderungen.
Berechtigungsmodi und Sicherheitsgrenzen
default erlaubt Lesen ohne Nachfrage und fragt vor Änderungen oder Befehlen. plan erforscht und plant ohne Source-Edits. acceptEdits automatisiert Edits und übliche Dateisystemaktionen; auto ist ein Research Preview mit Hintergrundprüfungen. bypassPermissions gehört nur in isolierte Container oder VMs. Für den ersten Lauf verwenden Sie default oder plan, nicht globale Auto-Freigaben.
Ergebnis und Gateway-Nutzung verifizieren
Ein erfolgreicher erster Lauf bedeutet: richtige Arbeitsmappe, erfolgreiche Anmeldung oder Provider-Anfrage, nur die erlaubte Datei geändert und ein nachvollziehbarer Diff. Bei BetterToken prüfen Sie zusätzlich Modell, Status sowie Input-, Output- und Cache-Token in Dashboard und Usage History. Das bestätigt API-Verbindung, nicht die Entitlements von Chat oder Cowork.
Fehler nach Ebene beheben
Bei claude: command not found öffnen Sie ein neues Terminal und nutzen die offizielle Installationshilfe statt einer alten npm-Anleitung. Scheitert der Login, unterscheiden Sie Claude-Login, Console/API und Gateway-Konfiguration. Bei Provider-Fehlern prüfen Sie zuerst Key, dann Base URL, dann Model-ID. Bearbeitet Claude zu viel, brechen Sie ab, starten in Plan mode und nennen Sie genau eine erlaubte Datei, keine Netzwerknutzung und kein Commit.
Nächste Schritte und Quellen
Nach einem sauberen README-Diff können Sie einen Test, einen kleinen Fehler oder eine Dokumentation ändern. Erhöhen Sie Umfang und Autonomie einzeln; remote Systeme, Deployments und APIs lassen sich nicht wie lokale Dateiänderungen zurückdrehen.