Praktische Übung

Dein erstes Projekt

Erstelle einen Ordner, starte Claude, und arbeite zusammen

Was du gleich tust:

  • Einen Projekt-Ordner erstellen
  • Ein paar Textdateien hineinlegen
  • Claude Code starten
  • Dein Projekt initialisieren
  • Mit Claude arbeiten

Dauer: ca. 10-15 Minuten

Bevor du startest

Stelle sicher, dass du Claude Code bereits installiert hast. Falls nicht, geh zuerst zur Installations-Anleitung.

Unser Beispiel-Projekt: Rezeptsammlung

Wir erstellen eine kleine Rezeptsammlung. Du kannst natürlich auch ein anderes Thema wählen — Reiseplanung, Buchnotizen, To-Do-Listen, was immer du willst.

Hands-on Exercise

Your First Project

Create a folder, start Claude, and work together

What you'll do:

  • Create a project folder
  • Add some text files
  • Start Claude Code
  • Initialize your project
  • Work with Claude

Duration: about 10-15 minutes

Before you start

Make sure you've already installed Claude Code. If not, go to the Installation Guide first.

Our Example Project: Recipe Collection

We'll create a small recipe collection. You can of course choose a different topic — travel planning, book notes, to-do lists, whatever you like.

Schritt 1: Ordner erstellen

Erstelle einen neuen Ordner auf deinem Computer. Das ist der "Arbeitsplatz" für dein Projekt.

1

Neuen Ordner anlegen

Geh zu deinem Dokumente-Ordner und erstelle einen neuen Ordner. Nenne ihn zum Beispiel: Meine-Rezepte

Mac: Rechtsklick → Neuer Ordner
Windows: Rechtsklick → Neu → Ordner

Tipp: Ordner-Namen

Verwende keine Leerzeichen im Ordner-Namen. Stattdessen nutze Bindestriche:

Meine-Rezepte
Meine Rezepte

So sollte es aussehen:

📁 Dokumente
📁 Meine-Rezepte ← Dein neuer Ordner!

Step 1: Create a Folder

Create a new folder on your computer. This will be the "workspace" for your project.

1

Create a new folder

Go to your Documents folder and create a new folder. Call it something like: My-Recipes

Mac: Right-click → New Folder
Windows: Right-click → New → Folder

Tip: Folder names

Don't use spaces in folder names. Use hyphens instead:

My-Recipes
My Recipes

This is what it should look like:

📁 Documents
📁 My-Recipes ← Your new folder!

Schritt 2: Textdateien erstellen

Jetzt fügen wir ein paar einfache Textdateien in den Ordner ein. Das sind die Dateien, mit denen Claude später arbeiten kann.

2

Erste Datei: Ein Rezept

Öffne einen Texteditor (Notepad auf Windows, TextEdit auf Mac) und schreibe:

Omas Apfelkuchen Zutaten: - 4 große Äpfel - 200g Mehl - 150g Zucker - 100g Butter - 2 Eier - 1 Päckchen Vanillezucker Zubereitung: Äpfel schälen und in Scheiben schneiden. Teig aus Mehl, Zucker, Butter und Eiern zubereiten. Bei 180°C ca. 45 Minuten backen.

Speichere die Datei als apfelkuchen.txt in deinem Rezepte-Ordner.

3

Zweite Datei: Noch ein Rezept

Erstelle eine weitere Datei:

Schnelle Tomatensuppe Zutaten: - 1 Dose Tomaten - 1 Zwiebel - 2 EL Olivenöl - Salz, Pfeffer - Basilikum Zubereitung: Zwiebel anbraten, Tomaten dazu. 10 Minuten köcheln, pürieren, würzen.

Speichere als tomatensuppe.txt

Dein Ordner sieht jetzt so aus:

📁 Meine-Rezepte
📄 apfelkuchen.txt
📄 tomatensuppe.txt

Nur 2 Dateien?

Ja, für den Anfang reicht das völlig! Du kannst später jederzeit mehr hinzufügen. Claude kann mit beliebig vielen Dateien arbeiten.

Step 2: Create Text Files

Now let's add some simple text files to the folder. These are the files that Claude can work with later.

2

First file: A recipe

Open a text editor (Notepad on Windows, TextEdit on Mac) and write:

Grandma's Apple Pie Ingredients: - 4 large apples - 200g flour - 150g sugar - 100g butter - 2 eggs - 1 packet vanilla sugar Instructions: Peel apples and slice them. Make dough from flour, sugar, butter and eggs. Bake at 180°C for about 45 minutes.

Save the file as apple-pie.txt in your recipes folder.

3

Second file: Another recipe

Create another file:

Quick Tomato Soup Ingredients: - 1 can tomatoes - 1 onion - 2 tbsp olive oil - Salt, pepper - Basil Instructions: Sauté onion, add tomatoes. Simmer 10 minutes, blend, season.

