Learn how Claude Code organizes its configuration files and folders, both at the project level and at the system level. This lesson walks through the .claude folder structure, what each piece is for, and how project-level and system-level settings relate to each other.
Starting with the /init command to generate a claude.md file for an existing codebase, you'll see how the .claude folder houses your settings.json, custom commands, skills, and subagent configurations. Understanding the difference between project-level and system-level folders is key — anything placed in your home directory's .claude folder becomes available across all your projects.
/init command to generate a claude.md orientation file for your project.claude folder structure: where settings, commands, skills, and agents livesettings.json is for: hooks, MCP servers, granular permissions, and other configurationcommands, skills, and agents subfolders and what each one holds.claude folders and how they differCreated by Brian Casel (that's me) — multi-time founder, product designer, teacher, and the creator behind Builder Methods.