# Référence de configuration

Retrouvez les champs de facade.json, leurs valeurs par défaut et la façon dont Facade les applique.

## Champs de premier niveau

Ouvrez le fichier via [Paramètres des agents](https://facadecode.com/fr/docs/settings/). Il accepte les commentaires JSON et les virgules finales. Un objet vide applique les valeurs par défaut.

| Champ | Valeur | Valeur par défaut |
| --- | --- | --- |
| `yolo` | Booléen qui contrôle les approbations de la CLI et l’accès des agents. | `true` |
| `names` | Liste de noms d’agents suggérés, sans chaîne vide. | Liste de noms intégrée |
| `clis` | Objet contenant les substitutions des CLI intégrées et des entrées nommées supplémentaires. | `{}` ; les CLI intégrées restent disponibles |
| `$schema` | Chaîne destinée aux métadonnées de schéma de l’éditeur. | Omis |

## Champs d’une entrée CLI

| Champ | Valeur | Valeur par défaut |
| --- | --- | --- |
| `type` | `claude`, `codex`, `agy`, `muse`, `opencode`, `pi` ou `custom`. | Implicite pour les identifiants intégrés exacts ; obligatoire pour les entrées ajoutées. |
| `command` | Un seul nom ou chemin d’exécutable. | La commande du type, cherchée dans le PATH ; obligatoire pour custom. |
| `args` | Tableau de chaînes d’arguments transmises littéralement. | `[]` |
| `env` | Noms de variables associés à des chaînes ou à null. | `{}` |
| `model` | Identifiant de modèle non vide. | La CLI décide. Non accepté pour OpenCode ni custom. |
| `effort` | Niveau d’effort non vide, pris en charge par la CLI et le modèle. | La CLI décide. Non accepté pour OpenCode ni custom. |
| `enabled` | Booléen qui contrôle les démarrages à venir et la restauration. | `true` |
| `icon` | Identifiant de CLI intégré ou icône de robot prise en charge. | Icône du type ; `facade-pearl` pour custom. |

Utilisez l’identifiant exact, en minuscules, pour configurer une entrée intégrée, comme `codex`. Une nouvelle entrée doit porter un nom différent de tous les identifiants et noms d’affichage intégrés, même sans tenir compte des majuscules. Utilisez par exemple `Codex · work` plutôt que `Codex`. Les entrées ajoutées n’héritent pas des paramètres de l’entrée intégrée de leur type.

`enabled: false` masque une entrée valide et refuse les démarrages à venir ainsi que la restauration. L’option n’arrête pas un agent déjà en cours.

## Valeurs d’environnement

```json
{
  "clis": {
    "codex": {
      "env": {
        "WORK_API_KEY": "${env:WORK_API_KEY}",
        "OLD_TOKEN": null
      }
    }
  }
}
```

- Une chaîne définit une variable. `null` la supprime. Une variable absente est héritée.
- `${env:NAME}` lit l’environnement de l’hôte de l’éditeur. La référence ne lit pas une autre clé du même objet.
- Une référence manquante rend cette entrée indisponible. Les références sont développées une seule fois dans les valeurs de `env`, pas dans `args`.
- Une valeur littérale reste dans facade.json. Une référence d’environnement garde la valeur hors du fichier, mais la CLI reçoit tout de même la valeur développée.

Définir une variable dans un terminal intégré déjà ouvert ne met pas à jour l’environnement de l’hôte de l’éditeur. Rendez-la disponible avant de démarrer l’éditeur.

## Ordre de priorité et options de lancement

Facade utilise d’abord le modèle et l’effort indiqués pour le nouvel agent, puis les valeurs par défaut de l’entrée. Pour chaque champ, si aucune valeur n’est fournie à ces deux niveaux, la CLI décide. OpenCode conserve ces deux choix dans sa propre configuration.

Pour les types intégrés, utilisez les champs dédiés au modèle et à l’effort. Facade définit aussi les permissions, les identifiants de conversation, les dossiers de travail et ses propres outils. Il refuse les arguments qui entrent en conflit avec ces choix ou qui empêchent une session interactive de démarrer.

Facade cherche facade.json dans le dossier Facade : le paramètre VS Code **Facade: Home** s’il est défini, puis `FACADE_HOME`, puis `~/.facade`. Ouvrez **Open Settings** depuis le projet pour trouver son fichier actif.

## Erreurs de fichier et erreurs d’entrée

Une erreur au niveau du fichier, comme un JSON invalide, une clé en double ou un champ de premier niveau inconnu, bloque les nouveaux démarrages et la restauration. Une erreur dans une entrée CLI ne rend indisponible que cette entrée. Les agents en cours continuent de tourner.

Suivez le chemin de paramètre indiqué par l’erreur et corrigez la valeur concernée. Facade ne réutilise pas silencieusement d’anciens paramètres. Voir [Dépannage](https://facadecode.com/fr/docs/troubleshooting/) pour les erreurs courantes de démarrage et de fournisseur.