Knowledge, Context and Agentic Engineering for Knowledge Work
← Setup-Tutorial Modul 04 · Agentic Engineering

Einführung in die Claude Code CLI

Dieses Tutorial erklärt die Claude Code CLI als AI Harness. Es verbindet die erste sichere Aufgabe mit Projektanweisungen, Working Context, externen Werkzeugen und delegierter Recherche.

Zuletzt geprüft am 25. August 2026

Schließe vor dem Einstieg den Setup-Pfad ab.Verwende einen entbehrlichen Übungsordner ohne vertrauliche Dateien.

Claude Code wird durch die Beziehung zwischen Modell, Harness und Projektumgebung verständlich.

Schritt 1

Betrachte Claude Code als vollständiges Arbeitssystem

Claude Code ist ein AI Harness, das ein Sprachmodell mit Projektdateien, Werkzeugen, Berechtigungen und Ausführungsfeedback verbindet.

  1. Eine Anfrage definiert das aktuelle Ziel und seine Grenzen.
  2. Das Harness wählt Context und stellt verfügbare Handlungen bereit.
  3. Werkzeugergebnisse werden zur Evidenz für den nächsten Modellaufruf.
  4. Prüfungen bestimmen, ob die Aufgabe fortgesetzt oder abgeschlossen wird.

Prüfung: Du kannst in einer Claude-Code-Sitzung Modell, Harness und Projektzustand unterscheiden.

Ein begrenzter Workspace und dokumentierter Git-Zustand machen die erste Übung prüfbar.

Schritt 2

Bereite den lokalen CLI-Workspace vor

  1. Verwende ein entbehrliches Git-Repository ohne Zugangsdaten oder vertrauliche Dateien.
  2. Prüfe die aktuellen Anforderungen an Betriebssystem, Shell und Account.
  3. Führe git status --short außerhalb von Claude Code aus und dokumentiere den Ausgangszustand.
  4. Bestimme die Projektanweisungen und die gepflegten Verifikationsbefehle.

Prüfung: Repository-Grenze, Zugangsweg und Git-Ausgangslage sind vor dem Start bekannt.

Offizieller Claude-Code-Quickstart

Die Installation ist abgeschlossen, wenn Claude Code im vorgesehenen Ordner startet und die lokale Diagnose durchläuft.

Schritt 3

Installiere, öffne und prüfe einen kontrollierten Workspace

  1. Folge der passenden Route in der offiziellen Installationsanleitung.
  2. Schließe den Claude-Code-Setup-Schritt im gemeinsamen Ordner ai-workspace ab.
  3. Führe claude --version und claude doctor in einem neu geöffneten Terminal aus.
  4. Starte claude aus dem Übungsordner und prüfe das angezeigte Arbeitsverzeichnis.

Prüfung: Die installierte Oberfläche und der aktuelle Ordner sind vor der ersten Anfrage sichtbar.

Video: Installing Claude Code · Offizieller Quickstart

Die erste Aufgabe hat ein beobachtbares Ergebnis und schließt technische Änderungen aus.

Schritt 4

Beginne mit einer begrenzten lesenden Aufgabe

Eine geeignete erste Anfrage nennt den Gegenstand, die erlaubte Handlung und die Abschluss-Evidenz.

  1. Nenne den genauen Ordner oder die Dateien, die Claude Code untersuchen darf.
  2. Lege fest, dass Dateien und Befehle während dieser Prüfung unverändert bleiben.
  3. Fordere ein kurzes Inventar an und bitte um Kennzeichnung von Unsicherheit.
  4. Vergleiche die Antwort mit dem sichtbaren Explorer, bevor du die Aufgabe erweiterst.

Prüfung: Die gemeldete Dateiliste entspricht dem Ordner und seine Änderungszeiten bleiben unverändert.

Modi und Eingriffe verändern, was das Harness während derselben Aufgabe ausführen darf.

Arbeitsloop

Wähle einen Modus für die nächste Handlung

  1. Verwende Plan Mode, um das Projekt zu untersuchen und vor Quelländerungen einen Ausführungsplan zu erhalten.
  2. Gib Änderungen frei, sobald vorgeschlagener Umfang und Prüfmethode klar sind.
  3. Verwende Bash Mode für einen bereits ausgewählten Befehl, den du selbst ausführen möchtest.
  4. Unterbrich einen laufenden Loop mit Esc und ergänze neue Informationen oder Grenzen.

Prüfung: Der gewählte Modus erlaubt die erforderliche Arbeit und blockiert Handlungen außerhalb der aktuellen Aufgabe.

Permission Modes · Interaktive Steuerung

