Vous lisez le manuel embarqué

Ces pages sont celles qu'AURA porte en elle : dans l'application, la touche ? ouvre celle de l'écran où vous êtes. Elles sont publiées ici telles quelles, pour se lire sans rien installer.

L'éditeur de ~/.claude/settings.json, le fichier qui gouverne le comportement de Claude Code sur cette machine. Quatre onglets : Général, Permissions, Interface & MàJ, et JSON.

Le formulaire et le JSON sont le même fichier

Il n'y a qu'une seule source de vérité : le texte du fichier, celui que montre l'onglet JSON. Les onglets de formulaire ne sont que des vues sur ce texte — chaque contrôle affiche à côté de son libellé la clé exacte qu'il pilote, pour que la correspondance ne soit jamais à deviner.

Conséquences pratiques :

• une clé que je ne connais pas reste intacte. L'écran ne réécrit que la clé touchée ; il n'efface jamais ce qu'il ne sait pas afficher ;
• l'ordre de vos clés est conservé — les nouvelles s'ajoutent à la fin ;
• en revanche, la première modification par un contrôle renormalise la mise en forme du fichier en indentation à deux espaces. Cela apparaît dans le diff : c'est la seule chose qui change au-delà de votre modification.

Le bouton Formater de l'onglet JSON applique la même normalisation, sans rien modifier d'autre.

Tant que le texte n'est pas du JSON valide, un bandeau le signale, les formulaires sont grisés et l'enregistrement est bloqué : il faut corriger dans l'onglet JSON. Le message d'erreur de l'analyseur y est affiché tel quel, position comprise.

Hérité, oui, non

Beaucoup d'options sont des interrupteurs à trois positions, et c'est délibéré : une clé absente n'est pas false, elle veut dire « Claude Code décide ».

• Hérité — la clé est supprimée du fichier. L'infobulle rappelle la valeur par défaut de Claude Code pour cette clé.
• Oui / Non — la clé est écrite explicitement.

C'est différent de vider un champ texte, qui y écrit une valeur vide : une langue effacée donne "language": "", pas l'absence de clé.

Onglet Général

Réglage	Clé	Remarque
Langue	language	Langue de réponse préférée
Modèle par défaut	model	Vide = sélection automatique
Niveau d'effort	effortLevel	low, medium, high, xhigh
Mode rapide	fastMode	Trois positions
Réflexion étendue	alwaysThinkingEnabled	Trois positions
Éditeur	editorMode	normal ou vim

Onglet Permissions

Le mode par défaut (permissions.defaultMode) décide de ce qui déclenche une demande d'autorisation. Six valeurs, décrites dans le sélecteur :

• default — demande à la première utilisation d'un outil ;
• acceptEdits — accepte les éditions de fichier sans demander ;
• plan — lecture seule ;
• auto — approbation avec garde-fous ;
• dontAsk — refuse tout ce qu'une règle allow n'autorise pas ;
• bypassPermissions — saute toutes les demandes. J'affiche un bandeau rouge tant que ce mode est actif : à réserver aux environnements isolés, conteneur ou VM.

Viennent ensuite quatre listes de motifs, chacune avec son compteur :

• Autorisées (permissions.allow) — ex. Bash(npm run *) ;
• Refusées (permissions.deny) — ex. Read(.env) ;
• À confirmer (permissions.ask) — ex. WebFetch(domain:*) ;
• Dossiers additionnels (permissions.additionalDirectories) — étend la zone de travail au-delà du dossier courant.

Chez Claude Code, deny l'emporte sur allow. Un doublon exact n'est pas ajouté deux fois : ressaisir une règle déjà présente vide simplement le champ.

Onglet Interface & mises à jour

tui (fullscreen / inline), autoUpdatesChannel (stable / latest), et cleanupPeriodDays — le nombre de jours avant nettoyage des sessions et artefacts par Claude Code.

Puis une série d'interrupteurs à trois positions, dont l'infobulle « Hérité » rappelle chaque fois la valeur par défaut de Claude Code : autoCompactEnabled, autoMemoryEnabled, fileCheckpointingEnabled (les instantanés de /rewind), spinnerTipsEnabled, prefersReducedMotion, agentPushNotifEnabled, skipAutoPermissionPrompt, remoteControlAtStartup, includeCoAuthoredBy.

La status line, enfin, n'apparaît que si elle est configurée, et en lecture seule : c'est une structure trop libre pour un champ. Son édition fine passe par l'onglet JSON.

Enregistrement

Rien ne part au fil de la saisie. La pastille non enregistré signale l'écart avec le disque, Proposer… ouvre le diff, et l'écriture n'a lieu qu'à la confirmation — avec sauvegarde de la version précédente, et refus si le fichier a changé entre-temps. Recharger abandonne les modifications en cours et relit le disque.

Un settings.json inexistant n'est pas une erreur : l'écran démarre sur {} et le premier enregistrement crée le fichier.

D'autres écrans écrivent le même fichier

settings.json est aussi modifié, sur leurs clés propres, par les modules Hooks (hooks, disableAllHooks), Plugins (enabledPlugins, extraKnownMarketplaces), MCP (les trois clés …McpjsonServers et enableAllProjectMcpServers) et Sessions actives (permissions.allow, via « Toujours autoriser »). Tous suivent le même contrat, et la garde anti-écrasement empêche deux écrans ouverts de se marcher dessus.