Installation von Claude Code und der erste Befehl

Claude im Browser redet. Claude Code im Terminal arbeitet an deinen Dateien – in einem Ordner, auf den du es ansetzt, auf deinem eigenen Rechner. Diese Lektion führt an genau eine Stelle: Claude Code installiert, angemeldet und mit einer Antwort auf deine erste Anweisung in deinem eigenen Ordner.

Wir arbeiten dabei im Terminal, und das ist der Teil, der am meisten abschreckt. Deshalb gleich vorweg: je nach Konfiguration deines Systems können ein paar zusätzliche Befehle nötig sein – zum Glück ist jeder davon nur wieder Kopieren-Einfügen. Du musst weder das Terminal noch seine Befehle kennen.

Wenn irgendwann etwas anders aussieht als beschrieben – keine Panik und nichts überstürzt schliessen. Fast jede Meldung im Terminal lässt sich in Ruhe lesen, und kaum eine bedeutet, dass etwas kaputtgegangen ist.

Was du bereitlegen solltest

Drei Dinge, alle in einer Minute geprüft:

1. Ein Claude-Konto mit Pro-Plan oder höher. Claude Code läuft nicht im Gratisplan – das ist keine Einstellung, die man suchen müsste, sondern eine Plangrenze. Noch kein Konto? Dann fang mit der Lektion zum Anlegen des Kontos an und komm danach hierher zurück.
2. Ein Rechner mit einem System, das Claude Code unterstützt. macOS ab Version 13, Windows 10 ab Update 1809, Ubuntu ab 20.04. Praktisch gesagt: wenn dein System in den letzten Jahren Updates bekommen hat, passt es.
3. Eine Internetverbindung. Das Installationsprogramm lädt Dateien aus dem Netz, offline geht also nichts (wir schreiben das nur zur Sicherheit – falls jemand Claude Code ausgerechnet am Ende der Welt installieren will, ganz ohne Empfang).

Ausser Claude Code selbst musst du nichts zusätzlich installieren, um loszulegen – dieser eine Schritt reicht. Ausnahme: manchmal siehst du den Vorschlag, zusätzlich Git zu installieren. Für Claude Code ist das nicht nötig, wir empfehlen aber, zuzustimmen – Git ist bei der Arbeit mit Code nützlich, und unter Windows bekommt Claude Code damit zusätzlich einen komfortableren Zugang zum Terminal (Bash statt nur PowerShell).

Es gibt auch einen Weg ohne Terminal: Claude Code hat eine Desktop-App mit Fenster und Schaltflächen, herunterladbar für macOS, Windows und Linux. Wenn das Terminal in dir blanken Widerstand auslöst, ist das eine durchaus mögliche Alternative. Diese Lektion geht trotzdem den Terminalweg, weil fast alles, was du später über Claude Code liest – in der Dokumentation, in Blogs, hier – genau diesen voraussetzt. Die meisten Befehle, die du hier lernst, funktionieren auch in der Desktop-Version ähnlich.

Finde das Terminal auf deinem Rechner

Ein Terminal ist ein Fenster mit einem blinkenden Cursor, der darauf wartet, dass du etwas schreibst – die genauen Farben und das Aussehen hängen vom Programm und vom Motiv ab (mal schwarz, mal weiss, der Cursor mal ein Strich, mal ein Block), aber dieser blinkende Cursor ist überall da. Am wichtigsten ist, dass du es fast nur mit der Tastatur bedienst – die Maus kann dort nur wenig ausrichten, und wie viel genau, hängt vom jeweiligen Terminal und seiner Version ab.

So öffnest du es:

• Windows: Drück Windows, tipp PowerShell, klick das erste Ergebnis an. Es öffnet sich ein Fenster, in dem am Zeilenanfang PS C:\Users\ und dein Benutzername stehen. Findet die Suche nichts, lässt sich PowerShell gratis aus dem Microsoft Store nachinstallieren.
• macOS: Drück Command+Leertaste, tipp Terminal, drück Enter.
• Linux: Drück Ctrl+Alt+T.

Tipp noch nichts ein. Ein offenes Terminalfenster tut von sich aus nichts, und dadurch, dass es offen dasteht, lässt sich nichts kaputt machen.

Füge einen Befehl ein und warte

