Claude Code für Einsteiger: vom Terminal zur fertigen Anwendung

Terminal-Grundlagen, Installation, erste Aufträge, Planmodus, Skills und MCP: der Einstieg in den KI-Agenten von Anthropic
Aktualisiert:
Abstract
- #Claude Code
- #KI-Agenten
- #Terminal
- #Kommandozeile
- #MCP
- #Automatisierung
- #Produktivität
- #Sicherheit
Ein Chatbot beantwortet Fragen, Claude Code erledigt Aufgaben – direkt in Ihren Ordnern
Angenommen, in einem Ordner liegen zwölf Excel-Tabellen mit Monatszahlen, und bis Freitag soll daraus ein Bericht mit Diagrammen werden. Im Browser-Chat beginnt dann das übliche Spiel: Dateien hochladen, an Größengrenzen stoßen, Ergebnisse herunterladen, Tabellen von Hand nachbessern. Claude Code geht anders vor. Das Werkzeug arbeitet direkt in diesem Ordner, liest die Tabellen selbst, schreibt ein kleines Auswertungsprogramm, führt es aus und legt den fertigen Bericht daneben ab.
Ein klassischer Chatbot gleicht einem Auskunftsschalter: Sie fragen, er antwortet. Claude Code ähnelt eher einer Kollegin, die an Ihrem Rechner sitzt, Ihre Ordner kennt und Aufgaben selbstständig abarbeitet – allerdings nur so weit, wie Sie es erlauben. Der Einstieg verlangt keine Programmierkenntnisse, wohl aber ein wenig Vertrautheit mit dem Terminal und ein klares Bild davon, was das Werkzeug darf.
Agent statt Chatbot: was Claude Code anders macht
Anthropic bezeichnet Claude Code als Coding-Agenten. Gemeint ist eine Software, die nicht bei der Antwort stehen bleibt, sondern selbst Werkzeuge bedient: Es liest und schreibt Dateien, durchsucht Ordner, führt Befehle in der Shell aus und prüft die Ergebnisse. Die eigentliche Denkarbeit erledigt ein Sprachmodell aus der Claude-Familie, das über das Internet angesprochen wird. Ausgeführt werden die Aktionen dagegen lokal auf Ihrem Rechner.
Daraus ergeben sich drei praktische Unterschiede zur Webversion von Claude oder zu ChatGPT im Browser:
- Kein Hochladen: Browser-Chats begrenzen Größe und Zahl der hochgeladenen Dateien. Claude Code öffnet Dateien dort, wo sie liegen, und liest bei großen Datensätzen gezielt nur die Teile, die es gerade braucht.
- Echte Ergebnisse: Statt Code zum Kopieren auszugeben, legt Claude Code Dateien an, ändert sie und startet Programme. Am Ende liegt ein Word-Dokument, eine Präsentation oder eine kleine Webanwendung im Ordner.
- Kombinierbare Werkzeuge: Das Terminal hat keine feste Oberfläche. Claude Code kann alles nutzen, was dort installiert ist, von Python über Git bis zu Kommandozeilenprogrammen für Bilder oder PDF-Dateien.
Zuhause ist Claude Code im Terminal. Inzwischen gibt es Claude Code auch als Desktop-App, als Erweiterung für VS Code und JetBrains-Entwicklungsumgebungen sowie in der Webversion. Wer das Terminal einmal verstanden hat, findet sich aber in allen Varianten zurecht, denn die Grundprinzipien sind dieselben.
Terminal-Grundlagen, die Sie wirklich brauchen
Terminal und Shell
Das Terminal ist das Fenster, in das Sie Befehle tippen. Auf dem Mac finden Sie es über die Spotlight-Suche (Befehlstaste und Leertaste, dann „Terminal“), unter Windows heißt das Gegenstück PowerShell oder Windows Terminal. Das Fenster selbst ist nur die Hülle. Die Eingaben verarbeitet ein Programm im Hintergrund, die Shell. Man kann sich das Terminal als Briefkasten vorstellen und die Shell als Postdienst, der die Briefe tatsächlich zustellt.
Auf dem Mac ist die Z-Shell (zsh) voreingestellt, unter Linux meist Bash. Beide folgen denselben Unix-Konventionen, die meisten Befehle verhalten sich daher gleich. Windows geht mit PowerShell eigene Wege. Wer unter Windows dieselben Befehle wie auf Mac und Linux nutzen möchte, kann mit dem Windows-Subsystem für Linux (WSL) eine Linux-Umgebung einrichten.
Eine Handvoll Befehle für den Anfang
Für die Arbeit mit Claude Code genügen wenige Befehle. Die folgenden funktionieren in zsh und Bash:
pwd # zeigt den aktuellen Ordner an
ls -la # listet Dateien samt versteckten Dateien und Details
cd ~/Projekte/bericht # wechselt in einen Ordner
cd ~ # zurück ins eigene Benutzerverzeichnis
mkdir auswertung # legt einen neuen Ordner an
echo "Hallo Claude" > notizen.md # schreibt Text in eine Datei
cat notizen.md # zeigt den Inhalt einer Datei an
cd auswertung && ls # zwei Befehle nacheinander ausführen
ls -la | grep xlsx # Ausgabe weiterreichen und filtern
Zwei Zeichen verdienen besondere Aufmerksamkeit. Das doppelte Und-Zeichen && führt den zweiten Befehl nur aus, wenn der erste geklappt hat. Der senkrechte Strich |, die sogenannte Pipe, reicht die Ausgabe eines Befehls an den nächsten weiter. Aus solchen Ketten baut auch Claude Code viele seiner Arbeitsschritte. Wer sie lesen kann, versteht besser, was das Werkzeug gerade vorhat, wenn es um Erlaubnis für einen Befehl bittet.
Abkürzungen in der Shell-Konfiguration
Wer täglich dieselben Befehle tippt, kann Abkürzungen festlegen, sogenannte Aliase. Sie stehen in der Konfigurationsdatei der Shell, beim Mac in der Datei .zshrc im Benutzerverzeichnis:
alias ll="ls -la"
alias projekt="cd ~/Projekte/bericht"
Nach einem Neustart des Terminals oder dem Befehl source ~/.zshrc stehen die Kürzel bereit. Das ist kein Muss, spart im Alltag aber viele Tastenanschläge.
Claude Code installieren und starten
Voraussetzungen und Installation
Für Claude Code brauchen Sie entweder ein kostenpflichtiges Claude-Abo (Pro, Max, Ultra, Team oder Enterprise) oder ein Konto in der Anthropic Console mit nutzungsabhängiger Abrechnung über die API. Mit dem kostenlosen Claude-Zugang funktioniert das Werkzeug nicht.
Anthropic empfiehlt den eigenen Installer, der Claude Code ohne weitere Abhängigkeiten einrichtet und automatisch aktualisiert. Auf Mac und Linux lautet der Befehl:
curl -fsSL https://claude.ai/install.sh | bash
Unter Windows erfolgt die Installation in der PowerShell:
irm https://claude.ai/install.ps1 | iex
Alternativ ist Claude Code über Homebrew und über npm erhältlich. Ein Hinweis zur Vorsicht gilt für alle Installationsbefehle, die ein Skript aus dem Internet herunterladen und direkt ausführen: Kopieren Sie solche Zeilen nur aus der offiziellen Dokumentation unter code.claude.com, nicht aus Foren oder Videos.
Der erste Start
Gestartet wird Claude Code immer in dem Ordner, in dem es arbeiten soll:
cd ~/Projekte/bericht
claude
Beim ersten Aufruf melden Sie sich im Browser mit Ihrem Claude-Konto an. Danach fragt Claude Code, ob Sie dem Ordner vertrauen. Diese Frage ist ernst gemeint: Bestätigen Sie sie nur für Ordner, deren Inhalt Sie kennen, denn Claude Code liest dort Dateien und kann Einstellungen aus dem Projekt übernehmen.
Die erste Unterhaltung
Zunächst verhält sich Claude Code wie ein Chat. Sie können fragen, was in dem Ordner liegt, oder sich eine Tabelle erklären lassen. Einige Bedienelemente erleichtern die Arbeit:
- Mit
@gefolgt von einem Dateinamen verweisen Sie gezielt auf eine Datei, etwa@umsatz-2026.xlsx. - Ein vorangestelltes
!führt einen Shell-Befehl direkt aus, ohne den Umweg über das Modell. - Die Escape-Taste unterbricht Claude Code, wenn es in die falsche Richtung läuft.
/clearbeginnt eine neue Unterhaltung,/initlegt eine DateiCLAUDE.mdan.
Die CLAUDE.md ist eine Art Merkzettel für das Projekt. Claude Code liest sie bei jedem Start und weiß dann etwa, dass Berichte immer auf Deutsch und im Firmenlayout entstehen sollen oder dass der Ordner rohdaten nicht verändert werden darf. Wenige, klare Sätze wirken hier besser als seitenlange Regelwerke.
Aus Dateien werden Berichte, Diagramme und Dashboards
Berichte und Präsentationen aus Tabellen
Zurück zu den zwölf Excel-Tabellen. Ein Auftrag könnte lauten: „Fasse die Monatsumsätze aus allen Tabellen im Ordner zusammen, erstelle je Produktgruppe ein Balkendiagramm und baue daraus eine Präsentation mit zehn Folien.“ Claude Code schreibt dafür in der Regel ein Python-Programm, installiert bei Bedarf Bibliotheken wie pandas für die Datenauswertung, matplotlib für Diagramme oder python-pptx für PowerPoint-Dateien und führt das Programm aus. Bei jedem Befehl, der etwas installiert oder ausführt, fragt es zunächst nach.
Das ist bequem, entbindet aber nicht von der Kontrolle. Sprachmodelle können sich bei Spaltennamen irren, Monate doppelt zählen oder Einheiten verwechseln. Lassen Sie sich deshalb die Rechenschritte erklären und prüfen Sie zwei, drei Werte stichprobenartig gegen die Originaltabelle. Ein guter Zusatz im Auftrag lautet: „Gib am Ende die Summen je Monat als Tabelle aus, damit sich die Werte nachprüfen lassen.“
Ein Dashboard im Browser
Einen Schritt weiter geht eine kleine Webanwendung. Auf den Auftrag „Baue aus den Tabellen ein interaktives Dashboard mit Filter nach Region“ wählt Claude Code typischerweise eine Bibliothek wie Streamlit oder Plotly Dash, schreibt den Code und startet einen lokalen Webserver. Das Ergebnis öffnen Sie im Browser unter einer Adresse wie http://localhost:8501. Die Zahl hinter dem Doppelpunkt ist der Port, vergleichbar mit einer Zimmernummer im selben Haus. Das Dashboard läuft nur auf Ihrem Rechner und ist nicht öffentlich erreichbar.
Screenshots als Fehlerbeschreibung
Sitzt eine Beschriftung schief oder überlappen sich Diagramme, müssen Sie den Fehler nicht in Fachsprache beschreiben. Ein Screenshot, den Sie in das Terminalfenster ziehen oder einfügen, genügt meist. Claude Code erkennt auf dem Bild, was nicht stimmt, und passt den Code an. Das ist so, als schickten Sie einem Handwerker ein Foto vom schiefen Regal, statt die Maße zu diktieren.
Dokumente gegen eine Richtlinie prüfen lassen
Viele Unternehmen prüfen Marketingtexte, Newsletter oder Berichte vor der Veröffentlichung auf Vorgaben: Tonalität, Pflichtangaben, verbotene Werbeaussagen. Claude Code kann eine solche Prüfung vorbereiten. Sie legen eine Bewertungsrubrik als Textdatei in den Ordner, also eine Liste mit Kriterien und Punkteskala, und beauftragen Claude Code, jedes Dokument im Ordner danach zu bewerten. Heraus kommt eine Übersicht mit Punktzahlen je Kriterium, konkreten Fundstellen und Verbesserungsvorschlägen, auf Wunsch auch als farbige Matrix zur schnellen Orientierung.
Soll daraus ein dauerhaftes Werkzeug werden, das ohne Claude Code läuft, schreibt Claude Code ein Programm, das selbst die Claude-API aufruft. Dafür brauchen Sie einen API-Schlüssel aus der Anthropic Console. Er gehört in eine Datei namens .env, die nie in ein Git-Repository oder eine geteilte Ablage wandern darf. Tragen Sie die Datei in die .gitignore ein und behandeln Sie den Schlüssel wie einen Büroschlüssel: Wer ihn hat, verursacht Kosten auf Ihre Rechnung.
Eine Grenze bleibt: Die Bewertung ist eine Vorprüfung, keine Freigabe. Bei rechtlich heiklen Aussagen, etwa zu Gesundheitsversprechen oder Preisangaben, entscheidet weiterhin ein Mensch.
Erst planen, dann umsetzen
Nicht jede Aufgabe braucht einen Plan, aber größere Vorhaben profitieren davon. In der Praxis haben sich drei Herangehensweisen bewährt:
- Direkter Auftrag: Für kleine, klar umrissene Aufgaben genügt ein Satz, etwa „Formuliere die Einleitung in
angebot.mdkürzer“. - Planmodus: Mit Umschalt+Tab wechseln Sie in den Planmodus. Claude Code sieht sich dann Dateien und Ordnerstruktur an, schlägt ein Vorgehen vor und ändert nichts, bevor Sie den Plan freigeben. Das kostet einige Minuten, verhindert aber, dass das Werkzeug eine Stunde lang in die falsche Richtung arbeitet.
- Rückfragen und Spezifikation: Wenn Sie selbst noch nicht wissen, wie die Lösung aussehen soll, schildern Sie das Problem und bitten Claude Code, Ihnen zuerst Fragen zu stellen. Aus den Antworten entsteht eine kurze Anforderungsbeschreibung, in der Softwareentwicklung oft PRD (Product Requirements Document) genannt, die als Grundlage für die Umsetzung dient.
Gerade die dritte Variante unterschätzen viele Einsteiger. Je genauer Ziel, Grenzen und Prüfkriterien beschrieben sind, desto besser wird das Ergebnis. Wie solche Beschreibungen aussehen, zeigt unser Beitrag über Spezifikationen für KI-Agenten.
Claude Code erweitern: Skills und MCP-Server
Skills für wiederkehrende Aufgaben
Wer denselben langen Auftrag immer wieder tippt, legt ihn besser als Skill ab. Ein Skill ist ein Ordner unter .claude/skills/ mit einer zentralen Datei SKILL.md. Darin stehen oben ein Name und eine kurze Beschreibung im YAML-Format, darunter die eigentliche Anleitung in normaler Sprache. Daneben können Skripte, Vorlagen oder Beispieldokumente liegen.
---
name: monatsbericht
description: Erstellt aus den Excel-Dateien im Ordner rohdaten den Monatsbericht als Word-Dokument.
---
1. Lies alle .xlsx-Dateien im Ordner rohdaten.
2. Berechne Umsatz je Produktgruppe und Veränderung zum Vormonat.
3. Erstelle den Bericht nach der Vorlage vorlage.docx.
4. Gib die Summen zur Kontrolle als Tabelle aus.
Claude Code lädt einen Skill, wenn eine Aufgabe zur Beschreibung passt, oder Sie rufen ihn direkt als Befehl auf, hier mit /monatsbericht. Ältere Anleitungen beschreiben für diesen Zweck einfache Befehlsdateien unter .claude/commands/. Sie funktionieren weiterhin, Skills sind aber die vielseitigere Form. Weil ein Skill nur aus Dateien besteht, lässt er sich im Team über ein gemeinsames Repository teilen. Mehr dazu erklärt unser Beitrag Claude Skills für Einsteiger.
MCP-Server für externe Dienste
MCP steht für Model Context Protocol, ein offener Standard, über den KI-Anwendungen mit externen Diensten sprechen. Ein MCP-Server übersetzt zwischen Claude Code und einem bestimmten System, etwa einem Ticketsystem, einer Datenbank, einem Wiki oder einem Dienst wie GitHub. Claude Code kann dann zum Beispiel Hintergrundinformationen abrufen und mit den lokalen Tabellen verknüpfen.
Eingerichtet wird ein MCP-Server mit einem Befehl im Terminal. Die Adresse liefert der jeweilige Anbieter, hier steht ein Platzhalter:
claude mcp add --transport http wissensdatenbank https://mcp.example.com/mcp
Innerhalb von Claude Code zeigt /mcp, welche Server verbunden sind. Vorsicht ist bei Servern aus unbekannten Quellen geboten: Ein MCP-Server erhält Anfragen und liefert Inhalte, die Claude Code ernst nimmt. Ein manipulierter Server kann Daten abgreifen oder dem Modell Anweisungen unterschieben. Nutzen Sie bevorzugt Server der jeweiligen Hersteller.
Berechtigungen und Datenschutz: was Claude Code darf
Ein Werkzeug, das Befehle ausführt, kann auch Schaden anrichten, etwa Dateien löschen oder Daten an falsche Stellen schicken. Claude Code steuert das über Berechtigungsmodi, zwischen denen Sie mit Umschalt+Tab wechseln. Im manuellen Modus fragt es vor jeder Dateiänderung und jedem Shell-Befehl. Der Modus acceptEdits übernimmt Dateiänderungen ohne Rückfrage. Im Modus auto entscheidet ein zusätzliches Prüfmodell, welche Aktionen ohne Nachfrage laufen dürfen. Neuere Versionen starten interaktive Sitzungen standardmäßig in diesem Modus. Für Einsteiger empfehlen wir dennoch, anfangs im manuellen Modus zu arbeiten und jede Anfrage zu lesen. Nur so lernen Sie, was das Werkzeug tatsächlich tut.
Feste Regeln legen Sie in der Datei .claude/settings.json fest, zum Beispiel ein Leseverbot für die Datei mit dem API-Schlüssel:
{
"permissions": {
"deny": ["Read(./.env)"]
}
}
Für Unternehmen wichtiger als jede Einstellung ist eine andere Tatsache: Alles, was Claude Code liest, geht als Kontext an das Sprachmodell und damit an Anthropic oder einen Cloud-Anbieter, über den das Modell bezogen wird. Personenbezogene Daten von Kunden oder Beschäftigten gehören daher nur dann in einen Claude-Code-Ordner, wenn die Verarbeitung datenschutzrechtlich geklärt ist. Maßgeblich sind die DSGVO und der Vertrag zur Auftragsverarbeitung mit dem Anbieter. Welche Datenschutzbedingungen gelten, hängt vom gewählten Tarif ab. Wer im Unternehmen Regeln für den Einsatz solcher Werkzeuge aufstellen will, findet Grundlagen in unserem Seminar zu Datenschutz und IT-Sicherheit.
Für wen sich der Einstieg lohnt
Claude Code ist kein Spielzeug für Programmierer allein. Wer regelmäßig Daten auswertet, Dokumente aufbereitet oder kleine interne Werkzeuge braucht, kann mit überschaubarem Lernaufwand viel Routinearbeit abgeben. Die Einstiegshürde liegt weniger in der Technik als in der Arbeitsweise: Aufträge präzise formulieren, Zwischenergebnisse prüfen, Berechtigungen bewusst vergeben.
Überschätzt wird dagegen, was ohne jedes Vorwissen entsteht. Ein Dashboard für den eigenen Gebrauch ist schnell gebaut. Eine Anwendung, die mehrere Kolleginnen nutzen, die mit Kundendaten arbeitet oder im Internet erreichbar ist, braucht dagegen jemanden, der Sicherheit, Wartung und Fehlerfälle beurteilen kann. Claude Code beschleunigt diese Arbeit, ersetzt aber nicht das Urteil.
Unsere Empfehlung: Beginnen Sie mit einer echten, aber unkritischen Aufgabe in einem eigenen Ordner, arbeiten Sie die ersten Tage im manuellen Modus und legen Sie früh eine CLAUDE.md an. Wer danach tiefer einsteigen möchte, findet in unserem Beitrag über Profi-Funktionen von Claude Code Themen wie Hooks, Subagenten und den Einsatz in automatisierten Abläufen. Wie Teams KI-Assistenten in der Webentwicklung strukturiert einführen, behandeln wir in Beratung und Seminaren zu KI in der Webentwicklung.
Häufige Fragen zu Claude Code für Einsteiger
Sind Programmierkenntnisse für Claude Code nötig?
Für die ersten Schritte nicht. Claude Code versteht Aufträge in normaler Sprache und schreibt den nötigen Code selbst. Hilfreich sind Grundkenntnisse im Terminal, also Ordner wechseln, Dateien anzeigen und Befehle lesen können. Je wichtiger das Ergebnis ist, desto mehr brauchen Sie jemanden, der den erzeugten Code beurteilen kann.
Was kostet Claude Code?
Ein eigenes Abo für Claude Code gibt es nicht. Das Werkzeug gehört zu den bezahlten Claude-Tarifen, der günstigste davon ist Pro mit rund 20 US-Dollar monatlich. Teurere Stufen erlauben mehr Nutzung, Firmen buchen Team- oder Enterprise-Tarife. Wer lieber nach Verbrauch zahlt, verbindet Claude Code mit einem API-Konto in der Anthropic Console. Da sich Tarife und Nutzungsgrenzen oft ändern, lohnt vor dem Kauf ein Blick auf die Preisübersicht des Herstellers.
Worin unterscheidet sich Claude Code von der Webversion von Claude?
Die Webversion ist ein Chat im Browser, dem Sie Dateien hochladen. Claude Code arbeitet direkt mit den Dateien auf Ihrem Rechner, führt Programme aus und legt Ergebnisse als Dateien ab. Für Aufgaben ohne Code, etwa Dokumente sortieren, bietet Anthropic mit Cowork zusätzlich einen eigenen Modus in den Claude-Apps an.
Läuft Claude Code auch unter Windows?
Ja. Claude Code lässt sich unter Windows direkt in der PowerShell installieren und nutzen. Alternativ arbeiten Sie im Windows-Subsystem für Linux (WSL), wenn Sie dieselben Befehle wie auf Mac und Linux verwenden möchten. Die aktuellen Systemvoraussetzungen nennt die Installationsanleitung von Anthropic.
Kategorien
Schlagworte