Claude Projects, Cowork und Claude Code verbinden

Claude hat derzeit mehrere projektartige Oberflächen:

Claude Chat / Claude.ai Projects für persistente Gesprächsarbeit, hochgeladenes Wissen und Projekt-Instructions.
Claude Cowork für Nicht-Coding-Arbeit, die auf ausgewählten lokalen Ordnern, Connectors und Desktop-Apps arbeiten kann.
Claude Code für Softwareentwicklung im Terminal, in IDEs, im Desktop-Code-Tab oder in Cloud-Sessions.

Sie hängen zusammen, lesen aber nicht alle dieselbe gemeinsame "Claude-Projekt"-Datenbank. Das robusteste Setup ist ein Project Hub in deinem Repository oder Arbeitsordner, den jede Claude-Oberfläche auf die jeweils unterstützte Weise nutzt.

Der zentrale Unterschied

Behandle ~/.claude/projects/ nicht als deinen kanonischen Projektspeicher.

Claude Code nutzt ~/.claude/ für persönliche Konfiguration und Anwendungsdaten. Die Projekteinträge können lokale Transkripte, Prompt-Historie, Datei-Snapshots und automatische Memories enthalten, zum Beispiel:

~/.claude/projects/<project>/
├── <session>.jsonl
└── memory/
    ├── MEMORY.md
    ├── debugging.md
    └── ...

Diese Daten sind für Claude Code nützlich, aber sie sind maschinenlokaler App-Zustand. Sie sind nicht dasselbe wie ein Claude.ai Project und nicht der beste Ort, um geteiltes Projektwissen zu pflegen.

Nutze diese Regel:

Art der Information	Bester Ort
Teamweite Repo-Instructions	`AGENTS.md`, `CLAUDE.md`, `.claude/CLAUDE.md`, `.claude/rules/`
Persönliche Präferenzen über alle Repos	`~/.claude/CLAUDE.md`, `~/.claude/rules/`
Persönliche Präferenzen für ein Repo	`CLAUDE.local.md`, `.claude/settings.local.json`
Automatisch gelernte Claude-Code-Notizen	`~/.claude/projects/<project>/memory/`
Claude.ai Project Instructions	Project Instructions in Claude.ai
Claude.ai Project Knowledge Files	Hochgeladene oder angehängte Dateien im Project
Cowork-Arbeitsdateien	Ein ausgewählter lokaler Ordner, den du explizit freigibst

Empfohlene Architektur

Erstelle einen Ordner oder ein Repository, das als Source of Truth für das Projekt dient.

my-project/
├── AGENTS.md
├── CLAUDE.md
├── CLAUDE.local.md              # gitignored
├── .claude/
│   ├── CLAUDE.md
│   ├── rules/
│   │   ├── architecture.md
│   │   ├── coding-style.md
│   │   └── testing.md
│   ├── skills/
│   └── settings.local.json      # gitignored
├── .ai-context/
│   ├── project-brief.md
│   ├── glossary.md
│   ├── decisions.md
│   └── handoff.md
└── docs/

Der Ordner .ai-context/ ist optional, aber er ist die sauberste Brücke zwischen Chat, Cowork und Code:

Lade diese Dateien in ein Claude.ai Project als Project Knowledge hoch.
Zeige Cowork auf denselben Ordner, wenn du Nicht-Code-Arbeit erledigst.
Importiere diese Dateien aus CLAUDE.md oder .claude/rules/ für Claude Code.
Committe die dauerhaften Teile in Git, damit jede Oberfläche mit denselben Fakten startet.

Schritt 1: Gemeinsamen Project Brief erstellen

Erstelle ein kompaktes Kontextpaket:

.ai-context/
├── project-brief.md
├── glossary.md
├── decisions.md
└── handoff.md

Nutze diese Dateien für Informationen, die über Oberflächen hinweg Bestand haben sollen:

