> ## Documentation Index
> Fetch the complete documentation index at: https://kiro.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Paramètres

> Configurez le comportement de Kiro CLI grâce aux paramètres

Kiro CLI offre une personnalisation approfondie grâce aux paramètres. Vous pouvez configurer tout, de la télémétrie au comportement du clavardage, en passant par les raccourcis clavier et les bascules de fonctionnalités.

## Accéder aux paramètres

Gérez les paramètres directement depuis la ligne de commande. Les paramètres enregistrés dans les menus interactifs `/settings` sont également accessibles avec `kiro-cli settings`; les deux interfaces utilisent les paramètres CLI stockés dans `~/.kiro/settings/cli.json`.

```bash
# List all configured settings
kiro-cli settings list

# List all available settings with descriptions
kiro-cli settings list --all

# View a specific setting
kiro-cli settings telemetry.enabled

# Set a setting
kiro-cli settings telemetry.enabled true

# Delete a setting
kiro-cli settings --delete chat.defaultModel

# Open settings file in editor
kiro-cli settings open
```

### Portées des paramètres

Sans indicateur de portée, `kiro-cli settings` écrit ou supprime les paramètres globaux dans `~/.kiro/settings/cli.json`. Passez `--workspace` pour stocker plutôt une valeur pour le projet en cours :

```bash
# Set a global default
kiro-cli settings --global chat.defaultAgent default

# Override it in the current workspace
kiro-cli settings --workspace chat.defaultAgent my-project-agent
```

Lorsque les deux portées définissent un paramètre remplaçable par espace de travail, la valeur de l'espace de travail a priorité dans les sessions de l'interface utilisateur du terminal de ce projet. Supprimez la valeur de l'espace de travail pour faire réapparaître la valeur globale. Certains paramètres sont globaux seulement — notamment `chat.agentEngine`, `chat.uiMode` et `chat.terminalTitle` — et ne peuvent pas être remplacés par espace de travail.

