Configuration templates and references for Claude Code setup.
| File | Purpose | Usage |
|---|---|---|
settings.json.reference |
Example permissions and settings | Reference only — contains hardcoded paths. Review for patterns to copy. |
settings.local.json.template |
Machine-specific permissions | Copy to ~/.claude/settings.local.json and customize |
.mcp.json.template |
MCP server configuration | Copy to project root as .mcp.json and add your servers |
Don't copy settings.json.reference directly. It contains:
- Hardcoded paths specific to the original author
- Plugin preferences you may not want
- Permissions you haven't earned yet
Instead, let your permissions build organically:
- Use Claude Code normally
- Accept or deny permissions as they come up
- Your
~/.claude/settings.jsonaccumulates what you actually use
Open settings.json.reference and copy individual patterns you want:
# View the reference
cat templates/settings.json.reference
# Then add specific patterns to your settings.json, like:
# "Bash(git add:*)"
# "Bash(pnpm:*)"settings.local.json.template is for permissions that differ per machine:
{
"permissions": {
"allow": [
"Bash(./your-local-script.sh)"
]
}
}Copy to ~/.claude/settings.local.json and customize for each machine.