Jetzt dieser eine Befehl. Kopiere die ganze Zeile, die zu deinem System passt, und füge sie im Terminal ein. Meistens funktioniert Ctrl+V (auf macOS Command+V), aber nicht in jedem Terminal – passiert nichts, oder siehst du statt des Befehls seltsame Zeichen wie ^[[200~, versuch einen Rechtsklick: manchmal fügt er sofort ein, manchmal öffnet sich ein Menü, aus dem du Einfügen wählst.

Windows, in PowerShell:

irm https://claude.ai/install.ps1 | iex

macOS und Linux:

curl -fsSL https://claude.ai/install.sh | bash

Drück Enter. Eine Weile laufen Textzeilen durch – das ist normal, das Installationsprogramm lädt Dateien herunter und schreibt dabei, was es tut. Lesen musst du davon nichts.

Zwei Meldungen, die hier manchmal auftauchen, und was sie bedeuten:

• The token '&&' is not a valid statement separator – das ist der Befehl für eine andere Art Fenster, nicht die, in der du gerade bist. Prüf, ob die Zeile mit PS beginnt, und nimm die Fassung, die zu dem passt, was du siehst.
• 'irm' is not recognized – genau umgekehrt: dieses Fenster ist kein PowerShell. Schliess es und öffne PowerShell wie oben beschrieben.

Beides macht nichts kaputt. Es wurde einfach nichts installiert, und du versuchst es erneut.

Prüf, ob es geklappt hat

Wenn der Durchlauf endet und der Cursor wieder blinkt, tippe:

claude --version

Du siehst eine Versionsnummer, etwa 2.1.219 (Claude Code). Deine wird anders und höher sein – Claude Code aktualisiert sich im Hintergrund selbst, das gehört so.

Kommt statt einer Nummer command not found oder «wird nicht als Befehl erkannt», liegt das meistens daran, dass das Terminal noch den Zustand von vor der Installation kennt. Schliess das Terminalfenster, öffne ein neues und versuch es nochmals. Das hilft in den meisten Fällen.

Hat das nicht geholfen, ist Claude Code wahrscheinlich korrekt installiert, aber das Terminal weiss noch nicht, wo es zu finden ist. Ein Befehl behebt das, für dein System:

Windows (PowerShell):

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

macOS (Zsh):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Linux (Bash):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Schliess das Terminal, öffne es erneut und prüf claude --version nochmals.

Noch ein Befehl, den du dir für später merken solltest:

claude doctor

claude doctor gibt eine Diagnose von Installation und Konfiguration samt Lösungsvorschlägen aus, ohne eine Sitzung zu starten. Heute brauchst du nichts davon. In einem Monat, wenn sich etwas seltsam verhält, ist es die erste Stelle zum Nachschauen.

Öffne deinen Ordner

Der Start in einem bestimmten Ordner ist der Kern der ganzen Installation, deshalb lohnt sich ein kurzer Halt. Claude Code arbeitet standardmässig in dem Ordner, in dem du es startest, und verlässt ihn nicht – ausser du bittest es ausdrücklich darum.

Im Terminal wechselst du mit dem Befehl cd und einem Pfad in einen Ordner. Am einfachsten so: tippe cd , also diese zwei Buchstaben und ein Leerzeichen, und zieh dann den Ordner aus dem Dateiexplorer direkt auf das Terminalfenster. Der Pfad schreibt sich von selbst. Drück Enter.

Leg dir einen festen Ordner für die Projekte an, in denen du mit Claude Code arbeitest – am besten mit einem einfachen Namen wie AI – statt jedes Mal einen neuen Ort zu suchen. Bei solchen Ordnernamen lässt du Leerzeichen besser weg: schreib claude-code statt claude code. Das Terminal kommt zwar auch mit einem Leerzeichen zurecht, braucht dafür aber zusätzliche Tricks (Anführungszeichen, Escape-Zeichen), während ein Bindestrich immer ohne Komplikationen funktioniert.

Melde dich an und starte Claude Code

Starte jetzt Claude Code in dem Ordner, in dem du mit AI arbeiten willst:

claude

Beim ersten Start bittet Claude Code um die Anmeldung. Zuerst fragt es nach der Art des Kontos – wähl «Claude account with subscription». Das ist das Konto, das du in der Lektion zum Anlegen des Kontos angelegt haben solltest; die zweite Option, «Anthropic Console account», ist eine separate, seltener genutzte Abrechnungsart für die API – nicht das, was du hier brauchst. Danach öffnet sich der Browser – melde dich mit demselben Claude-Konto an, das du auf claude.ai nutzt, und bestätige den Zugriff. Zurück im Terminal sollte die Anmeldung schon durch sein.

Öffnet sich der Browser nicht von selbst, gibt das Terminal eine Adresse zum Kopieren aus. Füg sie von Hand im Browser ein, das Ergebnis ist dasselbe. Manchmal wird so ein Link beim Einfügen auf mehrere Zeilen aufgeteilt und funktioniert dann einfach nicht – falls das passiert, füg ihn zuerst in einen einfachen Texteditor ein, schalte dort den Zeilenumbruch aus (damit du siehst, wo die echten Umbrüche liegen), füg ihn wieder zu einer Zeile zusammen und bring ihn erst dann in den Browser.

Angemeldet wird einmal. Bei den nächsten Starts läuft Claude Code einfach los.

Gleich nach der Anmeldung tauchen vielleicht noch zwei kurze Fragen auf. Erstens: ob du den Dateien in diesem Ordner vertraust – wähl «Yes, proceed», sonst kommt Claude Code nicht weiter. Zweitens: welches Farbmotiv du willst (hell oder dunkel, dazu Varianten mit stärkerem Kontrast) – wähl das, das zum Hintergrund deines Terminals passt, damit der Text lesbar bleibt. Beide Entscheidungen sind umkehrbar: das Motiv änderst du später mit /theme (oder über /config), und auch das Vertrauen zum Ordner lässt sich in den Einstellungen wieder zurücknehmen.

Schick die erste Anweisung

Schreib deine erste Anweisung als ganz normalen Satz. Zum Beispiel:

Schau dich in diesem Ordner um und sag mir in drei Sätzen, was darin liegt.

Claude liest den Inhalt des Ordners und antwortet. Das ist der Unterschied, um den es bei Claude Code geht: du fügst ihm keine Dateien ein, du zeigst ihm ein Verzeichnis.

Zwei Dinge fallen in dieser Antwort auf. Erstens ist die Oberfläche auf Englisch, während das Gespräch der Sprache folgt, in der du schreibst – da gibt es nichts einzustellen. Zweitens fragt Claude Code um Erlaubnis, bevor es etwas ändert. Lesen macht es allein, Änderungen legt es dir zur Bestätigung vor.

Zum Beenden tippst du /exit (auch einfach exit, ohne Schrägstrich, funktioniert) oder drückst zweimal Ctrl+C.

Was sich gleich danach lohnt

Die Installation ist fertig, und du kannst das Terminal ruhig schliessen. Eine Sache bleibt, solange alles frisch ist: die Einstellungen mit /config öffnen und nachsehen, auf welchem Modell und welcher Effort-Stufe du arbeitest.

Ausgeschrieben wird das hier nicht – dazu haben wir einen eigenen Beitrag, was du im Config änderst und was du lässt – es genügt zu wissen, dass es diesen Befehl gibt und dass am ersten Tag nichts geändert werden muss. Die Standardwerte sind sinnvoll und ein guter Ausgangspunkt.

Die zweite Sache, die schneller nützlich wird, als man denkt: Claude Code kann zu Beginn jeder Sitzung eine Datei mit deinen ständigen Anweisungen lesen. Sie heisst CLAUDE.md und hat hier eine eigene Lektion. Jetzt brauchst du sie noch nicht.

Du kannst dein Terminal auch so einstellen, dass es jedes Mal in genau diesem Ordner aufgeht – dazu haben wir einen eigenen Tipp geschrieben. Dann fällt das tägliche cd beim Start weg, und um die Einstellung selbst bittest du Claude Code, ohne irgendwo in der Konfiguration zu suchen.

Aufgaben

Hak ab, was du erledigt hast. Der Stand wird im Browser gespeichert, du kannst also morgen zu dieser Liste zurückkommen.

• Claude-Konto mit Pro-Plan oder höher
• Terminal auf meinem Rechner geöffnet
• Installationsbefehl eingefügt und durchgelaufen
• claude --version gibt eine Versionsnummer aus
• cd in den eigenen Ordner (am besten AI, ohne Leerzeichen im Namen)
• Anmeldung im Browser vollständig durchlaufen, Ordner als vertrauenswürdig markiert
• Erste Anweisung abgeschickt, Antwort erhalten
• Ich weiss, dass es /config gibt und dass ich heute nichts ändern muss