Save as tomato-soup.txt

Your folder now looks like this:

📁 My-Recipes
📄 apple-pie.txt
📄 tomato-soup.txt

Only 2 files?

Yes, that's enough to start! You can always add more later. Claude can work with any number of files.

Schritt 3: Terminal öffnen

Jetzt öffnen wir das Terminal und navigieren zu deinem Ordner.

4

Terminal öffnen

Drücke Cmd + Leertaste, tippe Terminal, drücke Enter.

5

Zum Ordner navigieren

Tippe diesen Befehl und drücke Enter:

Terminal
$ cd ~/Documents/Meine-Rezepte

cd = "change directory" (Ordner wechseln)
~ = dein Benutzer-Ordner

4

PowerShell öffnen

Drücke die Windows-Taste, tippe PowerShell, klicke darauf.

5

Zum Ordner navigieren

Tippe diesen Befehl und drücke Enter:

PowerShell
PS> cd ~\Documents\Meine-Rezepte

cd = "change directory" (Ordner wechseln)
~ = dein Benutzer-Ordner

Nützliche Befehle

cd Ordnername — In Ordner wechseln
cd .. — Einen Ordner nach oben
ls (Mac) oder dir (Windows) — Inhalt anzeigen

Alternativ: Claude sagen, wohin es gehen soll

Du kannst Claude auch einfach sagen: "Geh in den Ordner Meine-Rezepte in meinen Dokumenten" — Claude kann das selbst herausfinden!

Step 3: Open Terminal

Now let's open the terminal and navigate to your folder.

4

Open Terminal

Press Cmd + Space, type Terminal, press Enter.

5

Navigate to your folder

Type this command and press Enter:

Terminal
$ cd ~/Documents/My-Recipes

cd = "change directory" (switch folders)
~ = your user folder

4

Open PowerShell

Press the Windows key, type PowerShell, click on it.

5

Navigate to your folder

Type this command and press Enter:

PowerShell
PS> cd ~\Documents\My-Recipes

cd = "change directory" (switch folders)
~ = your user folder

Useful commands

cd foldername — Go into a folder
cd .. — Go up one folder
ls (Mac) or dir (Windows) — Show contents

Alternative: Just tell Claude where to go

You can also simply tell Claude: "Go to the My-Recipes folder in my Documents" — Claude can figure it out!

Schritt 4: Claude starten

Du bist jetzt im richtigen Ordner. Zeit, Claude zu starten!

6

Claude starten

Tippe einfach:

Terminal
$ claude

Nach ein paar Sekunden siehst du Claudes Begrüßung.

Claude Code
╭──────────────────────────────────────────╮
Claude Code
Working in: ~/Documents/Meine-Rezepte
╰──────────────────────────────────────────╯

You: _

Was siehst du?

Claude zeigt dir, in welchem Ordner es arbeitet. Das ist jetzt dein Rezepte-Ordner!

Der Cursor blinkt — Claude wartet auf deine erste Nachricht.

Step 4: Start Claude

You're now in the right folder. Time to start Claude!

6

Start Claude

Simply type:

Terminal
$ claude

After a few seconds, you'll see Claude's greeting.

Claude Code
╭──────────────────────────────────────────╮
Claude Code
Working in: ~/Documents/My-Recipes
╰──────────────────────────────────────────╯

You: _

What do you see?

Claude shows you which folder it's working in. That's now your recipes folder!

The cursor is blinking — Claude is waiting for your first message.

Schritt 5: Projekt initialisieren

Jetzt kommt ein wichtiger Schritt: Wir erstellen eine CLAUDE.md Datei. Das ist das "Briefing" für Claude, das wir in Modul 1 kennengelernt haben.

7

Tippe /init

Schreibe diesen Befehl:

Claude Code
You: /init

Was passiert jetzt?

Claude schaut sich deinen Ordner an und fragt dich, was für ein Projekt das ist. Das ist ein spezielles Feature: Claude stellt dir Fragen, bevor es etwas tut.

Claude:
Ich sehe hier einen Ordner mit Rezepten. Soll ich eine CLAUDE.md erstellen?

Was ist der Zweck dieses Projekts?
○ Rezeptsammlung für die Familie
○ Kochbuch-Entwurf
○ Persönliche Rezeptnotizen
○ Andere (bitte beschreiben)

Das "Frage-Tool"

Claude kann dir Fragen stellen, um besser zu verstehen, was du brauchst. Das nennt sich AskUserQuestion — und du kannst es auch selbst nutzen!

Wähle eine Antwort aus oder schreibe deine eigene.

8

Antworte Claude

Wähle eine Option oder tippe deine eigene Antwort. Claude erstellt dann eine passende CLAUDE.md für dich.

Danach sieht dein Ordner so aus:

📁 Meine-Rezepte
📄 CLAUDE.md ← Neu erstellt!
📄 apfelkuchen.txt
📄 tomatensuppe.txt

