Claude CodeBasicClaude Code
Team rules in settings.json, your own experiments in .local
What has to hold for the whole team goes in .claude/settings.json (in git); what only works on your machine goes in settings.local.json.
settings.json is committed: allow/deny, hooks and approved MCP servers. settings.local.json stays out of git (Claude Code ignores it when it creates it) for personal overrides, paths on your machine or experimental config. Never put credentials in the shared file. Add the $schema line to get autocomplete and validation in VS Code and Cursor.
Example
// .claude/settings.json
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"permissions": {
"allow": ["Bash(npm run lint)", "Bash(npm run test *)"],
"deny": ["Bash(curl *)", "Read(./.env)", "Read(./secrets/**)"]
}
}