Anweisungen, gepflegtes Wissen und technische Kontrollen erfüllen unterschiedliche Funktionen.

Schritt 5

Halte dauerhafte Projektregeln in CLAUDE.md fest

CLAUDE.md beschreibt, wie Claude Code in einem Projekt arbeitet. Die Datei kann in einen größeren Wissensbestand führen, ohne dessen Inhalt in jede Sitzung zu kopieren.

  1. Dokumentiere stabile Befehle, Dateikonventionen und Abschlussprüfungen.
  2. Verlinke für jedes inhaltliche Konzept oder jede Entscheidung das zuständige Wissensdokument.
  3. Bewahre aufgabenspezifische Evidenz in ihrer Quelldatei und lade sie bei Bedarf.
  4. Verwende Berechtigungen und Hooks, wenn eine Regel technisch durchgesetzt werden muss.

Prüfung: Jede dauerhafte Anweisung hat einen klaren Geltungsbereich und kann ohne Raten befolgt werden.

Projektanweisungen und Auto Memory

Permission Mode, Werkzeugregeln und Aufgaben-Scope bestimmen gemeinsam die verfügbaren Handlungen.

Schritt 6

Prüfe die Berechtigungsgrenze vor einer Handlung

Claude Code bewertet Werkzeugnutzung anhand des aktiven Permission Mode und der konfigurierten Regeln. Die erste Übung verwendet Plan Mode, damit die Repository-Untersuchung vor einem Änderungsvorschlag erfolgt.

  1. Wechsle in Plan Mode und prüfe den Berechtigungszustand vor der Aufgabe.
  2. Prüfe erlaubte und verweigerte Werkzeugregeln im Nutzer-, Projekt- und lokalen Scope.
  3. Lass Bypass Permissions für das Übungsrepository deaktiviert.
  4. Autorisiere eine Handlung erst, wenn Befehl, Ziel und erwartete Wirkung zur Aufgabe passen.

Prüfung: Der aktive Modus unterstützt die Untersuchung und jede schreibfähige Handlung verlangt weiterhin eine explizite Entscheidung.

Permission Modes · Berechtigungsregeln

Context Management richtet den aktuellen Arbeitsbestand auf den unmittelbar anstehenden Schritt aus.

Context Management

Kuratiere den Working Context für den aktuellen Schritt

Das Context Window enthält Anweisungen, ausgewählte Dateien, Werkzeugausgaben und Gesprächsverlauf für den aktuellen Modellaufruf.

  1. Prüfe mit /context, welche Inhalte das aktuelle Fenster belegen.
  2. Nenne relevante Dateien direkt und schließe Ordner ohne mögliche Evidenz aus.
  3. Verwende /compact, wenn dieselbe Aufgabe nach einer langen Untersuchung fortgesetzt wird.
  4. Verwende /clear, wenn eine getrennte Aufgabe einen leeren Working Context verlangt. Die gespeicherte Sitzung bleibt später wiederaufnehmbar.

Prüfung: Jedes große Context-Element trägt zur nächsten Entscheidung oder Werkzeughandlung bei.

Context Window · Funktionsweise von Claude Code

Ein Screenshot wird als Evidenz eines konkreten Interface-Zustands Teil der Prüfschleife.

Visuelles Feedback

Überführe Screenshots in eindeutige Abnahmekriterien

  1. Erfasse den kleinsten stabilen Ausschnitt, der das Problem zeigt.
  2. Entferne Accounts, persönliche Pfade, Tokens und vertrauliche Projektdaten.
  3. Beschreibe beobachteten und erforderlichen Zustand als Text.
  4. Rendere das Ergebnis im selben Viewport und vergleiche es anhand eines Abnahmekriteriums.

Prüfung: Der abschließende Screenshot belegt den angeforderten Zustand unter denselben Bedingungen.

Übliche Workflows

Die Erweiterungsmechanismen greifen an verschiedenen Stellen in das agentische Arbeitssystem ein.

Schritt 7

Wähle den Mechanismus nach seiner Funktion

Dauerhafte Anweisungen prägen jede Sitzung. Skills laden wiederverwendbare Verfahren, MCP verbindet externe Systeme und Plugins bündeln Erweiterungen für Installation und Verteilung.

Projektregel

Verwende CLAUDE.md für Konventionen, die bei jeder Arbeit von Claude Code in diesem Projekt gelten.

Verfahren

Verwende einen Skill für eine wiederholbare Methode, die bei einer passenden Aufgabe geladen werden soll.

Verbindung oder Verteilung

Verwende MCP für externe Systeme und ein Plugin, wenn mehrere Erweiterungskomponenten gemeinsam verteilt werden.

