Claude workspace setup
Definitie
De ~/Claude/ map is de centrale hub voor samenwerking met alle Claude-interfaces: Claude Code, Claude Chat en Cowork. Identiteitsbestanden zijn eenmalig vastgelegd als single source of truth en worden door alle interfaces geladen. GitHub-integratie houdt de workspace gesynchroniseerd.
Context
De workspace is ingericht om verspreide context (ChatGPT-exports, Cowork-geheugen, handmatige notities) samen te brengen in een beheersbare structuur. Het principe: één plek schrijven, overal laden. Claude Code leest ~/.claude/CLAUDE.md automatisch bij elke sessie, wat de symlink-aanpak aantrekkelijk maakt.
Kernpunten
Mapstructuur ~/Claude/
De root bevat vijf submappen: me/ voor identiteitsbestanden, chat/ voor Chat-context en notities, cowork/ voor inbox/output/automatisering, projects/ voor actieve projectbacklogs, en resources/ voor gedeelde referentiematerialen.
me/ als single source of truth
Drie bestanden beschrijven de gebruiker als exportformaat voor alle Claude-tools: about-me.md (achtergrond, rol, doelen), voice.md (schrijfstijl, toonregels) en working-style.md (werkvoorkeuren, beslisritme). Wijzigingen in me/ propageren automatisch naar alle interfaces die ermee zijn geconfigureerd.
CLAUDE.md best practices
~/.claude/CLAUDE.md laadt globaal bij elke Claude Code-sessie. Houd het lean: max 1-2 pagina’s, alleen globale regels. Projectspecifieke instructies horen in een CLAUDE.md in de projectroot. Het symlink-patroon (~/Claude/CLAUDE.md symlinkt naar ~/.claude/CLAUDE.md) houdt de werkelijke inhoud in de versiebeheerde workspace terwijl Claude Code het verwachte pad blijft volgen.
Patronen die bloat veroorzaken (gevonden bij review op 2026-04-16):
- Workflow-details die al in een aparte guide staan — verwijs naar de guide, herhaal niet
- CLI-syntax (
--append-notes "...") — hoort in de guide, niet in rootinstructies - Verwijzingen naar bestanden die niet bestaan (dode links, verwijderde mappen)
- Secties die alleen relevant waren bij setup (installatie-instructies, prioriteitslijsten)
- Vage lessen zonder concrete toepassing voor CC (“grenzen trekken”)
Controle: doorloop het bestand en vraag per regel “voegt dit iets toe dat CC niet al weet uit de guide of uit het systeem?” Als nee: weggooien of delegeren naar de relevante guide.
Custom commands
Slash commands voor Claude Code worden opgeslagen als Markdown-bestanden in ~/.claude/commands/*.md. De bestandsnaam wordt de commandonaam. Dit is een apart ecosysteem van Cowork skills, zie wiki-cowork-plugin-structuur.
GitHub-integratie
Setup via Homebrew: brew install gh, daarna gh auth login met de device flow (browser-redirect naar github.com/login/device). De workspace is als private repo gepubliceerd op github.com/Jvdbreemen/claude-workspace. Verouderde symlinks in de workspace opruimen voor de eerste push voorkomt onnodige git-complexiteit.
Chat/Cowork/Code alignment
Alle drie de interfaces kunnen dezelfde me/-bestanden laden, maar doen dat via verschillende mechanismen: Claude Code via CLAUDE.md-inclusies, Chat via manueel plakken of memory-uploads, Cowork via skill-context. De inhoud is identiek, de interface verschilt.
Verbanden
-
Zie ook: wiki-cowork-plugin-structuur
-
Zie ook: wiki-claude-code-router — references
-
Zie ook: wiki-backlog-md-workflow — references
-
Zie ook: wiki-macos-python-pipx — references
-
Zie ook: wiki-anatomy-projectintelligentie — semantically_similar_to