Produktziel und aktuelle Prioritäten
Repository-Struktur und Ownership-Grenzen
Architekturentscheidungen
Domänenvokabular
Externe Systeme, Connectors und Credential-Policy
Aktuelle Handoff-Notizen

Halte dieses Paket kurz. Lege lebende Implementierungsdetails ins Repo. Lege Task-Historie in Issues, PRs oder handoff.md ab, nicht in einen riesigen Prompt.

Schritt 2: Claude Code mit demselben Kontext verbinden

Füge im Repo-Root eine CLAUDE.md hinzu, die gemeinsame Instructions importiert:

@AGENTS.md
@.ai-context/project-brief.md
@.ai-context/glossary.md

## Claude Code

- Use the commands and validation steps documented in this repository.
- Treat `.ai-context/decisions.md` as the durable decision log.
- Ask before changing public API contracts, database migrations, or deployment configuration.

Claude Code liest CLAUDE.md, nicht AGENTS.md. Der Import von AGENTS.md verhindert doppelte Instructions für mehrere Coding Agents.

Für größere Repos kannst du bedingte Regeln nach .claude/rules/ verschieben:

.claude/rules/
├── frontend.md
├── backend.md
├── testing.md
└── security.md

Nutze pfadbezogene Regeln, wenn eine Regel nur für einen Teil des Baums gelten soll:

---
paths:
  - "src/api/**/*.ts"
  - "app/Http/**/*.php"
---

# API Rules

- Validate inputs at the boundary.
- Keep response formats backward compatible unless the task explicitly changes the API contract.

Starte Claude Code aus dem Projekt-Root:

cd ~/work/my-project
claude

Nutze innerhalb von Claude Code /memory, um zu prüfen, welche Instruction-Dateien geladen wurden, und um den Auto-Memory-Ordner zu öffnen.

Schritt 3: Claude.ai Projects verbinden

Erstelle oder öffne in Claude.ai ein Project für dieselbe Domäne.

Nutze die Project Instructions für das stabile Verhalten, das in jedem Chat gelten soll:

You are helping with the my-project codebase and product documentation.
Use the uploaded project brief, glossary, decisions, and handoff files as the source of truth.
When a request affects code, recommend using Claude Code in the repository instead of inventing changes from memory.
When facts are missing, ask for the current repo file or issue link.

Füge dann Project Knowledge hinzu:

.ai-context/project-brief.md
.ai-context/glossary.md
.ai-context/decisions.md
.ai-context/handoff.md
Architekturdocs oder öffentliche Spezifikationen, die sicher hochgeladen werden dürfen

Damit bekommt Claude Chat eine parallele Sicht auf denselben Kontext, den Claude Code lokal liest.

Wichtige Einschränkung: Claude.ai Project Knowledge wird nicht automatisch aus deinem Dateisystem synchronisiert. Wenn sich eine Kontextdatei ändert, aktualisiere das hochgeladene Project Knowledge oder füge den geänderten Abschnitt ins Project ein.

Schritt 4: Cowork verbinden

Nutze Cowork, wenn die Aufgabe nicht primär eine Coding-Aufgabe ist:

Ordner organisieren
Reports vorbereiten
Notizen zusammenfassen
Tabellen, Decks und Dokumente erstellen
Wiederkehrende Knowledge-Work-Aufgaben ausführen

Wähle in der Desktop-App den Cowork-Tab und gib nur den relevanten Arbeitsordner frei. Für Projektarbeit sollte das normalerweise entweder dieser Ordner sein:

~/work/my-project/.ai-context/

oder ein dedizierter Nicht-Code-Workspace:

~/work/my-project/workspace/

Nutze einen Prompt, der Cowork auf dieselbe Source of Truth ausrichtet:

Use the files in this working folder as the current project context.
Read project-brief.md, glossary.md, decisions.md, and handoff.md first.
Before editing files, show me the plan and wait for approval.
If a change belongs in source code, stop and tell me to continue in Claude Code.

Halte Cowork von breitem Home-Directory-Zugriff fern. Es kann reale Aktionen an lokalen Dateien und verbundenen Tools ausführen, daher sind enge Ordner und explizite Freigabe wichtig.

