Understand configuration directories in Claude Code

Claude Code uses hidden .claude directories to manage its configuration, conversation history, and custom tools. These directories let you customize Claude Code's behavior and share project-specific settings with your team.

There are two types of .claude directories: one in your home directory for global settings, and optional ones in project directories for project-specific configuration.

The global directory (~/.claude)

Your home directory contains a .claude folder that stores system-wide settings and state. This is where Cla...