Team-Workflow · Claude Code

Der 20-Minuten-Trick: So nutzt dein Team Claude Code ohne Chaos

Einmal sauber aufsetzen, danach laeuft euer Workflow ruhig: gemeinsame Regeln im Repo, lokale Secrets auf jedem Rechner und klare Git-Routine fuer den Alltag.

20. April 2026 · 7 Minuten Lesezeit

Die wichtigste Trennung zuerst

Claude Code im Team funktioniert dann stabil, wenn ihr Projekt-Dateien und lokale Rechnerdaten sauber trennt. Alles im Projektordner kann versioniert werden. Alles Personalisierte und Sensitive bleibt lokal.

Wird geteilt

  • CLAUDE.md
  • .claude/skills/
  • .claude/commands/
  • .claude/agents/
  • .claude/settings.json
  • .gitignore

Bleibt lokal

  • .claude/settings.local.json
  • .env (Secrets)
  • API-Schluessel
  • node_modules/ und .venv/
  • .DS_Store
  • Persoenliche Notizen

Setup in 5 Schritten (Admin)

Diese Schritte machst du genau einmal, danach kann dein Team direkt starten.

1. Projektordner erstellen und Git initialisieren

mkdir claude-team && cd claude-team\ngit init

2. CLAUDE.md mit Team-Regeln anlegen

# Team-Konventionen\n- Kurz, praezise Prompts\n- Keine Secrets im Repo\n- Commits mit klarer Begruendung

3. Claude-Ordnerstruktur anlegen

mkdir -p .claude/skills .claude/commands .claude/agents

4. .gitignore fuer lokale Daten setzen

.claude/settings.local.json\n.env\nnode_modules/\n.venv/\n.DS_Store

5. Erstes Commit und Team einladen

git add .\ngit commit -m "Initiales Team-Setup fuer Claude Code"\ngit push -u origin main

Team-Routine fuer den Alltag

Morgens

Vor dem Arbeiten immer zuerst Updates holen.

git pull

Tagsueber

Claude Code lokal nutzen, wie gewohnt.

claude

Nach wichtigen Aenderungen

Neue Skills und Regeln committen und pushen.

git add .\ngit commit -m "Neuer Skill + Teamregel"\ngit push

Bei Konflikten

Kurz abstimmen, Konflikt in Ruhe aufloesen, dann committen.

6 Regeln, die euch spaeter Stunden sparen

  • Private Repositories nutzen, wenn ihr mit Kundenkontext, Prompts oder internen Ablaufen arbeitet.
  • Keine Tokens oder Schluessel in CLAUDE.md speichern.
  • settings.local.json immer lokal halten und in .gitignore absichern.
  • Bei groesseren Umbauten in Branches arbeiten, nicht direkt auf main.
  • CLAUDE.md kurz und eindeutig halten.
  • Commit-Messages so schreiben, dass das Warum klar wird.

Was viele Teams am Anfang vergessen

1. Hooks sind oft nicht ausfuehrbar

Nach dem Klonen fehlt bei Shell-Hooks haeufig das Execute-Bit.

chmod +x .claude/hooks/*.sh

2. Rollen sauber vergeben

Nicht jeder braucht Admin-Rechte. Fuer den Alltag reichen Write-Rechte, Admin nur fuer Repo-Settings und Sicherheits-Policies.

3. Einheitliche Commit-Struktur

Legt ein kleines Commit-Schema fest, dann versteht jedes Teammitglied den Verlauf auch Wochen spaeter.

feat: neuer skill fuer landingpages\nfix: konflikt in CLAUDE.md aufgeloest\ndocs: team-regeln aktualisiert

4. Ein fester Weekly-Cleanup

15 Minuten pro Woche reichen: veraltete Regeln streichen, doppelte Prompt-Bausteine entfernen, offene Branches aufraeumen.

Typische Stolpersteine in 60 Sekunden

Merge-Konflikt? Ihr habt dieselbe Stelle geaendert. Konfliktmarker entfernen, gewuenschte Zeilen behalten und neu committen.

git add .\ngit commit -m \"Konflikt in CLAUDE.md aufgeloest\"

Pfade funktionieren nur bei einer Person? Keine absoluten Pfade wie/Users/name/... verwenden, stattdessen relative Pfade oder$CLAUDE_PROJECT_DIR.

Secret versehentlich gepusht? Key sofort widerrufen und neu erzeugen, danach erst die Historie bereinigen.

Mini-Notfallplan: 1) Key beim Anbieter rotieren, 2) Team informieren, 3) Leak aus Historie entfernen, 4) betroffene Systeme kurz pruefen.