Dans Kiro CLI 3.1.0 ou une version ultérieure, sous macOS et Linux, un fichier appartenant à root et désigné par la variable d'environnement `KIRO_DEFAULT_SETTINGS` fournit des valeurs par défaut sous les deux portées. Toute valeur de votre `cli.json` global ou d'espace de travail la remplace. Consultez [Variables d'environnement](#variables-denvironnement).

### Formats de sortie

```bash
# Plain text (default)
kiro-cli settings list

# JSON
kiro-cli settings list --format json

# Formatted JSON
kiro-cli settings list --format json-pretty
```

## Référence des paramètres

**ℹ️ Info:** Les paramètres marqués **classique seulement** configuraient l'interface classique. Dans Kiro CLI 3.0.0 ou une version ultérieure, l'interface classique ne s'exécute plus pour le clavardage interactif, donc ces paramètres n'ont aucun effet dans une session de l'interface utilisateur du terminal. Consultez [Si un lancement sélectionne encore l'interface classique](https://kiro.dev/docs/cli/agent-harness.md#si-un-lancement-sélectionne-encore-linterface-classique).

### Télémétrie et confidentialité

| Paramètre | Type | Description | Exemple |
|---------|------|-------------|---------|
| `telemetry.enabled` | boolean | Activer/désactiver la collecte de télémétrie | `kiro-cli settings telemetry.enabled true` |
| `telemetryClientId` | string | Identifiant client pour la télémétrie | `kiro-cli settings telemetryClientId "client-123"` |

<a id="interface-de-chat" />

### Interface de clavardage

| Paramètre | Type | Description | Exemple |
|---------|------|-------------|---------|
| `chat.defaultModel` | string | Modèle d'IA par défaut pour les conversations | `kiro-cli settings chat.defaultModel "claude-sonnet-4.6"` |
| `chat.defaultAgent` | string | Configuration d'agent par défaut | `kiro-cli settings chat.defaultAgent "my-agent"` |
| `chat.agentEngine` | string | Harnais d'agent pour `kiro-cli` et `kiro-cli chat` : `v3`, `v2` ou `v1`. Dans Kiro CLI 3.0.0 ou une version ultérieure, une valeur non définie démarre V3 pour le clavardage interactif sur une machine capable de l'exécuter; `v1` sélectionnait l'interface classique retirée et ouvre maintenant l'invite de mise à niveau de l'interface classique. Les indicateurs `--v3`, `--v2` et `--agent-engine` le remplacent pour une exécution. Global seulement; le fichier `.kiro/settings/cli.json` d'un espace de travail ne peut pas le remplacer. Ne s'applique pas à `kiro-cli acp`. Consultez [Choisir un harnais d'agent](https://kiro.dev/docs/cli/agent-harness.md) | `kiro-cli settings chat.agentEngine v2` |
| `chat.diffTool` | string | Outil de diff externe pour visualiser les changements de code (classique seulement) | `kiro-cli settings chat.diffTool "delta"` |
| `chat.greeting.enabled` | boolean | Afficher le message d'accueil au démarrage du clavardage | `kiro-cli settings chat.greeting.enabled false` |
| `chat.editMode` | boolean | Activer le mode d'édition Vi (classique seulement) | `kiro-cli settings chat.editMode true` |
| `chat.enableNotifications` | boolean | Activer les notifications de bureau | `kiro-cli settings chat.enableNotifications true` |
| `chat.notificationMethod` | string | Méthode de notification : `auto`, `bel` ou `osc9` | `kiro-cli settings chat.notificationMethod "osc9"` |
| `chat.disableMarkdownRendering` | boolean | Désactiver le formatage markdown (classique seulement) | `kiro-cli settings chat.disableMarkdownRendering false` |
| `chat.disableWrap` | boolean | Générer la sortie du clavardage sans retours à la ligne forcés, pour un copier-coller propre; le retour à la ligne automatique du terminal s'applique toujours. | `kiro-cli settings chat.disableWrap true` |
| `chat.disableAutoCompaction` | boolean | Désactiver le résumé automatique de la conversation | `kiro-cli settings chat.disableAutoCompaction true` |
| `compaction.autoCompactionThreshold` | number | Pourcentage d'utilisation du contexte à partir duquel la compaction automatique démarre dans une session V3 (Kiro CLI 3.3.0 ou version ultérieure). `kiro-cli settings` accepte de 0 à 100, avec au plus deux décimales; les sessions interactives appliquent la plage annoncée par le harnais d'agent | `kiro-cli settings compaction.autoCompactionThreshold 70` |
| `compaction.excludeMessages` | number | Nombre minimal de paires de messages à conserver pendant la compaction | `kiro-cli settings compaction.excludeMessages 2` |
| `compaction.excludeContextWindowPercent` | number | Pourcentage minimal de la fenêtre de contexte à conserver pendant la compaction | `kiro-cli settings compaction.excludeContextWindowPercent 2` |
| `chat.enablePromptHints` | boolean | Afficher des conseils de démarrage avec astuces et raccourcis (v1.26.0+, par défaut : true) | `kiro-cli settings chat.enablePromptHints false` |
| `chat.enableHistoryHints` | boolean | Afficher les astuces d'historique de conversation (classique seulement) | `kiro-cli settings chat.enableHistoryHints true` |
| `chat.uiMode` | string | Mode hérité de rendu des messages : `tui` (par défaut) affiche les messages de l'interface utilisateur du terminal; `structured` mettait en forme la sortie de l'interface classique et n'a aucun effet dans Kiro CLI 3.0.0 ou une version ultérieure. Ce paramètre ne choisit ni l'interface ni le harnais | `kiro-cli settings chat.uiMode "tui"` |
| `chat.historyMode` | string | Portée de l'historique des requêtes : `session` (par session, par défaut) ou `global` (partagé entre les sessions). Se configure via `/settings history`; s'applique à la prochaine session | `kiro-cli settings chat.historyMode global` |
| `chat.sessionDashboard.scope` | string | Portée des répertoires de `/sessions` dans V3 : `current` répertorie les sessions du répertoire actuel, tandis que `all` répertorie tous les espaces de travail (valeur par défaut : `current`). Kiro le met à jour lorsque vous basculez le filtre `current workspace only` | `kiro-cli settings chat.sessionDashboard.scope all` |
| `chat.sessionDashboard.indexResponses` | boolean | Portée de la recherche `/sessions` : `true` pour **Prompts and agent responses**, `false` pour **Prompts only** (par défaut : `true`). Les titres et vos requêtes sont toujours indexés, et la sortie des outils ne l'est jamais. Se configure via `/settings` → **Session search** | `kiro-cli settings chat.sessionDashboard.indexResponses false` |
| `chat.ui` | string | Interface : `tui` (par défaut) ou `classic`. Dans Kiro CLI 3.0.0 ou une version ultérieure, `classic` ne s'exécute plus pour le clavardage interactif; un lancement qui le sélectionne se voit plutôt proposer V3 | `kiro-cli settings chat.ui "tui"` |
| `chat.disableGranularTrust` | boolean | Désactiver les options de confiance à paliers pour les approbations d'outils (interface terminal seulement) | `kiro-cli settings chat.disableGranularTrust true` |
| `chat.autoExpandToolOutput` | boolean | Développer automatiquement la sortie des outils au lieu d'afficher des aperçus réduits. Sinon, les cartes d'écriture de fichiers affichent jusqu'à 40 rangées de diff; appuyez sur `Ctrl+O` ou activez ce paramètre pour révéler la diff complète pendant qu'elle continue de s'actualiser. Dans Kiro CLI 3.2.1 ou une version ultérieure, une carte d'écriture de fichier en attente d'approbation affiche toujours la diff complète; pour les écritures terminées, un plafond de lignes de sortie réglé au-dessus de 40 dans `/settings output-details` relève la limite de rangées | `kiro-cli settings chat.autoExpandToolOutput true` |
| `chat.modelDefaults` | object | Paramètres par défaut par modèle (par exemple, le niveau d'effort) qui s'appliquent aux nouvelles sessions | Voir [Effort](https://kiro.dev/docs/models/effort.md) |
| `chat.enableContextUsageIndicator` | boolean | Afficher le pourcentage d'utilisation du contexte dans la requête (classique seulement) | `kiro-cli settings chat.enableContextUsageIndicator true` |

**ℹ️ Info:** Une fois la liste des modèles disponible, une nouvelle session de l'interface terminal V3 vérifie `chat.defaultModel`. Si ce modèle n'est pas disponible, Kiro utilise le modèle par défaut fourni par le service et affiche un avis. Le paramètre n'est pas réécrit. Choisissez un identifiant dans [Modèles disponibles](https://kiro.dev/docs/models/available-models.md) ou avec la complétion par tabulation de `/model`. Une valeur d'espace de travail dans `.kiro/settings/cli.json` remplace la valeur globale dans `~/.kiro/settings/cli.json`; `/model set-current-as-default` modifie uniquement la valeur globale.

### Affichage et accessibilité (interface terminal)

Ces paramètres contrôlent la façon dont l'interface terminal affiche la sortie. Vous pouvez basculer les animations, l'art ASCII, les icônes, la prise en charge des lecteurs d'écran et l'affichage du raisonnement depuis une session avec `/settings display`.

| Paramètre | Type | Par défaut | Description | Exemple |
|---------|------|---------|-------------|---------|
| `chat.outputStyle` | string | Valeur par défaut de l'agent | Style de réponse V3 sélectionné sous `/settings display`; une valeur d'espace de travail a priorité sur la valeur globale | `kiro-cli settings chat.outputStyle concise` |
| `chat.allowAnimations` | boolean | `true` | Indicateurs animés et effets de brillance. Si `false`, les indicateurs affichent des images statiques | `kiro-cli settings chat.allowAnimations false` |
| `chat.allowAsciiArt` | boolean | `true` | Symboles Unicode/braille et dessin de cadres. Si `false`, revient à l'ASCII simple | `kiro-cli settings chat.allowAsciiArt false` |
| `chat.allowIcons` | boolean | `true` | Icônes d'indicateur d'état (●, ○, ⚠). Si `false`, utilise des étiquettes texte seulement | `kiro-cli settings chat.allowIcons false` |
| `chat.showThinking` | string | `expanded` | Façon dont les blocs de raisonnement (thinking) de l'agent s'affichent dans la sortie du clavardage (v2.5.0+) : `expanded`, `collapsed` ou `off`; `true` et `false` signifient toujours `collapsed` et `off`. Un changement en ligne de commande s'applique au prochain démarrage de session. Dans Kiro CLI 3.2.1 ou une version ultérieure, la rangée **Thinking** de `/settings output-details` écrit cette clé et s'applique à la session en cours | `kiro-cli settings chat.showThinking off` |
| `chat.terminalTitle` | boolean | `false` | Définir le titre de la fenêtre du terminal : un nom donné avec `/title`, sinon le titre de la session, sinon le nom du dossier de l'espace de travail. Dans Kiro CLI 2.33 ou une version ultérieure, une session V3 affiche le titre de sa session; avant la version 2.33, une session V3 utilisait plutôt le nom du dossier de l'espace de travail. Global seulement; se bascule aussi depuis `/settings display` → **Terminal title** | `kiro-cli settings chat.terminalTitle true` |
| `chat.preserveScrollback` | boolean | `true` | Préserver le tampon de défilement du terminal lorsque l'interface se redessine. Définissez ce paramètre à `false` pour rétablir le comportement d'effacement et de redessinage | `kiro-cli settings chat.preserveScrollback false` |
| `chat.screenReader` | string | `auto` | Prise en charge des lecteurs d'écran dans l'interface utilisateur complète du terminal : `auto`, `on` ou `off`. `auto` s'active seulement lorsque VoiceOver est détecté sur un Mac local. Global seulement. Lorsqu'elle est active, la saisie IME peut se déplacer. Consultez [Prise en charge des lecteurs d'écran](https://kiro.dev/docs/cli/chat/settings.md#prise-en-charge-des-lecteurs-décran) | `kiro-cli settings chat.screenReader on` |

**ℹ️ Info:** Définir la variable d'environnement `KIRO_ASCII_MODE=1` force le mode ASCII, peu importe `chat.allowAsciiArt`. Consultez [Affichage du raisonnement](https://kiro.dev/docs/cli/chat/settings.md#affichage-du-raisonnement) pour en savoir plus sur `chat.showThinking`. La bascule **Terminal title** de `/settings display` écrit `chat.terminalTitle`; consultez [Paramètres en session](https://kiro.dev/docs/cli/chat/settings.md#settings-display) pour la bascule.

### Indicateurs d'activité

L'interface terminal affiche un indicateur d'activité pendant que Kiro travaille. Définissez `chat.enableCustomSpinnerVerbs` à `true` pour utiliser l'ensemble de verbes défini dans `chat.spinnerVerbs`.

| Paramètre | Type | Par défaut | Description |
|---------|------|---------|-------------|
| `chat.enableCustomSpinnerVerbs` | boolean | `false` | Utiliser l'ensemble de verbes personnalisé défini dans `chat.spinnerVerbs` |
| `chat.spinnerVerbs` | object | Non défini | Un ensemble de verbes avec le mode `append` ou `replace` |

Exécutez `kiro-cli settings open`, puis ajoutez les propriétés suivantes à l'objet de niveau supérieur de `~/.kiro/settings/cli.json` sans remplacer les paramètres existants :

```json
{
  "chat.enableCustomSpinnerVerbs": true,
  "chat.spinnerVerbs": {
    "mode": "append",
    "verbs": [
      "Checking...",
      "Reading documentation <https://docs.example.com>"
    ]
  }
}
```

Utilisez `append` pour ajouter vos verbes à l'ensemble intégré de Kiro. Utilisez `replace` pour utiliser uniquement vos verbes. Une liste `replace` vide revient à l'indicateur d'activité intégré. Un verbe peut se terminer par un espace suivi d'une URL `http` ou `https` entre chevrons. Kiro affiche le texte du verbe et en fait un hyperlien de terminal lorsque le terminal prend en charge les hyperliens.

### Base de connaissances

| Paramètre | Type | Description | Exemple |
|---------|------|-------------|---------|
| `chat.enableKnowledge` | boolean | Activer la fonctionnalité de base de connaissances | `kiro-cli settings chat.enableKnowledge true` |
| `chat.enableCodeIntelligence` | boolean | Activer l'intelligence du code de V3 | `kiro-cli settings chat.enableCodeIntelligence true` |
| `knowledge.defaultIncludePatterns` | array | Motifs de fichiers par défaut à inclure | `kiro-cli settings knowledge.defaultIncludePatterns '["*.py", "*.js"]'` |
| `knowledge.defaultExcludePatterns` | array | Motifs de fichiers par défaut à exclure | `kiro-cli settings knowledge.defaultExcludePatterns '["*.log", "node_modules"]'` |
| `knowledge.maxFiles` | number | Nombre maximal de fichiers pour l'indexation | `kiro-cli settings knowledge.maxFiles 1000` |
| `knowledge.chunkSize` | number | Taille des blocs de texte pour le traitement | `kiro-cli settings knowledge.chunkSize 512` |
| `knowledge.chunkOverlap` | number | Chevauchement entre les blocs de texte | `kiro-cli settings knowledge.chunkOverlap 50` |
| `knowledge.indexType` | string | Type d'index de connaissances | `kiro-cli settings knowledge.indexType "fast"` |

**ℹ️ Info:** V3 active la base de connaissances et l'intelligence du code par défaut. Définissez `chat.enableKnowledge` ou `chat.enableCodeIntelligence` à `false` pour désactiver l'un ou l'autre de ces outils. Les harnais d'agent V1 et V2 conservent leur comportement existant pour la base de connaissances.

### Raccourcis clavier (classique seulement)

Ces raccourcis clavier s'appliquent uniquement à l'interface classique et n'ont aucun effet dans l'interface terminal.

| Paramètre | Type | Description | Exemple |
|---------|------|-------------|---------|
| `chat.skimCommandKey` | char | Touche pour la commande de recherche floue | `kiro-cli settings chat.skimCommandKey "f"` |
| `chat.autocompletionKey` | char | Touche pour accepter la suggestion d'autocomplétion | `kiro-cli settings chat.autocompletionKey "Tab"` |
| `chat.tangentModeKey` | char | Touche pour basculer le mode tangente | `kiro-cli settings chat.tangentModeKey "t"` |
| `chat.delegateModeKey` | char | Touche pour la commande de délégation | `kiro-cli settings chat.delegateModeKey "d"` |

### Raccourcis clavier (interface terminal)

Remplacez les raccourcis de l'interface terminal pour annuler une réponse, fermer les menus superposés, quitter la session et ouvrir la visionneuse de diagrammes. Les valeurs utilisent les modificateurs `ctrl+`, `shift+` et `alt+`/`meta+` avec une seule touche (par exemple `ctrl+shift+q`, `esc`). Les valeurs invalides reviennent au raccourci par défaut intégré.

| Paramètre | Type | Par défaut | Description | Exemple |
|---------|------|---------|-------------|---------|
| `chat.keybindings.cancelStream` | string | `esc` | Annuler la réponse en cours de l'agent pendant sa diffusion | `kiro-cli settings chat.keybindings.cancelStream "ctrl+x"` |
| `chat.keybindings.closeMenu` | string | `esc` | Fermer les panneaux superposés et les sélecteurs | `kiro-cli settings chat.keybindings.closeMenu "ctrl+["` |
| `chat.keybindings.quit` | string | `ctrl+c` | Quitter la session de clavardage | `kiro-cli settings chat.keybindings.quit "ctrl+shift+q"` |
| `chat.keybindings.viewDiagram` | string | `ctrl+]` | Ouvrir sur son propre écran un diagramme Mermaid trop large pour le terminal (Kiro CLI 3.2.0 ou une version ultérieure) | `kiro-cli settings chat.keybindings.viewDiagram "ctrl+shift+d"` |

### Tool Search

V3 charge les outils MCP à la demande par défaut. Il lit les valeurs `toolSearch.*` enregistrées lors des exécutions interactives. Kiro CLI 2.31.1 et les versions ultérieures les appliquent aussi aux exécutions V3 non interactives. V2 reste à activer explicitement. Consultez [Tool Search](https://kiro.dev/docs/mcp/tool-search.md) pour les détails.

| Paramètre | Type | Description | Exemple |
|---------|------|-------------|---------|
| `toolSearch.enabled` | boolean | Contrôler Tool Search. Valeur par défaut V2 : `false`. V3 charge les outils à la demande lorsqu'aucune valeur n'est enregistrée | `kiro-cli settings toolSearch.enabled true` |
| `toolSearch.minPct` | number | S'active lorsque les spécifications des outils MCP dépassent ce pourcentage de la fenêtre de contexte. Valeur par défaut V2 : `5`. V3 ne lit cette valeur que si `toolSearch.enabled` est aussi enregistré | `kiro-cli settings toolSearch.minPct 0` |
| `toolSearch.minTokens` | number | S'active lorsque les spécifications des outils MCP dépassent ce nombre de jetons. Valeur par défaut V2 : `50000`. V3 ne lit cette valeur que si `toolSearch.enabled` est aussi enregistré | `kiro-cli settings toolSearch.minTokens 0` |

### Bascules de fonctionnalités

| Paramètre | Type | Description | Exemple |
|---------|------|-------------|---------|
| `chat.enableThinking` | boolean | Activer l'outil de raisonnement pour le raisonnement complexe (distinct de `chat.showThinking`, qui affiche les propres blocs de raisonnement du modèle) | `kiro-cli settings chat.enableThinking true` |
| `chat.enableTangentMode` | boolean | Activer la fonctionnalité de mode tangente (classique seulement) | `kiro-cli settings chat.enableTangentMode true` |
| `introspect.tangentMode` | boolean | Entrer automatiquement en mode tangente pour introspect (classique seulement) | `kiro-cli settings introspect.tangentMode true` |
| `chat.enableTodoList` | boolean | Activer la fonctionnalité de liste de tâches dans Classic; V3 ne propose pas `todo_list`, donc ce paramètre n'y a aucun effet | `kiro-cli settings chat.enableTodoList true` |
| `chat.enableCheckpoint` | boolean | Activer la fonctionnalité de point de contrôle (classique seulement) | `kiro-cli settings chat.enableCheckpoint true` |
| `chat.enableDelegate` | boolean | Activer l'outil de délégation (classique seulement) | `kiro-cli settings chat.enableDelegate true` |
| `chat.enableWorkflows` | boolean | Activer les [Workflows](https://kiro.dev/docs/workflows.md) déclaratifs dans les sessions V3; redémarrez Kiro CLI après avoir modifié ce paramètre | `kiro-cli settings chat.enableWorkflows true` |
| `chat.workflowLaunch` | string | Choisir quand V3 lance des Workflows : `when-asked` (par défaut), `large-tasks` ou `delegate-all` | `kiro-cli settings chat.workflowLaunch large-tasks` |
| `chat.enableSessionRecap` | boolean | Afficher un récapitulatif de session au-dessus de la zone de saisie dans une session V3 (Kiro CLI 3.1.0 ou une version ultérieure). Désactivé par défaut; démarrez une nouvelle session après l'avoir modifié. Lorsqu'il est activé, Kiro effectue un appel de modèle facturé supplémentaire après chaque tour terminé, et l'interface utilisateur complète du terminal affiche le récapitulatif après trois secondes d'inactivité. Le mode Lite ne l'affiche pas, mais l'appel s'exécute tout de même. Consultez [Session recap](https://kiro.dev/docs/cli/chat/settings.md#settings-features) | `kiro-cli settings chat.enableSessionRecap true` |
| `chat.enableAutoAgentUpgrade` | boolean | Mettre à niveau les agents au format V2 des répertoires d'agents analysés vers le format V3 au démarrage d'une session V3. Dans Kiro CLI 2.37 ou une version ultérieure, une valeur non définie signifie activé; un `false` explicite le désactive, et les lancements V3 interactifs affichent alors un avis tant que des agents doivent encore être mis à niveau. Global seulement; le fichier `.kiro/settings/cli.json` d'un espace de travail ne peut pas le remplacer | `kiro-cli settings chat.enableAutoAgentUpgrade false` |
| `app.disableAutoupdates` | boolean | Désactiver les mises à jour automatiques en arrière-plan | `kiro-cli settings app.disableAutoupdates true` |
| `app.warnOnElevatedPrivileges` | boolean | Afficher un avertissement lorsque Kiro CLI démarre en tant que root (macOS et Linux) ou en tant qu'Administrator (Windows). Ce paramètre est activé par défaut et est global; le fichier `.kiro/settings/cli.json` d'un espace de travail ne peut pas le remplacer | `kiro-cli settings app.warnOnElevatedPrivileges false` |

### API et service

| Paramètre | Type | Description | Exemple |
|---------|------|-------------|---------|
| `api.timeout` | number | Délai d'expiration global en secondes pour une réponse en continu (valeur par défaut `3600`). Comptabilise la durée totale de la réponse, donc la valeur par défaut d'une heure laisse aux réponses longues le temps de se terminer; définissez une valeur plus basse pour imposer une limite plus courte | `kiro-cli settings api.timeout 600` |
| `api.streamIdleSoftTimeout` | number | Secondes de silence du flux de réponse avant l'affichage d'un avertissement de blocage (valeur par défaut `60`) | `kiro-cli settings api.streamIdleSoftTimeout 120` |
| `api.streamIdleHardTimeout` | number | Secondes de silence du flux de réponse avant l'annulation de la requête bloquée (valeur par défaut `300`) | `kiro-cli settings api.streamIdleHardTimeout 600` |
| `api.subagentTimeout` | number | Secondes pendant lesquelles un sous-agent peut rester inactif avant l'expiration de son délai, au lieu de bloquer le tour parent (valeur par défaut `3600`) | `kiro-cli settings api.subagentTimeout 1800` |

Les échecs de requête transitoires — limitation, erreurs 5xx et interruptions de connexion (y compris les réinitialisations en cours de flux) — sont automatiquement retentés avec un délai croissant; aucun paramètre n'est requis.

### Protocole de contexte de modèle (MCP)

| Paramètre | Type | Description | Exemple |
|---------|------|-------------|---------|
| `mcp.initTimeout` | number | Délai d'expiration d'initialisation du serveur MCP en millisecondes (par défaut `5000`) | `kiro-cli settings mcp.initTimeout 10000` |
| `mcp.noInteractiveTimeout` | number | Délai d'expiration d'initialisation MCP en millisecondes pour les exécutions non interactives (par défaut `30000`) | `kiro-cli settings mcp.noInteractiveTimeout 60000` |
| `mcp.loadedBefore` | boolean | Suivre les serveurs MCP précédemment chargés | `kiro-cli settings mcp.loadedBefore true` |

### Agent Client Protocol (ACP)

| Paramètre | Type | Description | Exemple |
|---------|------|-------------|---------|
| `acp.agentEngine` | string | Harnais d'agent pour `kiro-cli acp` : `v3`, `v2` ou `v1` (Kiro CLI 2.36 ou une version ultérieure). L'indicateur `--agent-engine` le remplace. Dans Kiro CLI 3.0.0 ou une version ultérieure, une valeur non définie démarre V3 sur une machine capable de l'exécuter, sauf si la ligne de lancement contient un indicateur réservé à V2 ou si Kiro reconnaît le client comme un client qui a encore besoin de V2. Global seulement; le fichier `.kiro/settings/cli.json` d'un espace de travail ne peut pas le remplacer. `chat.agentEngine` ne s'applique pas à `kiro-cli acp`. Consultez [Clients ACP](https://kiro.dev/docs/cli/agent-harness.md#clients-acp) | `kiro-cli settings acp.agentEngine v3` |

## Exemples de configuration courants

### Configuration de base

```bash
# Enable telemetry
kiro-cli settings telemetry.enabled true

# Set default chat model
kiro-cli settings chat.defaultModel "claude-sonnet-4.6"

# Disable greeting message
kiro-cli settings chat.greeting.enabled false
```

### Configuration de la base de connaissances

```bash
# Enable knowledge base
kiro-cli settings chat.enableKnowledge true

# Set file patterns to include
kiro-cli settings knowledge.defaultIncludePatterns '["*.py", "*.js", "*.md", "*.txt"]'

# Set file patterns to exclude
kiro-cli settings knowledge.defaultExcludePatterns '["*.log", "node_modules", ".git", "*.pyc"]'

# Set maximum files to index
kiro-cli settings knowledge.maxFiles 2000
```

### Activer les fonctionnalités expérimentales

```bash
# Enable thinking tool
kiro-cli settings chat.enableThinking true

# Enable tangent mode
kiro-cli settings chat.enableTangentMode true

# Enable todo lists
kiro-cli settings chat.enableTodoList true

# Enable checkpoints
kiro-cli settings chat.enableCheckpoint true

# Configure key bindings
kiro-cli settings chat.tangentModeKey "t"
kiro-cli settings chat.delegateModeKey "d"
```

### Optimisation des performances

```bash
# Cap streaming responses at 10 minutes instead of the 60-minute default
kiro-cli settings api.timeout 600

# Give slow connections more room before a stall warning
kiro-cli settings api.streamIdleSoftTimeout 120

# Adjust knowledge base chunk size
kiro-cli settings knowledge.chunkSize 1024

# Disable auto-compaction for long conversations
kiro-cli settings chat.disableAutoCompaction true
```

## Résolution de problèmes liés aux paramètres

### Valeurs de paramètres invalides

**Valeurs booléennes :** Utilisez `true` ou `false` (minuscules)
```bash
kiro-cli settings telemetry.enabled true  # ✓ Correct
kiro-cli settings telemetry.enabled True  # ✗ Wrong
```

**Valeurs de tableau :** Utilisez le format JSON avec des guillemets simples
```bash
kiro-cli settings knowledge.defaultIncludePatterns '["*.py", "*.js"]'  # ✓ Correct
```

**Valeurs de chaîne :** Utilisez des guillemets pour les chaînes contenant des espaces
```bash
kiro-cli settings chat.defaultModel "claude-sonnet-4.6"  # ✓ Correct
```

### Réinitialiser les paramètres

Supprimez des paramètres individuels :
```bash
kiro-cli settings --delete setting.name
```

Ouvrez le fichier de paramètres pour une modification manuelle :
```bash
kiro-cli settings open
```

Consultez les paramètres actuels pour identifier les problèmes :
```bash
kiro-cli settings list --all
```

### Problèmes liés au fichier de paramètres

Si le fichier de paramètres devient corrompu :

1. **Sauvegardez les paramètres actuels :**
   ```bash
   kiro-cli settings list --format json > backup.json
   ```

2. **Ouvrez le fichier de paramètres :**
   ```bash
   kiro-cli settings open
   ```

3. **Vérifiez la syntaxe JSON ou restaurez à partir de la sauvegarde**

## Emplacement du fichier de paramètres

Les paramètres sont stockés dans `~/.kiro/settings/cli.json`.

Vous pouvez modifier ce fichier directement, mais il est recommandé d'utiliser les commandes `kiro-cli settings` pour la validation.

## Variables d'environnement

| Variable | Description |
|----------|-------------|
| `KIRO_HOME` | Définissez un chemin absolu pour conserver des profils Kiro distincts, par exemple professionnel et personnel. Dans V3, cette variable remplace le répertoire Kiro global pour la configuration, les connexions, les sessions et l'état des agents. Une racine de système de fichiers, votre répertoire personnel, l'un de ses répertoires parents ou un chemin relatif entraîne un retour à `~/.kiro`. |
| `KIRO_DEFAULT_SETTINGS` | Chemin absolu vers un fichier de paramètres par défaut (Kiro CLI 3.1.0 ou une version ultérieure, macOS et Linux). Le fichier doit être un fichier ordinaire appartenant à root, non modifiable par le groupe ni par les autres utilisateurs, d'une taille de 1 Mio ou moins, et contenir un objet JSON. Ses valeurs forment la couche de paramètres la plus basse; `~/.kiro/settings/cli.json` et les paramètres d'espace de travail les remplacent. `kiro-cli settings` et `/settings` indiquent ce fichier comme source d'une valeur qui en provient, et `kiro-cli settings` ne peut ni définir ni supprimer de valeurs dans ce fichier. Si le chemin est relatif ou si le fichier échoue à une vérification, Kiro affiche un seul avertissement et ignore le fichier. |
| `KIRO_LOG_NO_COLOR` | Définir à `1` pour désactiver la sortie de journal en couleur |
| `NO_COLOR` | Définir à n'importe quelle valeur pour désactiver toute sortie en couleur dans l'interface terminal |
| `KIRO_SCREEN_READER` | Définir à `auto`, `on` ou `off` pour remplacer `chat.screenReader` pour un seul lancement |
| `KIRO_CLI_TOOL_SEARCH_MATCHING_THRESHOLD` | Score de pertinence minimal pour les résultats par mots-clés de Tool Search dans V2 (par défaut : `1.5`) |

## Prochaines étapes

- [Configurer des agents personnalisés](https://kiro.dev/docs/custom-agents/configuration-reference.md)
- [Workflows](https://kiro.dev/docs/workflows.md)
- [Configurer des serveurs MCP](https://kiro.dev/docs/mcp.md)
- [Configurer des outils de diff personnalisés](https://kiro.dev/docs/cli/chat/diff-tools.md)
- [Activer les fonctionnalités expérimentales](https://kiro.dev/docs/cli/experimental.md)
- [Référence des commandes CLI](https://kiro.dev/docs/reference/cli-commands.md)