← La plage Cabane technique

Le settings.json

La configuration de Claude Code qui roule sans vous : permissions, modele, effort, plugins. Prete a copier-coller dans ~/.claude/settings.json, avec un prompt d'instruction a coller dans vos consignes. (Les hooks personnels sont volontairement retires.)

Le fichier settings.json

A deposer dans ~/.claude/settings.json (reglages globaux) ou dans .claude/settings.json a la racine d'un projet. Contenu identique a celui fourni, seul le bloc hooks (personnel) a ete retire.

~/.claude/settings.json
{
  "permissions": {
    "allow": [
      "Bash(*)",
      "Read(*)",
      "Write(*)",
      "Edit(*)",
      "Glob(*)",
      "Grep(*)",
      "WebFetch(*)",
      "WebSearch(*)",
      "Skill(deep-research)"
    ],
    "deny": [
      "Bash(sendmail:*)",
      "Bash(mail:*)",
      "Bash(mutt:*)",
      "Bash(curl*smtp*)"
    ]
  },
  "model": "claude-fable-5[1m]",
  "cleanupPeriodDays": 3650,
  "enabledPlugins": {
    "frontend-design@claude-plugins-official": false,
    "superpowers@claude-plugins-official": true,
    "context7@claude-plugins-official": true,
    "serena@claude-plugins-official": false,
    "claude-md-management@claude-plugins-official": true,
    "greptile@claude-plugins-official": false,
    "huggingface-skills@claude-plugins-official": true,
    "circleback@claude-plugins-official": false
  },
  "language": "Francais",
  "effortLevel": "high",
  "tui": "default",
  "voice": {
    "enabled": false,
    "mode": "hold"
  },
  "skipWorkflowUsageWarning": true,
  "theme": "light-ansi",
  "verbose": true,
  "autoCompactEnabled": false,
  "voiceEnabled": false
}

A coller dans vos instructions

Ce prompt est autonome : il embarque la configuration ci-dessus et la regle de securite. Collez-le tel quel dans votre page d'instructions (par exemple CLAUDE.md) ou directement a Claude.

prompt a coller
Installe la configuration settings.json de maniere globale (fichier ~/.claude/settings.json, en conservant mes hooks existants) :

{
  "permissions": {
    "allow": [
      "Bash(*)",
      "Read(*)",
      "Write(*)",
      "Edit(*)",
      "Glob(*)",
      "Grep(*)",
      "WebFetch(*)",
      "WebSearch(*)",
      "Skill(deep-research)"
    ],
    "deny": [
      "Bash(sendmail:*)",
      "Bash(mail:*)",
      "Bash(mutt:*)",
      "Bash(curl*smtp*)"
    ]
  },
  "model": "claude-fable-5[1m]",
  "cleanupPeriodDays": 3650,
  "enabledPlugins": {
    "frontend-design@claude-plugins-official": false,
    "superpowers@claude-plugins-official": true,
    "context7@claude-plugins-official": true,
    "serena@claude-plugins-official": false,
    "claude-md-management@claude-plugins-official": true,
    "greptile@claude-plugins-official": false,
    "huggingface-skills@claude-plugins-official": true,
    "circleback@claude-plugins-official": false
  },
  "language": "Francais",
  "effortLevel": "high",
  "tui": "default",
  "voice": {
    "enabled": false,
    "mode": "hold"
  },
  "skipWorkflowUsageWarning": true,
  "theme": "light-ansi",
  "verbose": true,
  "autoCompactEnabled": false,
  "voiceEnabled": false
}

Le plugin superpowers etant active, ces skills se chargent a la volee des qu'elles sont utiles (seule leur courte description reste en contexte avant) - pense a t'en servir : brainstorming (cadrer une idee avant de coder), systematic-debugging (le debogage methodique, le "super debugging"), test-driven-development (les tests d'abord), verification-before-completion (verifier avant d'annoncer que c'est termine), writing-plans (planifier les taches complexes) et requesting-code-review (revue de code), plus deep-research pour la recherche approfondie multi-sources.

Regle permanente et prioritaire : avant TOUT /compact, fais d'abord un /export de la conversation vers un fichier, pour conserver l'historique complet et detaille. Ne lance jamais un /compact sans avoir exporte au prealable.
Pourquoi cette regle : /compact resume la conversation et remplace l'historique detaille en contexte, ce qui est irreversible. On fait donc toujours un /export vers un fichier avant tout /compact, pour garder une copie complete. C'est exactement ce que le prompt ci-dessus impose.

Ce que chaque reglage fait

Le tour du proprietaire, cle par cle.

permissions.allow Liste blanche d'outils autorises sans redemander. Syntaxe Outil(motif), le * = tout. Ici Bash, Read, Write, Edit, Glob, Grep, WebFetch, WebSearch sont grands ouverts, plus la skill deep-research.
permissions.deny Liste noire, evaluee en premier : elle l'emporte sur n'importe quel allow, a tous les niveaux de reglages. Ici elle coupe les envois de courriel courants (sendmail, mail, mutt, curl/python vers SMTP).
model Modele Claude par defaut. claude-fable-5[1m] = Fable 5 avec la fenetre de contexte etendue a 1 million de tokens (le suffixe [1m]).
cleanupPeriodDays Ajoute le 2026-08-03 Retention des transcriptions de sessions, en jours. Par defaut environ 30 jours : au-dela, Claude Code EFFACE les vieilles discussions et elles deviennent introuvables au /resume. 3650 = on garde tout 10 ans. Lecon apprise en cherchant une discussion d'avril, purgee en mai avant d'avoir pu la relire.
effortLevel Niveau d'effort de raisonnement, persiste entre les sessions. high = raisonnement pousse et equilibre. Dans le fichier : low, medium, high, xhigh. (max et ultracode existent mais seulement en session, via /effort.)
enabledPlugins Active/desactive les plugins par nom@marketplace. Ici superpowers, context7, claude-md-management et huggingface-skills sont actifs ; frontend-design, serena, greptile, circleback sont eteints.
language Langue de reponse preferee de Claude (preference forte, pas un verrou). Francais = Claude repond et commente en francais ; l'interface du CLI, elle, reste en anglais.
tui Mode de rendu de l'interface terminal. default = rendu classique dans le flux du terminal ; fullscreen = plein ecran sur l'ecran alternatif.
voice Saisie vocale : enabled:false = desactivee ; mode:hold = maintenir la touche pour parler (push-to-talk).
theme Theme de couleurs de l'interface. light-ansi = theme clair base sur les couleurs ANSI du terminal. Sur un terminal a fond noir (console de Dolphin par exemple), preferer dark-ansi ; pour un seul lancement sans toucher au reglage global : claude --settings '{"theme":"dark-ansi"}'.
verbose true = affichage detaille : montre les commandes completes et les sorties longues au lieu de les tronquer.
autoCompactEnabled false = desactive la compaction automatique du contexte. Combine a la regle "export avant compact", rien n'est resume sans qu'on l'ait voulu et exporte.
voiceEnabled Second interrupteur de la voix, ici false. Avec voice.enabled aussi a false, la voix est totalement coupee.
skipWorkflowUsageWarning Vise a masquer l'avertissement de consommation avant un gros workflow multi-agents. Cle non documentee officiellement, a confirmer selon la version.