Dein erstes Claude Code-Projekt

Fünf Minuten. Das ist alles, was du brauchst, um deine erste funktionierende App mit Claude Code zu bauen. Hello World überspringen. Wir bauen einen persönlichen Task-Manager, den du wirklich jeden Tag nutzen wirst.

Quick Win: Füge das zum Starten ein:

mkdir smart-todos && cd smart-todos && claude

Dein Workspace existiert. Claude Code ist darin live. Schau, was als nächstes passiert.

Sag Claude, was du willst, direkt und klar:

Der Prompt: "Create a CLI task manager where I can add tasks, mark them done, and see my list. Make it save to a file so tasks persist."

Ein vollständiger Plan kommt zurück. Du siehst wie Claude durchdenkt:

• Dateistruktur (eine einzelne Node.js-App)
• Kernverhalten (hinzufügen, abschließen, auflisten)
• Persistenz (eine JSON-Datei auf der Festplatte)
• Interface (saubere Terminal-Ausgabe)

Was Claude unter der Haube macht

Dieser Prompt ist kein Textgenerator, der dir einen Absatz hinwirft. Eine Tool-Chain läuft. Claude liest zuerst dein aktuelles Verzeichnis, sieht, dass nichts da ist, und baut einen Plan: was zu schreiben ist, in welcher Reihenfolge, welche Abhängigkeiten zu holen sind. Dann greift es auf das Write-Tool für jede Datei zurück, das Bash-Tool, um npm init -y auszuführen und Pakete zu installieren, und manchmal das Read-Tool, um zu prüfen, was es gerade geschrieben hat. Jeder Tool-Aufruf erscheint in der Unterhaltung, während er passiert.

Ein Chatbot wirft Code in ein Antwortfeld. Claude Code bearbeitet tatsächlich dein Dateisystem und führt Befehle in deinem Terminal aus. Die Dateien auf der Festplatte sind echt. Der node_modules-Ordner, der erscheint, ist auch echt.

Claude erstellt funktionierende Dateien direkt:

// Claude creates tasks.js automatically
#!/usr/bin/env node
import fs from 'fs';
import path from 'path';

const TASKS_FILE = path.join(process.cwd(), 'tasks.json');
// ... complete working code appears

Teste deinen neuen Task-Manager sofort:

node tasks.js add "Learn Claude Code"
node tasks.js add "Build something amazing"
node tasks.js list

Erwartete Ausgabe:

✓ Added: Learn Claude Code
✓ Added: Build something amazing

Your Tasks:
□ 1. Learn Claude Code
□ 2. Build something amazing

Zwei Minuten. Datei-Persistenz, Fehlerbehandlung und ordentliche Ausgabeformatierung funktionieren alle, in einer echten CLI-App.

Jetzt kommt der Spaß. Du verfeinst per Unterhaltung. Probiere das:

Farben hinzufügen: "Make completed tasks show in green and pending in yellow"

Prioritätssystem: "Let me add priority levels - high, medium, low"

Fälligkeitsdaten: "Allow setting due dates and show overdue tasks in red"

Suchfunktion: "Add ability to search tasks by keyword"

Jede Anfrage erscheint fast sofort. Keine Stack-Overflow-Tabs. Keine Konfigurations-Kaninchenlöcher. Das Verhalten beschreiben, zusehen wie es erscheint.

Der alte Weg zwang dich, alles zu wissen, bevor du anfingst:

• Welche Bibliotheken wählen
• Wie Dateien strukturiert sein sollen
• Kommandozeilen-Argumentenparsing
• Datei-I/O-Operationen
• Fehlerbehandlungsmuster

Claude Code lässt all diese Reibung weg. Du beschreibst das Ergebnis. Claude kümmert sich um die Klempnerarbeit.

Was du tatsächlich gebaut hast:

• Plattformübergreifende Dateioperationen
• JSON-Datenpersistenz
• Argumentparsing
• Farbige Terminal-Ausgabe
• Ordentliche Fehlerbehandlung
• Nutzerfreundliche Hilfenachrichten

Ein solches Projekt frisst normalerweise echte Setup-Zeit und Abhängigkeits-Suche. Hier hat ein einziger Prompt alles abgedeckt.

Schon feststeckend? Das Installations-Guide hat den detaillierten Setup-Walkthrough.

"Permission denied" beim Ausführen von tasks.js auf Mac oder Linux:

chmod +x tasks.js

"Module not found"-Fehler:

npm init -y && npm install commander chalk

Willst du es von überall ausführen? Das zu package.json hinzufügen:

{
  "bin": {
    "todo": "./tasks.js"
  }
}

Dann npm link ausführen. Jetzt funktioniert todo add "anything" von jedem Ordner auf deinem System.

Manchmal trifft der erste Versuch nicht genau das, was du dir vorgestellt hast. Das ist normal. Konversationelle Entwicklung erwartet das.

Claude hat Code geschrieben, aber er wirft Fehler, wenn du ihn ausführst. Den Fehler direkt in Claude Code einfügen. Sagen: "I got this error when running the app" und den vollständigen Stack Trace einfügen. Der Fehler wird gelesen, die Ursache identifiziert, die Datei gefixed. Die meisten Erstlaufs-Probleme sind fehlende Abhängigkeiten oder eine Node.js-Versions-Diskrepanz.

