CGS IT Solutions GmbH — Claude für Wissensarbeit · W3 · Vom Auftrag zum Projektordner · v2.0.1

W3

Vom Auftrag zum Projektordner

Claude Code im Code-Tab — ohne Terminal

Inhalt

1Wann sich ein Projektordner lohnt — einmalige gegen wiederkehrende Arbeit 2Der Code-Tab — Sitzung, Ordner, Permission-Modus, Änderungen prüfen 3Anweisungen und Skills als Dateien — CLAUDE.md, Skills im Ordner, App gegen Claude Code, Skills prüfen 4Weitergeben — Ordner teilen, Git als Ausblick, Anschluss an die Tour Übung — der Monatsbericht als Projektordner Übung — einen kaputten Skill reparieren Glossar — Begriffe zum Nachschlagen

Wann sich ein Projektordner lohnt

Einmalige gegen wiederkehrende Arbeit

Wiederkehrende Arbeit gehört in einen Projektordner

Einzelaufgaben gehören in die App, wiederkehrende Arbeit in einen Projektordner.

Einzelaufgabe wiederkehrende Arbeit
Beispieleine Recherche, ein Entwurf, eine AuswertungMonatsbericht, Wochen-Briefing, Angebotsprüfung
woClaude-AppProjektordner im Code-Tab der Desktop-App
Kontext stehtim Auftrag oder im App-Projektin CLAUDE.md, Vorlagen und Skills als Dateien
danachprüfen, weitergeben, fertigAnweisung verbessern, beim nächsten Mal gilt sie
Was wiederkehrt, verdient eine Datei statt eines Prompts.
checked am 2026-09-26 gegen docs/en/desktop

Was der Projektordner dazugibt

Ein Ordner macht aus einem Prompt eine Arbeitsanweisung, die man lesen, ändern und weitergeben kann.

  1. Die Anweisung steht in einer Datei und nicht im Kopf. Wer sie ändert, sieht, was vorher stand.
  2. Vorlagen und Skills liegen daneben und werden bei Bedarf geladen.
  3. Dasselbe läuft lokal und in der Cloud: Eine Cloud-Routine übernimmt CLAUDE.md und Skills aus dem Repository.
  4. Weitergeben heißt Ordner kopieren — oder, mit Git, das Repository teilen.
monatsbericht-vertrieb/
  CLAUDE.md # wer, wofür, Regeln
  vorlage.md
  .claude/
    skills/
      zahlen-pruefen/
        SKILL.md
  eingang/ # Exporte des Monats
  berichte/ # Ergebnisse
checked am 2026-09-26 gegen docs/en/cloud-environments

Der Code-Tab

Sitzung, Ordner, Permission-Modus, Änderungen prüfen

Was vor der ersten Nachricht im Code-Tab feststeht

Im Code-Tab ist jede Unterhaltung eine Sitzung mit eigenem Ordner und eigenem Verlauf.
Vor der ersten Nachricht werden vier Dinge festgelegt.

  1. Umgebung: Local arbeitet auf dem eigenen Rechner mit direktem Zugriff auf die Dateien, Cloud läuft bei Anthropic weiter, wenn die App zu ist.
  2. Projektordner: der Ordner, in dem Claude arbeitet. Ein Ordner genügt — Git ist nicht nötig.
  3. Modell: wählbar neben dem Senden-Knopf, auch während der Sitzung.
  4. Permission-Modus: wie viel Claude ohne Rückfrage darf (nächste Folie).
# Desktop-App, Tab "Code"
Umgebung Local
Ordner ~/Berichte/monatsbericht
Modell # Auswahl
Modus Plan

# dann der Auftrag:
Mach den Bericht für September.
Über den +-Knopf kommen Dateien, Skills, Connectors und Plugins in die Sitzung — ohne Terminal.
checked am 2026-09-26 gegen docs/en/desktop

Was Claude im Code-Tab ohne Rückfrage darf

Der Modus gilt für die Sitzung und lässt sich jederzeit wechseln.
Für den Anfang gilt: erst planen lassen, dann freigeben.

Modus was passiert
ManualClaude fragt vor jeder Dateiänderung und jedem Befehl; jede Änderung ist einzeln annehmbar
Accept editsDateiänderungen und einfache Dateibefehle wie mkdir, mv gehen ohne Rückfrage, andere Befehle werden erfragt
PlanClaude liest und schlägt einen Plan vor, ändert aber nichts
Autoalles läuft, eine Sicherheitsprüfung im Hintergrund blockiert Unpassendes
Bypass permissionskeine Rückfragen — laut Doku nur in abgeschotteten Containern oder virtuellen Maschinen; bei Team entscheidet die Organisation
Neue Aufgabe: Plan.
Plan passt: Accept edits.
Unklar, was passiert: Manual.
checked am 2026-09-26 gegen docs/en/desktop

