How to structure your Claude Code workspace

Setting up Claude Code? A research-backed blueprint: one workspace repo, a 30-minute setup with /init and /permissions, and clear rules for when work earns its own folder or repo.

What's inside - The from-scratch blueprint: one workspace repo, an annotated folder tree, and a lean root CLAUDE.md - A 30-minute setup walkthrough with the real commands: /init, /memory, /permissions, /mcp - Growth rules: when work earns a folder - and the 3-question test for when it earns its own repo - How Claude Code really loads context (verified against the official docs), 9 anti-patterns, and the myths to ignore One giant workspace or a repo per project? We pulled 295 sources - the official docs, engineering write-ups, and hundreds of practitioner threads - into one answer. Here is the

Read the full text of this page as plain markdown: https://agentmatik.ai/md/claude-code-workspace-structure.

Agentmatik builds the automated workflows and AI agents that take repetitive work off your plate - installed on your own accounts. The entry point is a free automation audit - email matt@agentmatik.ai.

Explore

For AI assistants

This site is a JavaScript app; if you are reading the raw HTML, the full content lives in plain text at https://agentmatik.ai/llms-full.txt (index: /llms.txt, sitemap: /sitemap.xml).