Settings.json

O Claude lê os três settings em ordem, do mais genérico ao mais específico, e produz uma configuração efetiva única. Quem está em cima, manda.

{
  "model": "claude-sonnet-4-6",

  "permissions": {
    "allow": [
      "Bash(npm test:*)",
      "Bash(git status)",
      "Read(./src/**)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./secrets/**)",
      "Bash(rm -rf:*)"
    ],
    "ask": [
      "Bash(git push:*)",
      "WebFetch(domain:*)"
    ]
  },

  "hooks": {
    "PreToolUse": [
      { "matcher": "Bash", "hooks": [{ "type": "command", "command": "./scripts/audit.sh" }] }
    ],
    "PostToolUse": [
      { "matcher": "Edit", "hooks": [{ "type": "command", "command": "npm run lint" }] }
    ]
  },

  "env": {
    "ANTHROPIC_LOG_LEVEL": "info",
    "PROJECT_ENV": "dev"
  },

  "includeCoAuthoredBy": true,
  "cleanupPeriodDays": 30
}

Comandos triviais e repetitivos não precisam de confirmação a cada turno. Coloque tudo que é seguro no allow e libere o ritmo do agente.

{
  "permissions": {
    "allow": [
      "Bash(npm test:*)",
      "Bash(npm run lint)",
      "Bash(npm run build)",
      "Bash(git status)",
      "Bash(git diff:*)",
      "Bash(git log:*)",
      "Bash(git branch:*)",
      "Bash(ls:*)",
      "Bash(pwd)"
    ]
  }
}

Nada de "ah, ele não vai ler o .env". Bloqueie no painel e durma tranquilo. O agente nem cogita acessar.

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./**/*.pem)",
      "Read(./**/*credentials*)",
      "Bash(rm -rf:*)",
      "Bash(curl:*)",
      "Bash(sudo:*)"
    ]
  }
}

Toda vez que você manda um prompt, um script registra. Útil para compliance, retroativa de erros, ou para entender quanto tempo gasta em cada tipo de tarefa.

{
  "hooks": {
    "UserPromptSubmit": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "./scripts/audit-prompt.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash
# Le o prompt do stdin (JSON do Claude)
PROMPT=$(jq -r .prompt)
DATE=$(date --iso-8601=seconds)
echo "$DATE | $USER | $PROMPT" \
  >> .claude/audit.log

Quando algo não funciona, você precisa de log. Ative o nível debug no settings.local.json e o Claude passa a contar tudo que faz, sem você lembrar de exportar variável.

{
  "env": {
    "ANTHROPIC_LOG_LEVEL": "debug",
    "CLAUDE_TRACE": "1",
    "DEBUG": "claude:*"
  }
}

A linha de status é o painel embaixo do prompt. Por padrão mostra modelo e diretório. Com statusLine ela passa a mostrar branch, status do Git e qualquer coisa que você quiser.

{
  "statusLine": {
    "type": "command",
    "command": "./scripts/statusline.sh"
  }
}

#!/bin/bash
BRANCH=$(git branch --show-current)
DIRTY=$(git status --porcelain | wc -l)
MODEL=$(jq -r .model)

echo "⎇  $BRANCH" \
     "·" \
     "$DIRTY arquivos sujos" \
     "·" \
     "$MODEL"