8 Minuten Lesezeit · geprüft am 3.11.2026
Claude Code auf Deutsch: die Anleitung für deinen ersten Arbeitstag mit dem Agenten
Was Claude Code ist, wie du in zehn Minuten zum ersten Commit kommst, welche Befehle du wirklich brauchst, wie CLAUDE.md, MCP und Hooks funktionieren und wo die Grenzen liegen.
Was ist Claude Code und was brauchst du dafür?
Claude Code ist der Coding-Agent von Anthropic: Du sagst im Terminal, was passieren soll, und er liest dein Projekt, ändert Dateien und startet Befehle. Du brauchst dafür einen bezahlten Claude-Plan (Pro, Max, Ultra, Team oder Enterprise) oder ein API-Konto in der Claude Console, und unter Windows läuft er inzwischen ohne WSL.
Der Unterschied zum Chatfenster: Du kopierst keinen Code mehr hin und her. Claude Code sucht sich die passenden Dateien selbst, plant Änderungen über mehrere Dateien, lässt Tests laufen und kann mit Git umgehen, also Commits schreiben, Branches anlegen und Pull Requests vorbereiten. Ein Chatbot erklärt dir am Telefon, welche Schraube locker ist, Claude Code steht mit dem Schlüssel neben dir an der Hebebühne.
Laut Anthropic läuft er auf Windows 10 ab Version 1809, Windows 11 und Windows Server 2019, auf macOS ab Version 13 sowie auf Ubuntu 20.04, Debian 10 und Alpine 3.19 oder neuer. Dazu kommen mindestens 4 GB RAM, ein x64- oder ARM64-Prozessor und eine Internetverbindung aus einem unterstützten Land. Der kostenlose Claude-Plan reicht nicht.
Dieselbe Engine steckt auch in der Erweiterung für VS Code, im JetBrains-Plugin, in der Desktop-App und in der Webversion unter claude.ai/code, deine CLAUDE.md, Einstellungen und MCP-Server gelten überall. Ich bleibe hier beim Terminal, weil dort alle Funktionen verfügbar sind. Willst du eigentlich nur chatten und nicht programmieren, ist der Ratgeber „ChatGPT, Claude oder Gemini: welcher Chatbot passt zu welcher Aufgabe?“ der bessere Startpunkt.
So kommst du in zehn Minuten zum ersten Commit
Tipp in PowerShell irm https://claude.ai/install.ps1 | iex ein, Adminrechte brauchst du nicht. Alternativ geht winget install Anthropic.ClaudeCode, dann aktualisiert sich Claude Code aber nicht von selbst. Unter macOS und Linux nimmst du im Terminal curl -fsSL https://claude.ai/install.sh | bash. Alle Wege und die typischen Stolperfallen stehen im Ratgeber Claude Code installieren.
Öffne danach ein neues Terminalfenster und tipp claude --version. Kommt eine Versionsnummer, passt alles. Meldet die Shell, dass claude nicht gefunden wird, fehlt der Ordner noch im PATH. Dann wechselst du in deinen Projektordner, startest mit claude und meldest dich beim ersten Start im Browser an.
Jetzt nicht gleich losschrauben lassen. Frag zuerst: „Erklär mir den Aufbau dieses Projekts.“ An der Antwort siehst du, ob Claude deinen Code verstanden hat. Danach legt /init eine erste CLAUDE.md mit Build-Befehlen und Konventionen an. Lies sie durch und streich, was nicht stimmt.
Die erste echte Aufgabe sollte klein sein und ein klares Ergebnis haben, etwa „Schreib Tests für die Funktion X und führ sie aus“. Jede Dateiänderung zeigt dir Claude Code als Diff und fragt um Erlaubnis. Zum Schluss sagst du „Committe die Änderungen mit einer passenden Nachricht“, schaust aber vorher mit git diff nach, was wirklich drinsteckt.
Welche Befehle brauchst du wirklich?
Befehle mit Schrägstrich tippst du in der laufenden Sitzung. Ein einzelnes / zeigt dir die komplette Liste, die je nach Plan und Plattform etwas abweicht. Für den Alltag reichen diese: /clear startet ein frisches Gespräch, /compact fasst das bisherige zusammen und schafft Platz, /context zeigt, wie voll das Kontextfenster ist, und /usage (Alias /cost) zeigt die Kosten der Sitzung und den Stand deiner Limits.
Mit /model wechselst du das Modell, mit /plan lässt du Claude erst einen Plan vorschlagen, ohne dass sich etwas ändert. /permissions legt fest, was Claude ohne Nachfrage darf, was er fragen muss und was verboten ist. /memory öffnet deine CLAUDE.md-Dateien, /mcp und /hooks zeigen angebundene Server und Hooks, /review prüft den aktuellen Diff, einen Pull Request oder einen Branch, und /doctor checkt Installation und Einstellungen.
Dein Rückwärtsgang heißt /rewind oder zweimal Esc bei leerer Eingabe: Damit setzt du Code, Gespräch oder beides auf einen früheren Stand zurück. Einmal Esc unterbricht Claude mitten in der Arbeit, ohne das Erledigte wegzuwerfen. Shift und Tab schaltet die Berechtigungsmodi durch, etwa von Manual zu acceptEdits, wo Dateiänderungen ohne Nachfrage durchgehen. Ein ! am Zeilenanfang führt einen Shell-Befehl direkt aus, mit @ erwähnst du eine Datei per Autovervollständigung.
Auch direkt aus der Shell lässt sich Claude Code aufrufen, praktisch für Skripte: claude -p „finde Tippfehler in README.md“ antwortet einmal und beendet sich, claude -c setzt die letzte Sitzung im Ordner fort, claude -r mit einem Namen holt eine benannte Sitzung zurück, und claude update aktualisiert sofort. In PowerShell kannst du sogar Logs hineinreichen: Get-Content fehler.log | claude -p „was ist die Ursache?“.
CLAUDE.md: So erklärst du dein Projekt einmal statt jeden Morgen
Jede Sitzung startet mit leerem Kontext. Damit Claude nicht jedes Mal neu herausfinden muss, wie dein Projekt gebaut und getestet wird, liest er beim Start die CLAUDE.md. Rein gehören Build- und Testbefehle, Code-Konventionen und Entscheidungen, die man dem Code nicht ansieht, zum Beispiel „Ordner legacy nicht anfassen“ oder „antworte auf Deutsch, Code-Kommentare auf Englisch“.
Es gibt drei Ebenen. ~/.claude/CLAUDE.md gilt für alle deine Projekte und bleibt auf deinem Rechner. ./CLAUDE.md oder ./.claude/CLAUDE.md gilt fürs Projekt und gehört ins Git, damit das ganze Team dieselben Regeln hat. ./CLAUDE.local.md ist nur für dich und kommt in die .gitignore.
Halte die Datei kurz, Anthropic empfiehlt unter 200 Zeilen. Lange Dateien kosten Kontext und werden schlechter befolgt, wie ein Werkstatthandbuch mit 900 Seiten, das keiner aufschlägt. Andere Dateien bindest du mit @pfad ein, etwa @README.md, verschachtelt bis zu vier Ebenen tief. Wichtig: Die CLAUDE.md ist Kontext, kein Gesetz. Claude hält sich meistens daran, garantiert ist das nicht.
Arbeitest du auch mit Codex oder anderen Agenten? Seit Version 2.1.277 liest Claude Code eine AGENTS.md, wenn im Projekt keine CLAUDE.md liegt. Gibt es beide, hat die CLAUDE.md standardmäßig Vorrang. Ändern lässt sich das unter „Project instructions“ in /config.
MCP und Hooks: Werkzeuge anbinden und Regeln festschrauben
Über das Model Context Protocol (MCP) bekommt Claude Code Zugriff auf weitere Werkzeuge und Daten, etwa Ticketsysteme, Datenbanken oder Dokumentation. Einen entfernten Server trägst du mit claude mcp add --transport http mein-server https://example.com/mcp ein, einen lokalen mit claude mcp add --transport stdio mein-tool -- npx -y paketname. Alles nach den zwei Bindestrichen ist der Startbefehl des Servers.
Ohne --scope gilt ein Server nur für dich und nur in diesem Projekt. Mit --scope project landet er in der .mcp.json im Projekt und damit beim ganzen Team, wobei jeder ihn einmal bestätigen muss. Installier nur Server aus Quellen, denen du traust: Ein MCP-Server bekommt Zugriff auf alles, was du ihm freigibst.
Hooks sind das Gegenstück zur CLAUDE.md: Befehle, die Claude Code an festen Punkten selbst ausführt, zum Beispiel vor einem Werkzeugaufruf (PreToolUse) oder danach (PostToolUse). Sie sind verbindlich. Endet ein PreToolUse-Hook mit Exit-Code 2, wird die Aktion blockiert. Was nie passieren darf, sicherst du also mit einem Hook ab und nicht mit einer höflichen Bitte in der CLAUDE.md.
Hooks stehen in .claude/settings.json im Projekt oder in ~/.claude/settings.json für alle Projekte. Ein typischer Einstieg ist ein PostToolUse-Hook mit dem Matcher Edit|Write, der nach jeder Dateiänderung npm run format startet. Welche Hooks gerade aktiv sind, zeigt dir /hooks.
Wo stößt Claude Code an seine Grenzen?
Gratis gibt es nichts, und auch die bezahlten Pläne haben Nutzungslimits, die du bei intensiver Arbeit spürst. Was die Pläne kosten und was du tust, wenn das Kontingent leer ist, steht im Ratgeber Claude Code Kosten.
Unter nativem Windows gibt es keine Sandbox, Befehle laufen direkt auf deinem System. Willst du sie isoliert ausführen lassen, nimm WSL 2. Außerdem ist der Kontext begrenzt: In langen Sitzungen fasst Claude Code ältere Teile zusammen, dabei gehen Details verloren. Lieber pro Aufgabe ein /clear als eine Endlossitzung, die sich füllt wie ein Werkzeugwagen, den nie jemand aufräumt.
Der Agent kann Code schreiben, der plausibel aussieht und trotzdem falsch ist, oder Tests so umbiegen, dass sie grün werden. Diffs lesen und Tests prüfen bleibt dein Job. Für den Notfall gibt es /rewind, die sicherere Absicherung bleibt aber Git.
Claude Code arbeitet nur online. Die Modelle laufen bei Anthropic oder bei einem Cloud-Anbieter wie Amazon Bedrock, Google Cloud oder Microsoft Foundry, dein Code wird also übertragen. Firmen sollten vorab klären, welcher Plan und welche Vertragsbedingungen für sie gelten. Darf dein Code gar nicht aus dem Haus, schau in die Ratgeber „Lokale KI 2026“ und „Open-Weight-Modelle 2026“.
Quellen und Stand 🔎
Alle Angaben zu Regeln, Preisen und Funktionen wurden am 3. November 2026 mit diesen Quellen abgeglichen. Zahlen zur Verzeichnisliste stammen aus der eigenen mentat.codes-Datenbank.
Häufige Fragen 🙋
Kann ich Claude Code auf Deutsch benutzen?
Ja. Du kannst deine Aufgaben auf Deutsch schreiben, und Claude antwortet in der Regel auch auf Deutsch. Befehle, Menüs und die offizielle Doku sind englisch. Willst du verlässlich deutsche Antworten, schreib das in deine CLAUDE.md.
Ist Claude Code kostenlos?
Nein. Laut Anthropic brauchst du ein Pro-, Max-, Ultra-, Team-, Enterprise- oder Console-Konto. Im kostenlosen Claude-Plan ist Claude Code nicht enthalten.
Brauche ich unter Windows WSL?
Nein. Claude Code läuft nativ unter Windows 10 ab Version 1809 in PowerShell oder CMD. WSL 2 lohnt sich nur, wenn du Linux-Werkzeuge oder die Sandbox brauchst, denn die gibt es unter nativem Windows nicht.
Liest Claude Code die Datei AGENTS.md?
Ja, seit Version 2.1.277. Standardmäßig aber nur, wenn im Arbeitsverzeichnis und darüber keine CLAUDE.md und keine CLAUDE.local.md liegt.
Wie mache ich eine Änderung von Claude Code rückgängig?
Mit /rewind oder zweimal Esc bei leerer Eingabe. Dann wählst du einen früheren Punkt und stellst Code, Gespräch oder beides wieder her. Git bleibt trotzdem die sicherere Absicherung.
Weiterlesen und loslegen
- KI-Tool in Verzeichnisse eintragen: die komplette Anleitung →
- Bringen KI-Verzeichnisse etwas für SEO? Eine ehrliche Einordnung →
- Product Hunt Launch auf Deutsch: Vorbereitung, Ablauf, Fallstricke →
- Product-Hunt-Alternativen: 12 Launch-Plattformen für Gründer →
- Welcher Newsletter-Anbieter für Gründer? beehiiv, Kit, Brevo und GetResponse im Vergleich →
- KI-Tools und Datenschutz: die DSGVO-Checkliste für den Einsatz im Unternehmen →
- KI-Bildgeneratoren 2026: Midjourney, Leonardo AI, Canva und kostenlose Alternativen →
- KI-Video-Tools 2026: Runway, Synthesia, HeyGen, InVideo, Descript und Pictory im Überblick →
- KI-Tool launchen in 30 Tagen: der Plan von der ersten Einreichung bis zu echten Nutzern →
- ChatGPT, Claude oder Gemini: welcher Chatbot passt zu welcher Aufgabe? →
- KI-Agenten für Selbstständige 2026: Was in Deutschland wirklich geht →
- KI-Modelle in Automationen zukunftssicher betreiben: Fristen, Preise und Wechsel ohne Ausfall →
- Sichtbar in ChatGPT und im Google KI-Modus: Werbung und SEO in KI-Antworten 2026 →
- Open-Weight-Modelle 2026: Wann sich eigene KI für kleine Firmen lohnt →
- KI-Telefonassistent und Sprach-Agenten 2026: Was sie können, was sie kosten, was erlaubt ist →
- KI-Skills statt Copy-Paste-Prompts: Wiederkehrende Aufgaben einmal beibringen, überall nutzen →
- KI-Browser 2026: Comet, Chrome mit Gemini, Edge mit Copilot und Opera im Praxis-Check →
- Lokale KI 2026: Was auf deinem Laptop und im Browser schon geht, ganz ohne Cloud →
- Vibe Coding: Apps bauen mit Lovable, Bolt und v0 →
- KI-Musik und Rechte: was das GEMA-Urteil gegen Suno bedeutet →
- KI-Comic mit konsistenten Figuren: Charakterbibel statt Prompt-Lotterie →
- Comic-Drehbuch mit KI: 10 Seiten planen, 50 Panels sauber schreiben →
- Gamma für einen KI-Comic: Was funktioniert und wo 200 Seiten scheitern →
- Ein KI-Projekt in LinkedIn und Substack verwandeln, ohne Copy-Paste-Spam →
- GitHub-first Publishing für KI-Content: Merge, Review und echte Veröffentlichung trennen →
- ChatGPT-Verlauf löschen, archivieren oder ausschalten: Schritt für Schritt →
- Claude Memory: was Claude sich merkt und wie du es steuerst →
- ChatGPT-Projekte vs. Claude-Projekte: wo deine Arbeit besser aufgehoben ist →
- Chats exportieren und umziehen: ChatGPT, Claude und Gemini im Überblick →
- ChatGPT Memory erklärt: was das Gedächtnis speichert und wie du es steuerst →
- ChatGPT für die Bewerbung: vom Lebenslauf bis zur Gehaltsfrage →
- Mit ChatGPT übersetzen: Glossar, Tonfall, Lokalisierung →
- Prompt-Vorlagen: so findest und nutzt du die passende →
- ChatGPT und Excel: Formeln bauen, Tabellen auswerten, Daten bereinigen →
- ChatGPT Agent erklärt: vom Agentenmodus zu ChatGPT Work →
- SEO-Prompts für ChatGPT: was die KI übernimmt und was dein SEO-Tool →
- GPTs erstellen: was nach dem Aus der Custom GPTs noch geht →
- Prompt Engineering: der Leitfaden auf Deutsch →
- Was wurde aus Mentat? Die Geschichte hinter dieser Domain →
- Welche KI programmiert im Terminal am besten? Neun Coding-Agenten im Vergleich →
- Claude Code installieren: Windows ohne WSL, macOS, Linux und die 6 häufigsten Fehler →
- Was kostet Claude Code? Pro, Max, Ultra und API im Vergleich, mit Rechenbeispiel →
- Codex CLI auf Deutsch: installieren, anmelden und sicher loslegen →
- Claude Code oder Codex: welcher Coding-Agent passt zu dir? →
- AGENTS.md und CLAUDE.md: so richtest du beide richtig ein →
- Gemini CLI eingestellt? So steigst du auf die Antigravity CLI um →
- Aider mit Ollama: lokal programmieren, ohne dass Code das Haus verlässt →
- Cursor-Alternative kostenlos: Editoren, Open Source und Terminal-Agenten →
- Launch-Kit öffnen →
- Zu allen KI-Verzeichnissen →