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

# Effort de raisonnement

> Contrôlez la quantité de raisonnement appliquée par le modèle pour équilibrer vitesse, profondeur et coût

L'effort de raisonnement contrôle la quantité de réflexion que le modèle applique à vos requêtes. Des niveaux d'effort plus bas produisent des réponses plus rapides et plus courtes et utilisent moins de crédits. Des niveaux plus élevés consacrent plus de jetons à une analyse plus approfondie, à un raisonnement en plusieurs étapes et à une génération de code approfondie.

| Capacité | IDE | CLI | Web | Mobile |
|------------|:---:|:---:|:---:|:------:|
| Sélection de l'effort de raisonnement | ✓ | ✓ | — | — |

**Niveaux disponibles :**

| Niveau | Comportement |
|-------|----------|
| `low` | Réponses rapides et concises. Convient pour les questions simples et les recherches rapides. |
| `medium` | Raisonnement équilibré. Convient pour la plupart des tâches de développement. |
| `high` | Analyse approfondie. Mieux adapté pour la refactorisation complexe et les décisions d'architecture. |
| `xhigh` | Raisonnement étendu. Utile pour les modifications multi-fichiers et les problèmes nuancés. |
| `max` | Profondeur maximale. Idéal pour le débogage difficile, l'analyse de sécurité et la logique complexe. |