Step 5: Initialize Project

Now comes an important step: We'll create a CLAUDE.md file. This is the "briefing" for Claude that we learned about in Module 1.

7

Type /init

Write this command:

Claude Code
You: /init

What happens now?

Claude looks at your folder and asks you what kind of project this is. This is a special feature: Claude asks questions before doing anything.

Claude:
I see a folder with recipes here. Should I create a CLAUDE.md?

What is the purpose of this project?
○ Recipe collection for the family
○ Cookbook draft
○ Personal recipe notes
○ Other (please describe)

The "Question Tool"

Claude can ask you questions to better understand what you need. This is called AskUserQuestion — and you can use it yourself too!

Choose an answer or write your own.

8

Answer Claude

Select an option or type your own answer. Claude will then create an appropriate CLAUDE.md for you.

After that, your folder looks like this:

📁 My-Recipes
📄 CLAUDE.md ← Newly created!
📄 apple-pie.txt
📄 tomato-soup.txt

Schritt 6: Deine erste Aufgabe

Jetzt ist alles bereit! Lass uns Claude eine erste Aufgabe geben.

9

Frag Claude etwas

Probiere eine dieser Fragen:

Du:
Welche Rezepte habe ich hier? Mach mir eine Übersicht.
Claude:
Ich habe 2 Rezepte in deinem Ordner gefunden:

1. Omas Apfelkuchen (apfelkuchen.txt)
— Süßes Backrezept
— Zubereitungszeit: ca. 45 Min Backen

2. Schnelle Tomatensuppe (tomatensuppe.txt)
— Herzhaftes Suppenrezept
— Zubereitungszeit: ca. 15 Min

Soll ich mehr Details zu einem der Rezepte zeigen?

Weitere Ideen zum Ausprobieren:

  • "Erstelle ein neues Rezept für Pasta mit Tomatensoße"
  • "Sortiere die Rezepte nach Zubereitungszeit"
  • "Welche Zutaten brauche ich für alle Rezepte zusammen?"
  • "Füge zu jedem Rezept eine Schwierigkeitsstufe hinzu"

Erinnerung: Claude liest dein Briefing

Weil du /init ausgeführt hast, kennt Claude jetzt den Kontext. Du musst nicht jedes Mal erklären, worum es geht!

Step 6: Your First Task

Everything is ready now! Let's give Claude a first task.

9

Ask Claude something

Try one of these questions:

You:
What recipes do I have here? Give me an overview.
Claude:
I found 2 recipes in your folder:

1. Grandma's Apple Pie (apple-pie.txt)
— Sweet baking recipe
— Prep time: about 45 min baking

2. Quick Tomato Soup (tomato-soup.txt)
— Savory soup recipe
— Prep time: about 15 min

Would you like more details about any of these recipes?

More ideas to try:

  • "Create a new recipe for pasta with tomato sauce"
  • "Sort the recipes by preparation time"
  • "What ingredients do I need for all recipes combined?"
  • "Add a difficulty level to each recipe"

Remember: Claude reads your briefing

Because you ran /init, Claude now knows the context. You don't have to explain what this is about every time!

Geschafft!

Du hast gerade dein erstes Projekt
mit Claude Code eingerichtet!

Was du gelernt hast:

1

Ordner als Arbeitsplatz

Ein Ordner = ein Projekt. Claude arbeitet mit allem, was darin liegt.

2

Navigation im Terminal

cd Ordner zum Wechseln, cd .. zum Zurückgehen.

3

/init erstellt dein Briefing

Claude fragt nach und erstellt eine CLAUDE.md mit dem Projekt-Kontext.

4

Claude stellt Fragen

Mit dem AskUserQuestion-Tool fragt Claude nach, statt zu raten.

Nächste Schritte

Experimentiere weiter mit deinem Rezept-Ordner. Oder erstelle einen neuen Ordner für ein anderes Projekt — die Schritte sind immer gleich:

  1. Ordner erstellen
  2. Dateien hinzufügen
  3. claude starten
  4. /init ausführen
  5. Loslegen!

Tipp: Beenden

Um Claude zu beenden, tippe /exit oder drücke Ctrl + C.

Done!

You just set up your first project
with Claude Code!

What you learned:

1

Folders as workspaces

One folder = one project. Claude works with everything in it.

2

Terminal navigation

cd folder to switch, cd .. to go back.

3

/init creates your briefing

Claude asks questions and creates a CLAUDE.md with project context.

4

Claude asks questions

With the AskUserQuestion tool, Claude asks instead of guessing.

Next steps

Keep experimenting with your recipes folder. Or create a new folder for another project — the steps are always the same:

  1. Create a folder
  2. Add files
  3. Start claude
  4. Run /init
  5. Get started!

Tip: Exit

To exit Claude, type /exit or press Ctrl + C.