Änderungen prüfen, bevor man sie behält

Claude zeigt nach jeder Änderung, was sich in welcher Datei geändert hat.
Man kann einzelne Zeilen kommentieren, und Claude arbeitet die Kommentare ein.

  1. Die Änderungsanzeige (etwa +12 -1) öffnet die Ansicht mit allen geänderten Dateien.
  2. Zeile anklicken, Kommentar schreiben — mehrere sammeln und gemeinsam abschicken.
  3. Gut prüfbar sind Textdateien: CLAUDE.md, Markdown, Tabellen als CSV. Bei Word- und Excel-Dateien öffnet man das Ergebnis selbst.
  4. Unterbrechen geht jederzeit: Stopp-Knopf, oder eine Korrektur tippen — Claude liest sie nach dem aktuellen Schritt.
# Änderung an CLAUDE.md
 ## Bericht
 Abschnitte: Umsatz, Pipeline,
- Risiken
+ Risiken, je mit Verantwortlichem
+ Zahlen immer mit Quelle (Datei,
+ Blatt, Zelle)

# Kommentar an Zeile 5:
# "Quelle als Fußnote, nicht im Text"
checked am 2026-09-26 gegen docs/en/desktop

Anweisungen und Skills als Dateien

CLAUDE.md, Skills im Ordner

CLAUDE.md ist die Projektanweisung als Datei

Claude Code liest die Datei CLAUDE.md im Projektordner zu Beginn jeder Sitzung.
Sie ist dasselbe wie die Anweisungen eines App-Projekts — nur als Datei.

  1. Liegt im Ordner als CLAUDE.md oder .claude/CLAUDE.md.
  2. Kurz halten: Die Doku empfiehlt unter 200 Zeilen. Längere Dateien kosten Kontext und werden schlechter befolgt.
  3. /init legt einen ersten Entwurf an, den man danach von Hand verbessert.
  4. Es ist Kontext, keine Sperre: „Claude treats them as context, not enforced configuration."
# CLAUDE.md
# Monatsbericht Vertrieb Ost

Du erstellst den Monatsbericht aus den
Exporten in eingang/.
- Vorlage: vorlage.md
- Abschnitte: Umsatz, Pipeline, Risiken
- Zahlen immer mit Quelle
- Ergebnis nach berichte/JJJJ-MM.md
- Nichts versenden, nichts löschen.
checked am 2026-09-26 gegen docs/en/memory

Ein Skill im Projektordner

Ein Skill ist ein Ordner mit SKILL.md unter .claude/skills/.
Claude lädt ihn, wenn die Aufgabe passt, oder man ruft ihn mit /name auf.

  1. Gleiches Format wie in der App — ein Ordner mit SKILL.md, Name und Beschreibung oben.
  2. Im Projektordner gilt er für alle, die mit diesem Ordner arbeiten.
  3. Aufruf: automatisch, wenn die Beschreibung passt, oder über / und die Liste im Eingabefeld.
  4. Skripte daneben sind erlaubt — etwa eine Prüfung, ob alle Zahlen eine Quelle haben.
# .claude/skills/zahlen-pruefen/SKILL.md
---
name: zahlen-pruefen
description: Prüft einen Bericht:
  jede Zahl braucht eine Quelle
  (Datei, Blatt, Zelle).
---
Lies den Bericht. Liste jede Zahl
ohne Quelle mit Abschnitt auf.
Ändere nichts am Bericht.
checked am 2026-09-26 gegen docs/en/skills

Woher Claude Code Skills lädt

Wo ein Skill liegt, entscheidet, welche Sitzungen ihn sehen.

Ort gilt für in der Cloud (W4)
Projektordner .claude/skills/Sitzungen in diesem Ordner, mit Git für alle im Teamja, aus dem Repository
persönlich ~/.claude/skills/alle Projekte auf diesem Rechnernein
Claude-Konto (in der App hochgeladen)App und Claude Code, gleiches Kontoja
Pluginalle, die das Plugin installiert habennein
Was im Projektordner liegt, läuft überall gleich.
checked am 2026-09-26 gegen docs/en/skills

Welche Kopf-Felder wo erlaubt sind

Dasselbe Format, verschiedene Regeln: Claude Code kennt alle Felder, der Upload in die Claude-App nur sechs.