Schritt 5: Zwischen Code, Web und Desktop wechseln

Claude Code hat mehrere Wege, Oberflächen zu verbinden:

Richtung	Beste Option
Lokales Terminal zu Browser/Mobile, während es lokal weiterläuft	Remote Control
Lokales Repo zu Claude-Code-Cloud-Session	`claude --remote "task"`
Cloud-Session zurück ins Terminal	`claude --teleport`
Desktop-Code-Tab zur CLI	In CLI öffnen / dasselbe Repo
Chat oder Cowork zu Code	Handoff in `.ai-context/handoff.md` legen, dann Claude Code starten

Für lokale Remote Control:

cd ~/work/my-project
claude --remote-control "my-project"

Das hält die Session auf deinem Rechner, während Browser oder Mobile-App als Remote-Fenster darauf zugreifen.

Für Cloud-Ausführung:

cd ~/work/my-project
claude --remote "Implement the plan in .ai-context/handoff.md"

Für die Rückkehr aus einer Web-/Cloud-Session:

cd ~/work/my-project
claude --teleport

Was verlinken und was nicht

Nutze Symlinks für selbst gepflegte Konfiguration, wenn das hilft:

ln -s ../shared-claude-rules .claude/rules/shared
ln -s AGENTS.md CLAUDE.md

Bevorzuge Imports, wenn du Claude-spezifische Ergänzungen brauchst:

@AGENTS.md

## Claude Code

- Use plan mode before editing deployment scripts.

Verlinke nicht den gesamten ~/.claude/projects/-Baum in ein Repo. Dieses Verzeichnis enthält lokalen App-Zustand und Transkripte. Es kann sensible Inhalte, Command-Output, Prompt-Historie und temporären Zustand enthalten. Halte es lokal, inspiziere es bei Bedarf mit /memory und bereinige es mit Claude Codes Projekt-Cleanup-Kommando.

Praktischer Daily Workflow

Starte in einem Claude.ai Project für Strategie, Schreiben, Recherche und breite Diskussion.
Speichere dauerhafte Entscheidungen in .ai-context/decisions.md.
Speichere ausführbare Handoffs in .ai-context/handoff.md.
Öffne Claude Code im Repo und führe die Coding-Arbeit aus dem Handoff aus.
Nutze Remote Control, wenn du dieselbe lokale Code-Session aus Browser oder Mobile fortsetzen willst.
Nutze Cowork für Nicht-Code-Deliverables und zeige auf einen engen Ordner.
Synchronisiere aktualisierte .ai-context/-Dateien zurück ins Claude.ai Project Knowledge, wenn sie sich ändern.

Minimale Setup-Checkliste

.ai-context/project-brief.md, glossary.md, decisions.md und handoff.md erstellen.
Eine Repo-CLAUDE.md hinzufügen, die AGENTS.md und die gemeinsamen Kontextdateien importiert.
.claude/rules/ für detaillierte Projektregeln hinzufügen.
CLAUDE.local.md und .claude/settings.local.json in .gitignore aufnehmen.
Ein Claude.ai Project erstellen und die .ai-context/-Dateien als Knowledge hochladen.
In Cowork nur den Projektkontext- oder Workspace-Ordner freigeben.
In Claude Code mit /memory prüfen, was geladen wurde.
claude --remote-control, claude --remote und claude --teleport für Cross-Surface-Handoffs nutzen.

Der zentrale Unterschied​

Empfohlene Architektur​

Schritt 1: Gemeinsamen Project Brief erstellen​

Schritt 2: Claude Code mit demselben Kontext verbinden​

Schritt 3: Claude.ai Projects verbinden​

Schritt 4: Cowork verbinden​

Schritt 5: Zwischen Code, Web und Desktop wechseln​

Was verlinken und was nicht​

Praktischer Daily Workflow​

Minimale Setup-Checkliste​

Referenzen​