Die App läuft, macht aber nicht, was du beschrieben hast. Im nächsten Prompt genauer sein. "Es stimmt nicht" überspringen und genau sagen, was du erwartet hast und was du gesehen hast. "The list command shows tasks in the order they were added, but I want them sorted by priority" gibt Claude ein konkretes Ziel. Vages Feedback produziert vage Fixes.

Claude hat zu viele Dateien gebaut oder es übertrieben. Breite Prompts verursachen das. Für Claude kann "task manager" eine Datenbank, ein Konfigurationssystem und mehrere Module implizieren. Im nächsten Durchgang den Scope eingrenzen: "a single-file Node.js script, no database, store tasks in a JSON file." Enger Scope produziert engen Code.

Claude fragt ständig um Erlaubnis, bevor es Befehle ausführt. Das ist das Berechtigungssystem, das deinen Rechner schützt. Es pausiert bei Shell-Befehlen, Paket-Installationen und Schreibvorgängen außerhalb deines Projekts. "y" tippen, um jeden zu genehmigen, oder Auto-Genehmigung für die Befehle konfigurieren, denen du bereits vertraust.

Was gerade passiert ist:

• Du hast eine Idee in einfachem Deutsch beschrieben
• Claude hat eine vollständige, funktionierende App gebaut
• Du führst sie in weniger als fünf Minuten aus

Das ist konversationelles Programmieren. In Problemen und Lösungen denken. Syntax und APIs überspringen.

Dein Task-Manager funktioniert. Das als nächstes versuchen:

Nächster Prompt: "Add a web interface so I can manage tasks from my browser. Keep the CLI working too."

Ein Express-Server erscheint. Das HTML-Interface auch. Deine CLI läuft weiter, unberührt. Eine Full-Stack-App in Minuten.

Oder in eine andere Richtung abzweigen:

• Echte Projekt-Beispiele für Ideen durchsuchen
• Claude Code an deinen Workflow anpassen
• Häufige Probleme troubleshooten, wenn etwas schiefläuft

Traditionelle Tutorials lehren Syntax. Was du gerade gelernt hast, ist das Claude Code-Entwicklungsmuster. Derselbe Fünf-Schritt-Loop funktioniert bei einem CLI-Tool und bei einer Full-Stack-SaaS-App gleichermaßen.

1. Das gewünschte Ergebnis beschreiben. Fokus auf das, was das fertige Produkt macht, nicht wie du es bauen würdest. "A task manager where I can add, complete, and list tasks" schlägt "create a Node.js script using Commander.js with a JSON file store." Implementierungsdetails sind Claudes Problem. Steuerung kommt später.

2. Claude die Lösung entwerfen lassen. Deine Beschreibung wird in Dateistruktur, Abhängigkeiten und Build-Reihenfolge aufgeteilt. Bibliotheken werden ausgewählt. Muster werden gewählt. Hunderte kleiner Entscheidungen, die dich eine Stunde Recherche kosten würden, werden für dich getroffen. Mit einer davon nicht einverstanden? Einfach sagen "use sqlite instead of JSON files" und weitermachen.

3. Sofort testen. In dem Moment, in dem Claude aufhört zu schreiben, die Ausgabe ausführen. Nicht zuerst zeilenweise lesen. Echte Probleme (fehlende Abhängigkeiten, Runtime-Fehler) zeigen sich schnell, wenn du die Sache ausführst. Jeder Fehler, der zurück in Claude eingefügt wird, wird sofort gefixt.

4. Konversationell verbessern. Jeder Follow-up-Prompt fügt ein Feature hinzu oder passt Verhalten an. "Add due dates." "Make the output prettier." "Add a search command." Bestehender Code wird an Ort und Stelle geändert, und was bereits funktioniert, bleibt funktionierend. Dieser Loop ist schneller als vorab zu planen, weil jede Entscheidung gegen einen laufenden Prototyp getroffen wird.

5. Mit Vertrauen deployen. Bis du drei oder vier Verbesserungs-Zyklen drin bist, wurde deine App bei jedem Schritt getestet. Edge Cases wurden während der konversationellen Entwicklung aufgedeckt. Push zu Git. Ship it.

Das Muster hält bei jeder Größe. Solo-Devs bauen damit ganze SaaS-Apps. Teams nutzen es, um Features vor der Sprint-Planung zu prototypen.

Du hast etwas Echtes gebaut. Der nächste Schritt ist, Claude Code so zu bringen, dass es so denkt wie du. Zwei Guides sind der Weg dahin:

Configure Claude Code deckt Einstellungen, Berechtigungen und Modellauswahl ab. Da aktivierst du Auto-Genehmigung für vertrauenswürdige Befehle, wählst zwischen Sonnet und Opus nach Aufgabe und stimmst die Terminal-Erfahrung ab.

Der CLAUDE.md-Guide führt dich durch die Datei, die steuert, wie Claude sich bei jedem Projekt verhält. Von allem, was du nach deinem ersten Projekt tun kannst, zahlt sich dieses am meisten aus. Ein solides CLAUDE.md bedeutet, dass deine Coding-Standards eingehalten werden, deine bevorzugten Muster genutzt werden und Entscheidungen so getroffen werden, wie du sie treffen würdest.

Jenseits der Konfiguration:

• Den Skills-Guide lesen, um Claude tiefes Fachwissen in einer Domain zu geben
• Agent Fundamentals erkunden, um mehrere parallele Agenten bei großen Aufgaben einzusetzen
• In Troubleshooting einsteigen, wenn Dinge kaputt gehen