Offizieller Überblick über Erweiterungen

MCP bildet eine standardisierte Werkzeuggrenze zwischen Harness und externem System.

Externe Systeme

Füge eine MCP-Verbindung für einen definierten externen Bedarf hinzu

Das Model Context Protocol ermöglicht Claude Code die Nutzung von Werkzeugen, die ein externer Dienst oder lokaler Server bereitstellt.

  1. Benenne die externen Daten oder Handlungen, die die Aufgabe erfordert.
  2. Prüfe Serverquelle, angeforderte Zugangsdaten und verfügbare Werkzeuge.
  3. Trenne Lesezugriffe von Werkzeugen, die Informationen anlegen, verändern oder versenden.
  4. Füge den Server mit dem engsten angemessenen Geltungsbereich hinzu und prüfe seinen Zustand mit /mcp.

Prüfung: Jedes bereitgestellte Werkzeug ist für den Workflow erforderlich und seine lesende oder schreibende Wirkung ist verstanden.

Offizielle MCP-Anleitung

Ein Skill legt detaillierte Anweisungen und Ressourcen offen, sobald seine Aufgabe relevant wird.

Wiederverwendbare Verfahren

Verwende Skills für Wissen, das mit einem Workflow verbunden bleibt

Ein Skill ist ein wiederverwendbares Anweisungspaket für eine definierte Aufgabenklasse. Claude Code kann ihn bei passender Beschreibung laden oder auf direkte Anforderung verwenden.

  1. Stabilisiere Verfahren und Abschlussprüfung zunächst in einem erfolgreich wiederholten Workflow.
  2. Definiere eine konkrete Aufgabenklasse und den Trigger, der den Skill laden soll.
  3. Halte das zentrale Verfahren in SKILL.md und unterstützende Beispiele oder Skripte in eigenen Ressourcen fest.
  4. Führe den Skill an einem neuen Fall aus und prüfe das Artefakt anhand seiner Abschlusskriterien.

Prüfung: Der Skill ersetzt wiederholte prozedurale Prompts und hält Evidenz sowie Prüfungen nachvollziehbar.

Skills im Erweiterungsüberblick

Ein Plugin bündelt zusammengehörige Erweiterungskomponenten als installierbares Erweiterungspaket.

Verteilung

Verpacke eine stabile Erweiterung für ihre Wiederverwendung

Plugins können Skills, Subagents, Hooks und MCP-Server zur Installation in mehreren Projekten oder Teams bündeln.

  1. Entwickle eine projektspezifische Erweiterung in .claude/, solange sich ihr Vertrag verändert.
  2. Verpacke die Komponenten, sobald ihre Trigger, Berechtigungen und Prüfungen stabil sind.
  3. Prüfe ein Plugin und seine enthaltenen Server vor der Installation.
  4. Verwende einen Marketplace als Katalog und installiere nur das ausgewählte Plugin.

Prüfung: Das Plugin besitzt einen definierten Zweck, eine vertrauenswürdige Quelle und eine prüfbare Komponentenliste.

Plugins erstellen · Plugins finden

Ein Subagent untersucht eine begrenzte Frage in einem isolierten Context und liefert ein kompaktes Ergebnis zurück.

Delegierte Recherche

Delegiere eine klare Recherchefrage an einen frischen Context

Subagents eignen sich, wenn die Richtung bereits bekannt ist und eine eigenständige Frage konzentrierte Untersuchung oder umfangreiche Dateilektüre verlangt. Jeder Subagent beginnt mit einem frischen, isolierten Context Window; nur seine Rückgabe gelangt in das Hauptgespräch.

  1. Formuliere eine beantwortbare Frage und ihre Bedeutung für die Hauptaufgabe.
  2. Gib den erforderlichen Quellenrahmen, Grenzen und das Rückgabeformat vor.
  3. Fordere Befunde, Evidenz und verbleibende Unsicherheit an.
  4. Lass den Hauptagenten die Ergebnisse vergleichen, akzeptierte Befunde integrieren und die abschließenden Prüfungen ausführen.

Prüfung: Die Rückgabe beantwortet die delegierte Frage und nennt die für die Integration erforderliche Evidenz.

Offizielle Subagent-Anleitung · Parallele Agentenmuster

Context-Isolation und Datei-Isolation lösen unterschiedliche Koordinationsprobleme.

Paralleles Arbeiten

Ordne Aufgabe, Worker und Arbeitsbereich einander zu

