Kürzlich haben mich viele Freunde gefragt, ob ich ein Einsteiger-Tutorial für Claude Code veröffentlichen könnte.
Sie möchten auch das leistungsstärkste Agent-Produkt der Welt nutzen.
Eigentlich ist vielen nicht bewusst, dass Agent-Produkte im Allgemeinen aus einem Agent-Framework und einem Modell bestehen. Die Modelle von Claude werden in China tatsächlich häufig blockiert und sind sehr schwer zu handhaben; ich habe keine Möglichkeit, jedem zu zeigen, wie man das behebt.
Aber Claude Code wird nicht blockiert oder unbrauchbar, weil es eigentlich ein Agent-Framework ist, das mit jedem Modell verwendet werden kann.
Obwohl Anthropic mit ständigen Account-Sperren und Echtnamen-Authentifizierung ziemlich nervig sein kann, muss ich zugeben, dass das beste Agent-Framework der Welt derzeit Claude Code ist.
Deshalb sage ich immer: Wenn du es in einem Schritt richtig machen kannst, dann tu es. Ich weiß, dass Dinge wie OpenClaw und Hermes Agent jetzt sehr beliebt sind, aber ich empfehle trotzdem, Claude Code zu verwenden. Selbst wenn du die nativen Modelle von Claude nicht nutzen kannst, liefert die Kombination mit einem inländischen Modell immer noch hervorragende Ergebnisse.
Außerdem musst du dir keine Sorgen um Account-Sperren, ausländische Telefonnummern, Visa-Karten oder die Verwendung eines VPNs machen.
Also, hier ist heute ein umfassendes Einsteiger-Tutorial für Claude Code von Grund auf. Ich habe Anleitungen für Windows und Mac vorbereitet, mit und ohne VPN, damit jeder den Teil finden kann, den er braucht.
Der folgende Installationsprozess wurde von mir und meinem Team über ein ganzes Wochenende auf fünf oder sechs Computern getestet, mit wiederholten Installationen und Deinstallationen.
Zum Beispiel gibt es in Szenarien ohne VPN andere Installationsmethoden wie npm oder die Verwendung inländischer Mirror-Quellen über curl. Diese Methoden funktionieren, aber sie waren in meinen Tests auf verschiedenen Computern nicht stabil genug.
Also habe ich mich schließlich für die Methode entschieden, die meiner Meinung nach am einfachsten ist und am wenigsten wahrscheinlich selbst auf einem sehr "sauberen" Computer fehlschlägt.
Ich hoffe nur, dass jeder erfolgreich das leistungsstärkste Agent-Framework der Welt nutzen kann, indem er diesem Artikel folgt.
Ich werde jeden Schritt so klar und so detailliert wie möglich erklären. Es könnte etwas langatmig werden, also bitte habt Geduld mit mir.
Okay, los geht's.
I. Claude Code Installation
1. Mac
Schauen wir uns zuerst Mac an. Windows-Benutzer können diesen Teil überspringen und das Windows-Tutorial weiter unten finden.
Öffne zuerst das Terminal in deinen Apps.
Lass uns unseren heutigen Hauptdarsteller installieren, Claude Code.
Ich habe für meinen Computer ein brandneues macOS-Konto erstellt, das im Grunde einem sauberen Computer entspricht, für diese Demonstration.
Zuerst sprechen wir über den Fall mit einem VPN.
Der Befehl ist nur eine Zeile:
Füge diesen Befehl in das Terminal ein und drücke die Eingabetaste.
Warte einen Moment, und du wirst eine erfolgreiche Installation sehen.
Obwohl es installiert ist, könnte es hier eine Eingabeaufforderung geben.
Es bedeutet, dass Claude Code installiert ist, aber der Installationsort ~/.local/bin wurde noch nicht zu deiner PATH-Umgebungsvariable hinzugefügt, sodass die direkte Eingabe von claude den Befehl möglicherweise nicht findet.
Es heißt, um dies zu lösen, führe den unten angegebenen Befehl aus.
Wenn du es nicht verstehst, ist das in Ordnung. Tu einfach, was es sagt: Kopiere diesen langen echo-Befehl, den es dir gegeben hat, in das Terminal und führe ihn aus.
Gib dann claude --version ein. Wenn eine Versionsnummer ausgegeben wird, war die Installation erfolgreich.
Die Situation mit einem VPN ist sehr einfach, aber ich weiß, dass viele Studenten keins haben.
Wenn du also kein VPN hast, können wir es über Homebrew installieren.
Homebrew ist der beliebteste Kommandozeilen-Paketmanager für macOS. Damit kannst du verschiedene Software und Entwicklungstools mit einem einzigen Befehl installieren, aktualisieren und deinstallieren.
Ich habe mir einen neuen Computer von einem Kollegen geliehen; er hat kein VPN und eine sehr saubere Umgebung.
Lass uns zuerst brew installieren. Es mag kompliziert aussehen, aber es ist eigentlich sehr einfach, wenn du mitmachst.
Füge den folgenden Befehl in die Kommandozeile ein und drücke die Eingabetaste:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.shhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))"
Drücke nach der Eingabeaufforderung einfach die Eingabetaste.
Dann wird es eine Weile laufen.
Warte geduldig ein paar Minuten. Wenn es fertig ist und "installation successful" anzeigt, bist du fertig.
Als nächstes müssen wir Homebrew zu den Pfadvariablen hinzufügen, damit das Terminal den Befehl finden kann, wenn wir ihn verwenden.
Füge diese paar Befehlszeilen in das Terminal ein und führe sie einmal aus.
Jetzt können wir Homebrew verwenden, um Mac-Pakete zu verwalten.
Verwende als nächstes den folgenden Befehl, um Claude Code zu installieren. Da der Editor möglicherweise etwas Text automatisch formatiert, könnte direktes Kopieren und Einfügen zu Fehlern führen. Bitte gib es manuell ein oder bitte Claude, das Format zu korrigieren, bevor du es in das Terminal einfügst:
brew install --cask claude-code@latest
Die Installationsgeschwindigkeit ist hier etwas langsam; du kannst eine Pause machen und wiederkommen, wenn es fertig ist.
Sobald die Erfolgsmeldung erscheint, gib claude im Terminal ein, und du wirst die kleine Krabbe sehen.
Es wird jedoch anzeigen, dass es vorerst nicht verwendbar ist. Das kannst du ignorieren; ich werde dir gleich zeigen, wie du ein Modell anschließt.
Nachdem wir Mac behandelt haben, sprechen wir separat über Windows. Es ist etwas anders. Mac-Benutzer, die fertig sind, können diesen Teil überspringen.
2. Windows
Jetzt zu Windows.
Ich habe einen frisch zurückgesetzten Windows-Computer für die Installation verwendet.
Da Claude Code intern Befehle unter Windows mit Git Bash ausführt, musst du zuerst Git installieren, um Claude Code unter Windows zu verwenden.
Also, Schritt eins: Git installieren.
Freunde, die es bereits installiert haben, können diesen Teil überspringen.
Verwende WinGet, um es zu installieren. Dies ist der offizielle Windows-Paketmanager, der als Windows-Version von Homebrew betrachtet werden kann.
Suche in der Taskleiste nach "Terminal" und öffne es.
Füge den folgenden Befehl in das Terminal ein. Die Installation wird viel schneller sein, wenn du hier kein VPN verwendest.
winget install Git.Git
Sobald es fertig ist, wird eine erfolgreiche Installation angezeigt.
Sobald Git installiert ist, sprechen wir wie üblich über den Fall mit einem VPN.
Für Freunde mit einem VPN verwenden wir weiterhin den offiziellen nativen Installationsbefehl.
Füge den Befehl in das Terminal ein:
Warte einen Moment, und es wird installiert.
Sehr praktisch.
Wenn du kein VPN hast, müssen wir WinGet verwenden, um es zu installieren.
Führe diesen Befehl im Terminal aus:
winget install Anthropic.ClaudeCode
Nach erfolgreicher Installation kannst du auch claude eingeben, um zu sehen, dass es installiert wurde.
An diesem Punkt sollte dich die Eingabe von claude im Terminal theoretisch zur Claude Code-Seite führen.
Aber.
Wir haben nur das Framework installiert; wir haben ihm noch kein "Gehirn" gegeben, also ist es nicht nutzbar.
Als nächstes müssen wir sein Gehirn anschließen.
II. Das Modell anschließen
Wenn du ein Claude-Konto hast, melde dich einfach direkt an. Ich werde hier nicht ins Detail gehen.
Denn theoretisch würdest du dieses Einsteiger-Tutorial nicht lesen, wenn du bereits ein Claude-Konto hättest...
Um sicherzustellen, dass alle inländischen Freunde es nutzen können, verwende ich das inländische Modell GLM-5.1 als Beispiel.
GLM-5.1 ist derzeit das inländische Modell, das ich verwendet habe und das sich am nächsten an der Claude Opus 4.6-Erfahrung anfühlt.
Natürlich, wenn du ihren Coding-Plan nicht erwischt hast, sind MiniMax M2.7 und K2.5 auch gut. K2.6 Code sollte bald kommen, und ich habe das Gefühl, dass Kimi einen Sprung machen wird; ich empfehle, die Augen offen zu halten.
Bezüglich GLM-5.1 bietet Zhipu offiziell einen Einzeiler-Befehl zur Installation an, der sehr einfach ist:
Um es jedoch für alle einfacher zu machen, andere Modelle anzuschließen und frei zu wechseln, zeige ich dir eine universellere Methode: die Verwendung von CC Switch.
Wieder unterteilt in Mac und Windows.
1. Mac
Auf dem Mac besteht die Installation aus nur zwei Befehlen. Der zweite Befehl könnte aufgrund der Formatierung ebenfalls einen Fehler verursachen, wenn er direkt kopiert und eingefügt wird. Bitte gib ihn manuell ein oder bitte Claude, ihn zu korrigieren, bevor du ihn einfügst:
brew tap farion1231/ccswitch
brew install --cask cc-switch
Füge es in das Terminal ein und drücke die Eingabetaste.
Sobald es installiert ist, bist du fertig.
2. Windows
Für Windows empfehle ich, das Installationspaket direkt über den folgenden Link herunterzuladen:
https://github.com/farion1231/cc-switch/releases
Wenn du nicht auf GitHub zugreifen kannst, habe ich auch ein lokales Installationspaket vorbereitet. Antworte im offiziellen Account-Hintergrund mit "cc", und es wird dir automatisch den Download-Link senden.
Nach dem Herunterladen doppelklicken, um es auszuführen, und du kannst bis zum Ende der Installation auf "Weiter" klicken.
Die nachfolgenden Schritte sind für Mac und Windows gleich, also werde ich sie nicht trennen.
Öffne es nach der Installation.
Du kannst sehen, dass dieses Tool nicht nur für Claude Code ist; Codex und Xiaolongxia können es auch verwenden.
Da wir es noch nicht konfiguriert haben, gibt es derzeit nur offizielle Claude-Modellkonfigurationen.
Klicke unter der Claude-Spalte auf das Pluszeichen in der oberen rechten Ecke, um eine neue Modellkonfiguration hinzuzufügen.
Wähle dann das Modell aus, das du verwenden möchtest. Hier habe ich die GLM-Inlandsversion ausgewählt.
Als nächstes musst du nur zwei Teile ausfüllen: den API-Schlüssel (wenn du nicht weißt, was ein API-Key ist, kannst du jede KI fragen, auf die du Zugriff hast, und sie wird dir helfen) und die Modellkonfiguration. Alles andere wird automatisch ausgefüllt.
Klicke nach dem Ausfüllen unten rechts auf "Hinzufügen".
Es wird zu dem von uns konfigurierten Modell wechseln.
An diesem Punkt sind die Installation von Claude Code und der Anschluss von GLM-5.1 abgeschlossen.
III. Claude Code starten
Gehe zurück zum Terminal, gib claude ein und drücke die Eingabetaste.
Du kannst Claude Code jetzt normal starten.
Beim ersten Mal gibt es einige Initialisierungseinstellungen.
Zum Beispiel den Farbmodus. Unter den Modi gibt es eine Code-Vorschau; wähle nach deinem Geschmack und drücke die Eingabetaste.
Wenn du es später ändern möchtest, führe /theme innerhalb von Claude Code aus.
Als nächstes kommt der Sicherheitshinweis.
Zwei Hauptpunkte:
Einer ist, dass Claude Fehler machen kann. Du solltest den Code, den es generiert, und die Befehle, die es ausführen möchte, überprüfen, bevor du sie durchlässt.
Einer ist, Claude Code nur in Codebasen zu verwenden, denen du vertraust, um Prompt-Injection-Angriffe zu vermeiden.
Drücke die Eingabetaste, um zum nächsten Schritt zu gelangen.
Es fragt, ob wir die Terminaleinstellungen von Claude Code verwenden möchten.
Hier verwendest du einfach die empfohlenen Terminaleinstellungen.
Eigentlich möchte es dir helfen, zwei Dinge zu aktivieren:
Tastenkombinationen, um Zeilenumbrüche im Terminal zu erreichen.
Und Visual Bell, eine visuelle Aufforderung.
Das heißt, wenn Claude eine Aufgabe beendet hat oder deine Bestätigung benötigt, blinkt das Terminalfenster und das Dock-Symbol hüpft, um dich zu erinnern.
Der letzte Schritt ist die Bestätigung, ob das aktuelle Verzeichnis vertrauenswürdig ist.
Wähle "Ja" und drücke die Eingabetaste.
Wir sind endlich an der Dialogschnittstelle von Claude Code angelangt, die mit GLM-5.1 verbunden ist.
Wenn du später das Modell wechseln möchtest, konfiguriere sie in CC Switch und verwende /model in Claude Code, um zu wechseln.
An diesem Punkt sind alle Installations- und Verbindungsvorgänge abgeschlossen.
Für die zukünftige Verwendung gib einfach claude im Terminal ein.
Ich empfehle die Verwendung des folgenden Befehls, besonders während der Entwicklung, sonst wirst du durch ständiges Klicken auf "Erlauben" deine Lebensentscheidungen hinterfragen:
claude --dangerously-skip-permissions
Wenn wir es starten, müssen wir es aufgrund des Kontextdesigns gegen einen Ordner starten, um es eingeschränkt und fokussiert zu halten, anstatt Claude Code direkt im Stammverzeichnis zu starten.
Ich habe meine Verzeichnisse aufgeteilt; "Dokumente" ist der Ort, an dem ich Wissenskreation betreibe.
Es gibt auch einen "code"-Ordner, der verschiedene Produkte enthält, die ich selbst entwickelt habe.
Claude Code für einen bestimmten Ordner in der Befehlszeile zu starten, ist auch sehr einfach.
Es ist der cd-Befehl, der für Mac und Windows gleich ist.
Wenn ich zum Beispiel in den Ordner "Wissensdatenbank" gehen möchte, um Inhalte zu erstellen:
Öffne das Terminal, gib cd ein, denke daran, einmal die Leertaste zu drücken, und ziehe dann deinen Ordner direkt hinein.
Drücke die Eingabetaste, und du bist in diesem Ordner.
Verwende dann den Befehl, um Claude Code zu starten.
Du wirst in diesen Ordner gelangen, und es wird standardmäßig nur in diesem Ordner arbeiten und alle darin enthaltenen Dateien lesen.
Dies führt tatsächlich zu weniger Kontextverschmutzung und mehr Fokus – mit anderen Worten, es ist intelligenter.
IV. CLAUDE.md schreiben
Nachdem du gelernt hast, wie man es startet, kannst du offiziell mit dem Dialog beginnen und es arbeiten lassen.
Aber es gibt einen Standard und eine sehr wichtige Gewohnheit, die du vor der intensiven Nutzung festlegen musst. Tappe nicht in die alten Fallen, die ich hatte: Definiere zuerst deine CLAUDE.md-Datei.
Meiner Meinung nach ist dies sogar das Erste, was du tun solltest, nachdem du gelernt hast, wie man Claude Code startet.
Bevor ich auf den spezifischen Schreibstil eingehe, lass mich erklären, was CLAUDE.md ist.
Dieses Ding ist nicht nur eine Datei; es ist ein hierarchisches Constraints-System von oben nach unten.
Wie dieses Bild, das ich zuvor verwendet habe.
Nach der Installation sind die beiden Ebenen, die wir verwalten sollten, die globale CLAUDE.md und die Projekt-CLAUDE.md.
Die globale CLAUDE.md wird im Claude Code-Stammverzeichnis des Benutzerhome-Verzeichnisses abgelegt: ~/.claude/CLAUDE.md.
Sobald du Claude Code öffnest, egal in welches Projekt du gehst, wird es automatisch geladen und befolgt.
Dies ist seine oberste Spezifikation.
Es löst Probleme wie: Wer bist du, was sind deine Prinzipien bei der Arbeit und wie möchtest du, dass es mit dir zusammenarbeitet.
Die Projekt-CLAUDE.md wird im Stammverzeichnis jedes Projekts abgelegt: project_directory/CLAUDE.md.
Sie wird nur geladen, wenn du dieses Projekt öffnest.
Sie löst das Problem, wie dieses spezifische Projekt durchgeführt werden soll und welche speziellen Vereinbarungen auf dieser Ebene bestehen.
Lass uns zuerst über die globale CLAUDE.md sprechen, die als Erstes geklärt werden muss. Aber viele sind sich nicht sicher, was sie schreiben sollen, wie sie es schreiben sollen, wie lang es sein soll oder wo sie es ablegen sollen. Für Nicht-Entwickler teile ich meine Erfahrung.
Was die Länge betrifft, ist CLAUDE.md nicht besser, wenn es länger ist; stattdessen sollte es so prägnant wie möglich sein.
Wenn deine CLAUDE.md zu lang ist, wird sie den Inhalt in der zweiten Hälfte einfach ignorieren.
Die spezifische rote Linie ist: Jenseits von 80 Zeilen beginnt Claude, einige Inhalte zu übersehen. Überschreite niemals 200 Zeilen.
In einem früheren Artikel habe ich dir gezeigt, was in meiner globalen CLAUDE.md-Datei steht.
Basierend auf meinen Inhalten habe ich iteriert und eine Vorlage für dich vorbereitet.
Sie enthält Dinge, die ich für eine gute globale CLAUDE.md für wichtig halte.
Du musst nur deine eigenen Inhalte im Abschnitt "Über mich" schreiben; der Rest kann im Grunde direkt wiederverwendet werden.
Über mich [Dein Name / Identität / beruflicher Hintergrund, wenn du kein Programmierer bist, musst du es angeben]. Ich verwende Claude Code für [Spezifische Verwendung 1] und [Spezifische Verwendung 2].
Denkprinzipien: Alle Entscheidungen gehen vom Wesen des Problems aus, kopiere nicht nur, weil "das die Konvention ist". Gehe zurück zum Problem selbst: Was muss gelöst werden? Was ist der direkteste Weg? Wie würde es von Grund auf neu entworfen werden? Schmeichle nicht. Lobe meine Ideen nicht, sage nicht "das ist eine sehr gute Frage", füge nicht "natürlich" am Anfang hinzu. Gib mir echte Urteile; wenn es ein Problem mit dem Plan gibt, weise direkt darauf hin. Wenn du einen besseren Weg findest, sage es direkt, ohne zu warten, bis ich frage.
Constraints zuerst: Ob es sich um ein Entwicklungsprojekt oder ein Wissensmanagementprojekt handelt, der erste Schritt ist immer, Regeln aufzustellen: Schreibe zuerst CLAUDE.md für neue Projekte und definiere strukturelle Konventionen für neue Verzeichnisse (was wohin kommt, wie zu benennen ist, wann aufzuräumen ist). Arbeite nicht in einem Arbeitsbereich ohne Spezifikationen. Halte dich bei Projekten mit bestehenden Spezifikationen strikt an die Vereinbarungen in ihrer CLAUDE.md. Wenn du Spezifikationen anpasst, ändere zuerst das Dokument, dann die Praxis, nicht umgekehrt.
Kommunikationsstil - Standardmäßig Deutsch, verwende Englisch für Code, Befehle und Variablennamen - Schlussfolgerung zuerst, dann Gründe, bereite den Hintergrund nicht vor - Bei vagen Anforderungen gib zuerst den vernünftigsten Plan, frage dann, ob Anpassungen erforderlich sind - Frage nicht "bist du sicher, dass du das tun möchtest", es sei denn, es trifft die roten Linien unten
Autonome Grenzen (Rote Linien, frage mich zuerst) Die folgenden Operationen müssen auch im Auto-Accept-Modus anhalten und mich fragen: - Löschen von Dateien, Verzeichnissen oder Git-Verlauf - Ändern von .env, Keys, Tokens, CI/CD-Konfigurationen - Datenbankschema-Änderungen oder Datenmigrationen - git push, git rebase, git reset --hard, force push - Installieren neuer globaler Abhängigkeiten oder Ändern von Systemkonfigurationen - Öffentliche Veröffentlichung (npm publish, Deployment in Produktion, Veröffentlichen von Artikeln usw.)
Allgemeine Ingenieursdisziplin - Führe nach Änderungen aktiv Verifikationen durch (siehe CLAUDE.md jedes Projekts für spezifische Befehle), ändere nicht nur, ohne zu verifizieren - Kommentiere Fehler nicht aus oder füge Umgehungsmarkierungen hinzu, nur um den Code zum Laufen zu bringen; finde die Grundursache - Keys, Tokens und Passwörter gelangen nicht in Code, Commits oder Logs - Gib vor größeren Änderungen einen Plan im Plan-Modus; fahre erst nach meiner Bestätigung fort
Insgesamt etwa 30 Zeilen, aufgeteilt in sechs Teile.
Diese sechs Blöcke haben ein gemeinsames Merkmal: Sie sind projektübergreifend universell.
Sobald die globale CLAUDE.md festgelegt ist, haben wir unsere obersten Spezifikationen.
Was die nächste Ebene betrifft, die Projekt-CLAUDE.md.
Nimm mich als Beispiel.
Ich verwende Claude Code hauptsächlich für Entwicklung und Wissensmanagement.
Zum Beispiel gibt es eine CLAUDE.md in meinem code/my-Verzeichnis. Ihre Rolle ist hauptsächlich, weil die Dinge, die ich oft im my-Ordner codiere, oft einmalige oder experimentelle chaotische Dinge sind, die eigentlich sehr klein sind, also bin ich wirklich zu faul, jedes Mal einen neuen Ordner unter my zu erstellen.
Meine derzeitige übliche Praxis ist es also, direkt mit cd in den my-Ordner zu gehen, um zu starten, und dann fröhlich meine Anforderungen zu äußern, damit er mir beim Codieren hilft. Mit dieser CLAUDE.md-Datei wird es selbst beurteilen, ob dies ein neues Produkt ist. Wenn ja, wird es direkt einen neuen Ordner für mich erstellen, um zu starten, sodass die gesamte Dateiverwaltung organisiert wird.
Und du musst diese Datei nicht einmal selbst schreiben. Öffne einfach diesen Ordner und chatte mit Claude Code. Besprich deine Anforderungen und die Dinge, die dir wichtig sind, direkt mit ihm und lass es eine für dich schreiben.
Ich habe in den letzten Tagen auch hart mit meinem Claude Code gearbeitet, um verschiedene Spezifikationen zu erstellen und die verschiedenen "Schrottberge" an Code zu organisieren, die ich zuvor hinterlassen habe.
Wenn du gerade nichts auf deinem Computer hast, ist es sogar noch bequemer.
Dies ist einer der Gründe, warum ich immer Constraints zuerst und Spezifikationen zuerst betont habe.
Sobald die Constraints festgelegt sind, kannst du wirklich anfangen zu spielen.
Was Fähigkeiten, Plugins, allgemeine Befehle und Funktionen betrifft.
Ich werde hier nicht näher darauf eingehen. Ich habe viele verwandte Artikel geschrieben; interessierte Freunde können nach den entsprechenden Schlüsselwörtern suchen.
Schlusswort
Ich habe endlich dieses längst überfällige Einsteiger-Tutorial für Claude Code beendet.
Claude Code ist das "Abschluss-Tool" der aktuellen KI-Ära, das ich dir empfehle.
Du musst nicht all diese unordentlichen Agents verwenden. Nutze Claude Code gut, und du wirst wirklich spüren, was der leistungsstärkste Agent ist.
Ich hoffe, jeder kann fröhlich kreieren.
Und in dieser Ära Werke schaffen, die dir gehören.
Deine eigenen Werke.