Feld im Kopf der SKILL.md Upload in die Claude-App Claude Code
name, descriptionPflichtdescription empfohlen, name optional
license, compatibility, metadataerlaubt, nur zur Informationerlaubt, nur zur Information
allowed-toolserlaubtWerkzeuge ohne Rückfrage, bis zur nächsten Nachricht
when_to_use, paths, arguments, argument-hintUpload bricht abwann der Skill anspringt, welche Argumente er nimmt
disable-model-invocation, user-invocableUpload bricht abwer ihn auslösen darf
disallowed-tools, model, effort, context, agent, background, hooks, shellUpload bricht abWerkzeuge sperren, Modell wählen, als Subagent laufen
Claude Code ignoriert ein unbekanntes Feld ohne Meldung.
Der Upload in die App bricht mit „Unexpected key(s)" ab.
checked am 2026-09-26 gegen docs/en/skills

Ein Skill für App und Claude Code

Wer nur die sechs erlaubten Felder verwendet, kann denselben Skill in der App und in Claude Code nutzen.

  1. Anthropics Dokument-Skills für Word, Excel, PowerPoint und PDF kommen in Claude Code nur an, wenn man dort mit dem Claude-Konto angemeldet ist.
  2. Netzzugang: In der App je nach Admin-Einstellung voll, teilweise oder gar nicht. In Claude Code wie jedes Programm auf dem Rechner.
  3. Befehle im Skill-Text (!befehl) laufen nur in Claude Code.
  4. Abgleich nur in eine Richtung: App-Skills kommen in Claude Code an, lokale Skills nicht in die App.
---
name: protokoll
description: Erstellt ein Besprechungs-
  protokoll aus Notizen. Nicht für Mails.
compatibility: Braucht Zugriff auf
  den Projektordner.
metadata:
  version: 1.0.0
  owner: Vertrieb Ost
---
# läuft in App und Claude Code

# nur Claude Code, Upload bricht ab:
disable-model-invocation: true
checked am 2026-09-26 gegen docs/en/skills

Einen Skill prüfen, bevor man ihm traut

Ein Skill wird in drei Stufen geprüft: Springt er an? Tut er, was er soll? Lohnt er sich?

  1. Springt er an? Drei Test-Prompts: einer, bei dem er anspringen soll, einer, bei dem nicht, einer aus der Grauzone.
  2. Tut er, was er soll? Denselben Auftrag mehrmals laufen lassen — die Ergebnisse müssen dieselbe Form haben.
  3. Lohnt er sich? Nicht jede Aufgabe braucht einen Skill. Was einmal vorkommt, bleibt ein Auftrag.
  4. Direkt aufrufen geht immer mit /name — wer nur so testet, merkt nicht, ob er von selbst anspringt.
# Test-Prompts für den Skill "protokoll"
soll anspringen
Mach aus den Notizen ein Protokoll.

soll nicht anspringen
Schreib eine Mail an Jonas.

Grauzone
Fass die Teamrunde in drei Sätzen
zusammen.
checked am 2026-09-26 gegen docs/en/skills

Wenn ein Skill nicht tut, was er soll

Die meisten Fehler sitzen in der Beschreibung oder im Kopf der Datei — und sind unsichtbar, weil der Skill trotzdem lädt.

Symptom häufige Ursache Abhilfe
springt nie anBeschreibung ohne die Wörter, die man tatsächlich sagtStichwörter der Nutzer:innen in die Beschreibung
springt nie an, obwohl die Beschreibung gut istKopf wird nicht gelesen: --- nicht in der ersten Zeile, Feldname falsch geschrieben--- als erste Zeile, Feldnamen exakt wie in der Doku
springt auf alles anBeschreibung zu weit, etwa „always use"enger fassen, sagen, wofür nicht
Ergebnis schwanktwidersprüchliche oder vage Anweisungenein Format, ein Beispiel
erfindet Angabenkein Umgang mit Lücken beschrieben„fehlt etwas: nachfragen oder [offen]"
Ein falsch geschriebener Feldname wird ohne Fehlermeldung ignoriert.
checked am 2026-09-26 gegen docs/en/skills

Weitergeben

Ordner teilen, Git als Ausblick, Anschluss an die Tour

Git hält jede Änderung am Ordner fest

Mit Git wird aus einem Ordner ein Repository mit Geschichte, das man teilen kann.
Für den Anfang ist das nicht nötig.

  1. Ohne Git: Ordner auf ein geteiltes Laufwerk legen. Änderungen sind dann nicht nachvollziehbar.
  2. Mit Git: jede Änderung an CLAUDE.md und Skills mit Datum und Autor:in. Claude Code kann die Git-Befehle selbst ausführen.
  3. Mit GitHub: Eine Cloud-Routine klont das Repository bei jedem Lauf und benutzt seine CLAUDE.md und Skills — Arbeit nach Zeitplan, ohne eigenen Rechner (W4).
  4. Wer tiefer einsteigen will: Kapitel 0.1, die Tour durch Claude Code im Terminal.
