Claude Code settings.json

Claude Code user settings live in ~/.claude/settings.json.

Use this file for durable preferences such as notifications, cleanup retention, attribution, spinner tips, and environment variables.

Example

{
  "agentPushNotifEnabled": true,
  "inputNeededNotifEnabled": true,
  "cleanupPeriodDays": 365,
  "spinnerTipsEnabled": false,
  "attribution": {
    "commit": "",
    "pr": ""
  },
  "env": {
    "CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY": "1",
    "DISABLE_TELEMETRY": "1",
    "DISABLE_ERROR_REPORTING": "1",
    "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1",
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "75"
  }
}

Practical guidance

• Keep project-specific instructions in CLAUDE.md.
• Keep user-level preferences in ~/.claude/settings.json.
• Deny secrets such as .env files through permissions rather than relying on prompts.