Ein Subagent unterstützt eine Hauptsitzung. Eine parallele Sitzung ist ein eigenständig beaufsichtigter Arbeitsstrang. Ein Git-Worktree gibt einer schreibenden Sitzung eine eigene Arbeitskopie, damit gleichzeitige Änderungen nicht kollidieren.

  1. Verwende einen Subagent für eine begrenzte Untersuchung, deren ausführliche Zwischenschritte außerhalb des Hauptkontexts bleiben sollen.
  2. Verwende eine eigene Sitzung, wenn eine unabhängige Aufgabe direkte Betreuung und einen eigenen Context benötigt.
  3. Starte eine schreibende Sitzung mit claude --worktree <name>, wenn eine andere Sitzung dasselbe Repository bearbeitet.
  4. Vergleiche die Ergebnisse, löse widersprüchliche Annahmen auf und führe vor der Integration gemeinsame Prüfungen aus.

Prüfung: Jeder Worker besitzt eine unabhängige Frage oder einen eigenen Dateibereich, und gleichzeitige Änderungen können einander nicht überschreiben.

Parallele Agentenmuster · Claude-Code-Worktrees

Remote Control macht eine laufende lokale Sitzung über eine weitere Oberfläche zugänglich, während die Ausführung auf dem lokalen Rechner bleibt.

Optionale Steuerungsoberfläche

Setze eine lokale Sitzung über eine Remote-Oberfläche fort

Remote Control ist eine Research-Preview für dieselbe lokale Claude-Code-Sitzung. Browser oder mobile App steuern sie; Arbeitsordner, Werkzeuge und Berechtigungen verbleiben auf dem Host-Rechner.

  1. Prüfe die aktuellen offiziellen Anforderungen an Verfügbarkeit, Account und Organisation.
  2. Starte mit claude remote-control, claude --remote-control oder /remote-control in einer laufenden Sitzung.
  3. Öffne den angezeigten Link oder QR-Code auf dem vorgesehenen Remote-Gerät.
  4. Bestätige Sitzung und Arbeitsordner, bevor du eine Handlung freigibst oder unterbrichst.

Prüfung: Beide Oberflächen zeigen dasselbe Gespräch und Projekt, während die Ausführung auf dem lokalen Host verbleibt.

Offizielle Remote-Control-Anleitung

Die Einführung bildet einen Hub für gezielte Vertiefungen in die Mechanismen eines konkreten Workflows.

Nächste Routen

Setze mit dem Mechanismus fort, den deine Arbeit verlangt

Context Engineering

Anweisungen und Working Context

Entwickle einen pflegbaren Weg von Projektregeln und Wissensdokumenten zur ausgewählten Aufgaben-Evidenz.

Mit Anweisungen beginnen

Werkzeugintegration

MCP und Erweiterungs-Scope

Verbinde ein externes System und dokumentiere Werkzeuge, Zugangsdaten, Berechtigungen und Prüfungen.

Mit MCP beginnen

Delegierte Recherche

Subagents und Synthese

Zerlege eine Forschungsfrage in isolierte Untersuchungen und einen expliziten Integrationsschritt.

Mit Subagents beginnen

Paralleles Arbeiten

Sitzungen und Worktrees

Führe unabhängige Arbeit in getrennten Kontexten aus und isoliere gleichzeitige Dateiänderungen vor der Integration.

Mit Sitzungen beginnen

Remote-Workflow

Lokale Ausführung, Remote-Steuerung

Verbinde eine weitere Steuerungsoberfläche mit einer laufenden lokalen Sitzung, deren Host die Projektausführung behält.

Mit Remote Control beginnen

Visuelle Workflows

Screenshot-basierte Prüfung

Verwende stabile Aufnahmen und übereinstimmende Viewports, um eine Interface-Beobachtung in prüfbare Evidenz zu überführen.

Mit Screenshots beginnen

Prüfung: Wähle eine Route, weil sie einen konkreten Bedarf im aktuellen Projekt löst.

Die erste Übung endet mit Quellenverweisen und einer unabhängigen Git-Prüfung.

Schritt 8

Führe eine reversible Repository-Orientierung aus

Bitte Claude Code in Plan Mode um die Untersuchung des Repositorys, die geltenden Anweisungen und eine Erklärung der gepflegten Prüfungen.

  1. Fordere eine kompakte Repository-Zusammenfassung mit direkten Dateiverweisen an.
  2. Lass Claude Code die geltenden CLAUDE.md-Dateien und vorhandenen Verifikationsbefehle benennen.
  3. Vergleiche die Antwort mit den zitierten Dateien und Befehlsdefinitionen.
  4. Beende Claude Code und führe git status --short im Terminal aus.

Prüfung: Repository-Evidenz stützt die Zusammenfassung und git status --short entspricht der dokumentierten Ausgangslage.

Plan Mode · Projektanweisungen