Tous les modèles ne prennent pas en charge tous les niveaux. Le sélecteur affiche uniquement les niveaux disponibles pour votre modèle actuel - voir les [modèles pris en charge](#supported-models) ci-dessous.

## Définir le niveau d'effort

    IDE
    CLI

Cliquez sur le nom du modèle dans la barre de saisie du chat pour ouvrir le sélecteur de modèle, puis choisissez un niveau d'effort dans le panneau **Effort** sur le côté droit.

Votre sélection d'effort apparaît à côté du nom du modèle (p. ex., « Claude Opus 4.6 · max ») et s'applique à tous les messages suivants dans la conversation.

Utilisez la commande `/effort` pour changer le niveau de raisonnement en cours de session :

```bash
# Open interactive picker
/effort

# Set directly
/effort high
```

Ou définissez le niveau d'effort initial au démarrage d'une session avec l'indicateur `--effort` :

```bash
kiro-cli chat --effort high
```

L'indicateur accepte les mêmes niveaux que `/effort` et s'applique dès votre première requête, afin que les recherches rapides restent rapides et que les tâches complexes bénéficient d'un raisonnement plus approfondi dès le départ.

## Modèles pris en charge

Chaque modèle définit les valeurs qu'il accepte pour les champs liés au raisonnement dans son schéma de configuration. La colonne `output_config.effort` répertorie les niveaux d'effort disponibles pour ce modèle; `thinking.type` et `thinking.display` contrôlent le comportement et la visibilité du raisonnement; `max_tokens` définit la limite de longueur de sortie.

**Les modèles Claude** utilisent `output_config.effort` avec les contrôles `thinking.type` et `thinking.display` :

| Modèle | `thinking.type` | `thinking.display` | `output_config.effort` | `max_tokens` |
|-------|-----------------|--------------------|------------------------|--------------|
| Claude Opus 5 | `adaptive`, `disabled` | `summarized`, `omitted` | `low`, `medium`, `high`, `xhigh`, `max` | 1024–128000 |
| Claude Opus 4.8 | `adaptive`, `disabled` | `summarized`, `omitted` | `low`, `medium`, `high`, `xhigh`, `max` | 1024–128000 |
| Claude Opus 4.7 | `adaptive`, `disabled` | `summarized`, `omitted` | `low`, `medium`, `high`, `xhigh`, `max` | 1024–64000 |
| Claude Opus 4.6 | `adaptive`, `disabled` | `summarized`, `omitted` | `low`, `medium`, `high`, `max` | 1024–64000 |
| Claude Sonnet 5 | `adaptive`, `disabled` | `summarized`, `omitted` | `low`, `medium`, `high`, `xhigh`, `max` | 1024–128000 |
| Claude Sonnet 4.6 | `adaptive`, `disabled` | `summarized`, `omitted` | `low`, `medium`, `high`, `max` | 1024–64000 |

**Les modèles GPT-5.6** utilisent `reasoning.effort` :

| Modèle | `reasoning.effort` |
|-------|-------------------|
| GPT-5.6 Terra | `none`, `low`, `medium`, `high`, `xhigh`, `max` |
| GPT-5.6 Sol | `none`, `low`, `medium`, `high`, `xhigh`, `max` |
| GPT-5.6 Luna | `none`, `low`, `medium`, `high`, `xhigh`, `max` |

Les modèles GPT-5.6 utilisent par défaut `effort: "high"`.

## Persistance de votre niveau d'effort (CLI)

Votre choix d'effort persiste automatiquement. Définissez un niveau avec `/effort` ou `--effort` et Kiro s'en souvient pour les sessions futures - il n'y a aucune étape supplémentaire pour en faire la valeur par défaut. Les préférences sont stockées dans `~/.kiro/settings/cli.json`. Consultez [Paramètres en session](https://kiro.dev/docs/cli/chat/settings.md#persistance) pour en savoir plus sur la persistance des préférences.

## Valeurs par défaut persistantes (CLI)

Pour définir des paramètres de modèle par défaut par modèle - afin de ne pas avoir à exécuter `/effort` au début de chaque session - ajoutez `chat.modelDefaults` à votre fichier de paramètres :

**Modèles Claude** (utilisent `output_config.effort`) :

```json
{
  "chat.modelDefaults": {
    "claude-sonnet-4.6": {
      "output_config": {
        "effort": "high"
      }
    },
    "claude-opus-4.7": {
      "output_config": {
        "effort": "max"
      }
    }
  }
}
```

**Modèles GPT-5.6** (utilisent `reasoning.effort`) :

```json
{
  "chat.modelDefaults": {
    "gpt-5.6-sol": {
      "reasoning": {
        "effort": "max"
      }
    },
    "gpt-5.6-terra": {
      "reasoning": {
        "effort": "low"
      }
    }
  }
}
```

### Configuration du comportement de réflexion

Contrôlez si le modèle utilise le raisonnement étendu et comment il affiche son raisonnement :

```json
{
  "chat.modelDefaults": {
    "claude-opus-4.8": {
      "thinking": {
        "type": "adaptive",
        "display": "summarized"
      }
    },
    "claude-sonnet-4.6": {
      "thinking": {
        "type": "disabled"
      }
    }
  }
}
```

- `thinking.type` - `adaptive` active le raisonnement étendu lorsque le modèle détermine que c'est nécessaire; `disabled` le désactive entièrement.
- `thinking.display` - `summarized` affiche une version condensée du raisonnement; `omitted` le masque de la sortie. S'applique seulement lorsque `type` est `adaptive`.

### Configuration du nombre maximal de jetons de sortie

Définissez le nombre maximal de jetons que le modèle peut générer par réponse :

```json
{
  "chat.modelDefaults": {
    "claude-opus-4.8": {
      "max_tokens": 128000
    },
    "claude-sonnet-4.6": {
      "max_tokens": 32000
    }
  }
}
```

**Limites de `max_tokens` par modèle :**

| Modèle | Minimum | Maximum |
|-------|---------|---------|
| Claude Opus 4.8 | 1024 | 128000 |
| Claude Opus 4.7 | 1024 | 64000 |
| Claude Opus 4.6 | 1024 | 64000 |
| Claude Sonnet 5 | 1024 | 128000 |
| Claude Sonnet 4.6 | 1024 | 64000 |
| GPT-5.6 Terra | 1024 | 128000 |
| GPT-5.6 Sol | 1024 | 128000 |
| GPT-5.6 Luna | 1024 | 128000 |

### Combinaison de toutes les options

Vous pouvez combiner `output_config`, `thinking` et `max_tokens` dans une seule entrée de modèle :

**Exemple Claude :**

```json
{
  "chat.modelDefaults": {
    "claude-opus-4.8": {
      "output_config": {
        "effort": "max"
      },
      "thinking": {
        "type": "adaptive",
        "display": "summarized"
      },
      "max_tokens": 128000
    }
  }
}
```

**Exemple GPT-5.6 :**

```json
{
  "chat.modelDefaults": {
    "gpt-5.6-sol": {
      "reasoning": {
        "effort": "max"
      },
      "max_tokens": 128000
    }
  }
}
```

Pour ouvrir votre fichier de paramètres dans votre éditeur :

```bash
kiro-cli settings open
```

Ou placez un fichier `.kiro/settings/cli.json` dans la racine de votre projet pour définir des valeurs par défaut au niveau de l'espace de travail qui s'appliquent à tous ceux qui travaillent dans ce dépôt.

## Priorité

Lors de la détermination du niveau d'effort pour une session, Kiro applique cet ordre de priorité :

1. **Substitution de session** - valeur définie via le sélecteur d'effort, `/effort`, ou `--effort` durant la session actuelle
2. **Valeurs par défaut de l'espace de travail** - `chat.modelDefaults` dans `.kiro/settings/cli.json`
3. **Valeurs par défaut de l'utilisateur** - `chat.modelDefaults` dans `~/.kiro/settings/cli.json`
4. **Valeurs par défaut intégrées** - le niveau d'effort standard du modèle

## Quand ajuster l'effort

- **Augmentez** lorsque l'agent donne des réponses superficielles, manque des cas limites ou produit des implémentations incomplètes
- **Diminuez** lorsque vous avez besoin de réponses rapides et ne voulez pas attendre un raisonnement étendu
- **Utilisez `max`** pour les révisions de sécurité, les sessions de débogage complexes, ou lorsque vous avez besoin que l'agent prenne en compte de nombreuses contraintes interdépendantes

## Voir aussi

- [Modèles](https://kiro.dev/docs/models.md) - modèles disponibles et leurs capacités
- [Référence des commandes slash](https://kiro.dev/docs/reference/slash-commands.md#effort) - référence rapide des commandes
- [Paramètres](https://kiro.dev/docs/reference/settings.md) - tous les paramètres configurables