Ordnerlokal, im Code-Tab
Git-Repositoryjede Änderung festgehalten
GitHubgeteilt, Cloud-Routines möglich
jede Stufe optional, jede baut auf der vorigen auf
checked am 2026-09-26 gegen docs/en/routines

Übung — der Monatsbericht als Projektordner

Aus dem Auftrag, den man jeden Monat neu tippt, wird ein Ordner, der ihn kennt.

1Ordner anlegen — monatsbericht/ mit eingang/ (zwei Beispiel-Exporte) und berichte/.
2Code-Tab öffnen — Local, diesen Ordner, Modus Plan; Auftrag: „Leg eine CLAUDE.md für einen Monatsbericht an."
3Plan prüfen, dann Accept edits — CLAUDE.md entsteht, Änderung im Diff lesen und kommentieren.
4Kurzer Auftrag: „Mach den Bericht für September." — ohne weitere Erklärung.
5Neue Sitzung, gleicher Ordner: „Was weißt du über dieses Projekt?" — ohne etwas zu erklären.
6Abnahme — Bericht in berichte/, jede Zahl mit Quelle; die neue Sitzung nennt Abschnitte und Quellenregel aus der CLAUDE.md.
Wer fertig ist: den Skill zahlen-pruefen anlegen und auf den Bericht loslassen.

Übung — einen kaputten Skill reparieren

Ein Kollege schickt einen Skill für Besprechungsprotokolle.
„Manchmal springt er an, manchmal nicht."

1Kopieren und öffnen — exercises/wa-03-skill-reparieren/starter/ kopieren, im Code-Tab öffnen, Modus Plan.
2Erst testen — die drei Test-Prompts aus der Aufgabe, notieren, was passiert.
3Fehler finden — in SKILL.md stecken mindestens acht. Zu jedem ein Satz: was falsch ist, was daraus folgt.
4Reparieren lassen — mit eurer Fehlerliste, nicht mit „mach ihn besser".
5Abnahme — springt bei Prompt 1 an, bei Prompt 2 nicht; Protokoll mit [offen] statt Erfundenem; nichts versendet.

W3 in fünf Sätzen

Was von diesem Deck hängenbleiben soll.

  1. Einmalige Arbeit in der App, wiederkehrende im Projektordner.
  2. Der Code-Tab braucht nur einen Ordner — kein Terminal, kein Git.
  3. Erst planen lassen, dann freigeben, und jede Änderung vor dem Übernehmen ansehen.
  4. CLAUDE.md ist die Projektanweisung als Datei — Kontext, keine Sperre.
  5. Was im Projektordner liegt, läuft überall gleich: lokal, im Team und in der Cloud.

Glossar Glossar

Projektordner Ordner auf dem Rechner, in dem Claude Code arbeitet, mit CLAUDE.md, Vorlagen und Skills.
Code-Tab Der Bereich der Desktop-App, in dem Claude Code ohne Terminal läuft.
Sitzung Eine Unterhaltung im Code-Tab mit eigenem Ordner und eigenem Verlauf.
CLAUDE.md Datei im Projektordner mit Anweisungen, die Claude Code zu Beginn jeder Sitzung liest.
Permission-Modus Einstellung, was Claude ohne Rückfrage darf: Manual, Accept edits, Plan, Auto.
Diff Die Anzeige, was sich in einer Datei geändert hat: entfernte und hinzugefügte Zeilen.
Git Werkzeug, das jede Änderung an Dateien mit Datum und Autor:in festhält.
Repository Ein Ordner unter Git, mit seiner ganzen Änderungsgeschichte; teilbar etwa über GitHub.
Frontmatter Der Kopf einer SKILL.md zwischen zwei ----Zeilen, mit Feldern wie name und description.
Beschreibung (description) Das Feld, anhand dessen Claude entscheidet, ob ein Skill zur Aufgabe passt.

© 2026 CGS IT Solutions GmbH

Alle Rechte vorbehalten

Diese Schulungsunterlagen sind urheberrechtlich geschützt. Vervielfältigung, Weitergabe oder kommerzielle Nutzung — auch in Auszügen — nur mit ausdrücklicher schriftlicher Genehmigung der CGS IT Solutions GmbH.

cgsit-claude-training · Wissensarbeit W3 · Projektordner · v2.0.1