Skip to content

Instantly share code, notes, and snippets.

@freeformz
Created March 7, 2026 01:16
Show Gist options
  • Select an option

  • Save freeformz/4543b9a4a3af3b004d3f8c844e716511 to your computer and use it in GitHub Desktop.

Select an option

Save freeformz/4543b9a4a3af3b004d3f8c844e716511 to your computer and use it in GitHub Desktop.
~/.claude/rules/config-locations.md
$ cat ~/.claude/rules/config-locations.md
## Claude Code Configuration Locations
| Feature | User scope | Project scope | Local scope |
|---------|-----------|--------------|-------------|
| Settings | `~/.claude/settings.json` | `.claude/settings.json` | `.claude/settings.local.json` |
| Rules | `~/.claude/rules/*.md` | `.claude/rules/*.md` | — |
| Subagents | `~/.claude/agents/` | `.claude/agents/` | — |
| MCP servers | `~/.claude.json` | `.mcp.json` | `~/.claude.json` (per-project) |
| Plugins | `~/.claude/settings.json` | `.claude/settings.json` | `.claude/settings.local.json` |
| CLAUDE.md | `~/.claude/CLAUDE.md` | `CLAUDE.md` or `.claude/CLAUDE.md` | `CLAUDE.local.md` |
| Auto memory | — | `~/.claude/projects/<project>/memory/` | — |
| Managed policy | macOS: `/Library/Application Support/ClaudeCode/CLAUDE.md` | — | — |
Key behaviors:
- Project rules can use `paths` frontmatter to scope to specific file patterns
- Rules without `paths` load unconditionally at launch
- User-level rules load before project rules (project rules take priority)
- Auto memory lives at `~/.claude/projects/<project>/memory/MEMORY.md` (first 200 lines loaded)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment