Kapitel 1 handelte vom mentalen Modell. Dieses Kapitel handelt vom Anpacken. Es gibt genau ein Ziel – die erste Anweisung gegen Ihr eigenes Repository durchzubringen.
Die Befehle, die Sie tippen, sind ein paar Zeilen. Die übrige Zeit geht dafür drauf, zu verstehen, wozu Sie da eigentlich Ihre Zustimmung geben. Wer das überspringt, muss später zwangsläufig zurückspulen.
Es gibt fünf Zugänge – wo steigen Sie ein
Claude Code wird meist als „Terminal-Werkzeug“ vorgestellt, aber es gibt fünf Zugänge. Das Innere ist dasselbe, nur die Verpackung ist anders.
Das Original. Einfach claude tippen. Der Bezugspunkt dieses Kurses.
Wohnt mit im Editor. Diffs lesen Sie im gewohnten Erscheinungsbild.
Für die IntelliJ-Familie. Wer dort entwickelt, muss nirgendwohin wechseln.
Nutzbar, ohne ein Terminal zu öffnen. Den Modus wählen Sie über die Auswahl neben dem Eingabefeld.
Auch ohne lokale Entwicklungsumgebung erreichbar. Umgeschaltet wird ebenfalls über die Auswahl.
Für die erste Stunde empfehlen wir das Terminal. Der Grund ist nicht die Bequemlichkeit, sondern der Informationsgehalt. Wenn es hakt, sehen Sie die Meldungen unverfälscht, und auch die Abhilfen sind vom Terminal her geschrieben. Wie sich die in den Editor eingebauten Werkzeuge (Cursor oder GitHub Copilot) davon abgrenzen, steht in Kapitel 1 des Kurses zum KI-Coding.
Installieren
Der Standardweg ist npm. Wenn Node.js vorhanden ist, ist es mit einer Zeile erledigt (zeigt node -v eine Version an, kann es losgehen). -g bedeutet „so installieren, dass es aus jedem Ordner heraus aufrufbar ist“.
npm install -g @anthropic-ai/claude-code
claude
In Umgebungen, in denen npm an einem Proxy oder an regionalen Beschränkungen scheitert, geht die Installation über die Paketverwaltung.
brew install --cask claude-code # macOS / Homebrew
winget install Anthropic.ClaudeCode # Windows / WinGet
Entscheiden Sie sich für genau einen Installationsweg. Wer nach npm zusätzlich über Homebrew installiert, bekommt Multiple claude installations found. Ein Zustand, in dem unklar ist, welche Installation gerade läuft, macht jede spätere Eingrenzung schwer. Die Voraussetzungen unterscheiden sich je nach Umgebung – im Zweifel in die offizielle Dokumentation schauen.
Anmelden – Konto oder API-Schlüssel
Beim ersten Start wählen Sie die Anmeldeart. Mit einem Claude-Konto öffnet sich der Browser, und nach Anmeldung und Freigabe ist die Authentifizierung erledigt. Genutzt wird dabei das Kontingent Ihres Tarifs, und der Verbrauch zeigt sich als Obergrenze und Zurücksetzungszeitpunkt. Ein API-Schlüssel läuft nicht über ein Kontingent, sondern über ein Guthaben, und ist es aufgebraucht, steht alles still. Für Einzelpersonen das Erste, für CI und Automatisierung das Zweite.
Was davon Ihnen zur Verfügung steht, hängt vom Vertrag ab, deshalb legen wir uns hier nicht fest. Merken sollten Sie sich nur einen Punkt.
Ein API-Schlüssel aus einer Umgebungsvariablen hat Vorrang vor der Anmeldung mit dem Abonnement. Wenn ANTHROPIC_API_KEY noch von einem alten Versuch in der Shell-Konfiguration steht und Sie es vergessen haben, wird die korrekte Anmeldung schlicht übergangen. „Ich habe doch ein Abo, und trotzdem heißt es, das Guthaben reiche nicht“ ist meistens genau das.
Womit Sie gerade authentifiziert sind, beantwortet /status. Nachsehen, bevor Sie zweifeln.
/status # womit wird gerade authentifiziert
env | grep ANTHROPIC # steckt noch ein Schlüssel in den Umgebungsvariablen
unset ANTHROPIC_API_KEY # falls ja, entfernen. Auch aus der Konfigurationsdatei löschen
/login # neu anmelden und mit /status noch einmal nachsehen
Was beim ersten Start passiert
Ist die Authentifizierung erledigt, starten Sie, nachdem Sie in den gewünschten Arbeitsordner gewechselt sind. Claude Code betrachtet „den Ordner, in dem Sie gerade sind“ als Arbeitsgegenstand – greifen Sie daneben, beginnt es an einer völlig unbeteiligten Stelle zu lesen.
cd my-project
claude
Der Bildschirm, der auf Eingabe wartet, ist der Einstieg in den Dialog. Wir empfehlen, hier nicht gleich um eine Änderung zu bitten. Der erste Zug ist ein Auftrag, der mit reinem Lesen auskommt – „Lies die README und die wichtigsten Verzeichnisse und erkläre, was dieses Projekt tut“.
Dafür gibt es drei Gründe. Lesen schiebt auch standardmäßig keine Rückfrage dazwischen, es geht also durch, ohne dass Sie die Gepflogenheiten der Zustimmung schon kennen müssen. Sie kennen dieses Projekt, können also die Antwort gegenprüfen. Und Sie prüfen Verbindung, Authentifizierung und Arbeitsordner auf einmal, ohne irgendetwas kaputt zu machen. Zeigt sich etwas Merkwürdiges, räumen Sie es auf, bevor es ans Ändern geht.
Die Schleife Anweisung → Diff → Zustimmung
Ist das Lesen durchgelaufen, bitten Sie um eine kleine Änderung. Ab hier ist es immer derselbe Viervierteltakt.
Sagen Sie es einfach auf Deutsch. Wenn Sie sagen können, wo zu ändern ist, sagen Sie es.
Es sucht und liest die vermutlich beteiligten Dateien. Das ist STEP 1 aus Kapitel 1.
„Hier ändere ich das so“ erscheint zeilenweise, und dort hält es an.
Lassen Sie es durch, wird es übernommen. Stimmt es nicht, lehnen Sie ab und ergänzen in Worten, was nicht stimmt.
Sie: „Ergänze in der README den Fall Windows“
↓
[SUCHE] die README finden ← Lesen. Hält nicht an
↓
[LESEN] README.md lesen ← Lesen. Hält nicht an
↓
[ÄNDERN] 3 Zeilen in README.md ← Diff erscheint, es hält an
↓
Sie: zustimmen / ablehnen und die Korrektur mitteilen
Ablehnen ist kein Scheitern. Weil Sie erst den Diff sehen und dann konkret werden können, müssen Sie mit der ersten Anweisung nicht auf Perfektion zielen – das ist der Vorzug dieser Form.
Halten Sie einen Auftrag so groß, dass Sie den Diff noch ganz lesen können. Je größer der Auftrag, desto länger der Diff, und lange Diffs werden ungelesen bestätigt. Eine ungelesen gedrückte Zustimmung ist keine Zustimmung, sondern eine automatische Bestätigung. Wie Sie Aufträge aufteilen, behandelt Kapitel 3.
In welchem Modus fangen Sie an
Wo angehalten wird, bestimmt der Rechtemodus. Im Terminal schalten Sie mit Shift+Tab um, in VS Code, in der Desktop-App und im Browser über die Auswahl neben dem Eingabefeld.
Lesen läuft automatisch. Änderungen und Befehlsausführung werden jedes Mal abgefragt. Am ersten Tag dieser hier.
Lässt Änderungen im Arbeitsordner automatisch durch. Für alle, die die Diffs später gesammelt lesen.
Es untersucht, ändert aber keinen Quellcode. Stimmen Sie dem Plan zu, geht es an die Umsetzung.
Ein separates Bewertungsmodell hält nur gefährliche Operationen auf, der Rest läuft ohne Rückfrage weiter. An Bedingungen geknüpft.
Weder Rückfragen noch Sicherheitsprüfungen sind aktiv. Nur für isolierte Umgebungen. Nichts, was man am ersten Tag anfasst.
Mit Shift+Tab durchlaufen Sie die ersten drei. Der Automatikmodus reiht sich ein, sobald die Bedingungen erfüllt sind, und beim ersten Mal erscheint eine Opt-in-Abfrage. „Rechte umgehen“ ist nur wirksam, wenn Sie mit dem dafür vorgesehenen Schalter starten. Wollen Sie den Modus schon beim Start festlegen, geben Sie claude --permission-mode plan an. Daneben gibt es dontAsk (führt nur Erlaubtes aus), das nicht in der Auswahl auftaucht und ausschließlich über Konfiguration und CLI erreichbar ist.
Die Antwort für den ersten Tag lautet: so lassen, wie es voreingestellt ist. Jede Rückfrage ist eine Übung darin, zu unterscheiden, ob es sich um Lesen, Schreiben oder Ausführen handelt. Erst unterscheiden können, dann lockern – umgekehrt lockern Sie etwas, ohne zu wissen, was Sie da gelockert haben. Der zweite Modus ist der Planmodus.
Es gibt Stellen, die in jedem Modus geschützt sind. Schreibzugriffe auf wichtige Pfade wie .git, .claude oder die Konfigurationsdateien der Shell werden in allen Modi außer „Rechte umgehen“ nicht automatisch bestätigt. Es ist also nicht so, dass mit dem Lockern gleich alles gelockert wäre.
Die Einzelheiten zu den Modi stehen im Artikel zu den Rechtemodi, und wie Sie Erlauben und Verweigern pro Werkzeug ausformulieren, im Artikel zu Rechteregeln und Einstellungen. Und die Antwort auf „die Rückfragen nerven“ ist nicht das Umgehen. Das hat weder gegen Fehlbedienung noch gegen Anweisungen, die in gelesenen Inhalten versteckt sind, irgendeinen Schutz. Wenn weniger, dann schreiben Sie zuerst Regeln, die nur vertrauenswürdige Operationen erlauben. Der Entwurf steht in Kapitel 5.
CLAUDE.md – sich das Wiederholen sparen
Nach zwei Tagen merken Sie, dass Sie immer wieder dieselben Hinweise geben. „Diesen Ordner nicht anfassen.“ „Vor dem Commit lint laufen lassen.“ Das jedes Mal zu tippen verschwendet Ihre Zeit und Ihren Kontext. Also legen Sie eine CLAUDE.md in das Wurzelverzeichnis des Projekts. Claude Code liest sie beim Start automatisch und arbeitet auf der Grundlage dessen, was darin steht.
# Dieses Projekt
- TypeScript / Next.js. Paketverwaltung ist npm
- Antworten und Kommentare im Code auf Deutsch
## Nicht anfassen
- Alles unterhalb von src/legacy/ (gehört einem anderen Team)
- .env und alles davon Abgeleitete
## Prüfen
- Nach Änderungen npm run lint und npm test durchlaufen lassen
- Nicht fertig melden, solange noch Typfehler offen sind
Was hineingehört, entscheidet sich an der Frage: „Was kann die KI unmöglich von selbst wissen?“
Mit welchem Befehl geprüft wird. Das bringt STEP 3 aus Kapitel 1 überhaupt erst zustande und wirkt deshalb am stärksten.
Erzeugte Dateien, Gebiete anderer Teams, Dateien mit Geheimnissen. Und Festlegungen, die man dem Code nicht ansieht, etwa „neue Seiten kommen hierhin“.
Dinge wie „schreibe gut lesbaren Code“. Ob das eingehalten wurde, lässt sich nicht feststellen, und es verdünnt nur die Zeilen, an denen Ihnen wirklich liegt.
Auch das Großziehen folgt einer Regel. Am Anfang ein paar Zeilen. Wer denselben Hinweis zweimal gibt, ergänzt eine Zeile. Der Versuch, alles lückenlos aufzuschreiben, führt zu einer langen, vagen Datei, an die sich niemand hält. Die Ursache von „es hält sich nicht daran“ ist meistens eine von dreien: zu viel, zu abstrakt oder widersprüchlich.
Rechteregeln und die Modellwahl können Sie getrennt in .claude/settings.json (Projekt) und ~/.claude/settings.json (persönlich) halten, aber am ersten Tag genügen ein paar Zeilen CLAUDE.md. Wann Sie was nehmen, steht in Kapitel 6.
Die drei Dinge, die am ersten Tag am häufigsten brechen
Das Steckenbleiben verteilt sich ungleich, und am ersten Tag sind es fast immer diese drei.
Es ist installiert, liegt aber nicht an einer Stelle, von der aus es aufrufbar ist. ~/.local/bin (unter Windows %USERPROFILE%\.local\bin) zum PATH hinzufügen. Manchmal steckt auch eine Doppelinstallation dahinter.
Der Klassiker: Ein alter ANTHROPIC_API_KEY überschreibt das Abonnement. Mit /status nachsehen und die Umgebungsvariable entfernen, bevor Sie sich neu anmelden.
Claude Code verbraucht das 10- bis 100-Fache der Tokens eines Chats. Weil sich die Wechsel und das Einlesen von Dateien aufsummieren.
Beim dritten Punkt gibt es ein Missverständnis. Eine Meldung, die sinngemäß besagt, dass der Server Anfragen vorübergehend begrenzt, ist keine Tarifgrenze, sondern eine vorübergehende Drosselung auf Serverseite, und nach kurzem Warten läuft es wieder. Ob Sie an das Kontingent gestoßen sind, unterscheiden Sie mit /usage.
claude doctor # Gesamtdiagnose: Installation, Konfiguration, MCP, Kontext
/status # womit wird gerade authentifiziert
/context # Aufschlüsselung, was den Kontext auffrisst
claude update # im Zweifel auf die neueste Version (das behebt vieles)
Das abschließende claude update wirkt unscheinbar, hilft aber. Es gibt eine ganze Reihe von Fehlern, die allein durch das Anheben der Version verschwinden, also ersparen Sie sich mit einem Update vor Beginn der Suche die Jagd auf ein Problem, das gar nicht mehr existiert. Abhilfen nach Symptom finden Sie im Artikel zu häufigen Fehlern und ihren Lösungen. Das Vorgehen zur Eingrenzung behandelt Kapitel 4.
Zusammenfassung
- Es gibt fünf Zugänge. Das Innere ist dasselbe, aber für die erste Stunde ist das informationsreiche Terminal im Vorteil
- Der Standardweg ist
npm install -g @anthropic-ai/claude-code. Kommt das nicht durch, Homebrew oder WinGet. Auf genau einen Installationsweg beschränken - Angemeldet wird über Konto (Kontingent) oder API-Schlüssel (Guthaben). Ein Schlüssel in einer Umgebungsvariablen überschreibt das Abonnement – im Zweifel
/status - Der erste Zug ist ein Auftrag, der nur liest. Er prüft Verbindung, Authentifizierung und Arbeitsordner auf einmal und macht nichts kaputt
- Gedreht wird die Schleife Anweisung → Diff → Zustimmung. Teilen Sie Aufträge so, dass Sie den Diff ganz lesen können. Eine ungelesene Zustimmung ist dasselbe wie eine automatische
- Der Modus für den ersten Tag ist die Voreinstellung (Rechte abfragen), der zweite der Planmodus. Geschützte Pfade wie
.gitbleiben in allen Modi außer dem Umgehen geschützt CLAUDE.mdbeginnt mit ein paar Zeilen im Wurzelverzeichnis. Hinein gehören das Prüfverfahren, die Tabuzonen und die Gepflogenheiten dieses Ortes, keine Allgemeinplätze- Am ersten Tag hakt es an PATH, dem Schlüssel in der Umgebungsvariablen und dem Verbrauch. Erste Griffe:
claude doctor,/status,/context
Ist die erste Anweisung durch, geht es darum, das in die tägliche Arbeit zu überführen. Weiter zu Kapitel 3 „Der tägliche Arbeitsablauf“.