Configuration des modèles

Le framework permet de configurer quel modèle IA utiliser pour chaque agent, de manière centralisée.

Pourquoi c'est important

Chaque modèle a des caractéristiques différentes :

Modèle	Forces	Coût	Usage recommandé
opus	Raisonnement profond, analyse complexe	Élevé	Architecture, review, analyse
sonnet	Bon équilibre qualité/vitesse	Moyen	Implémentation, tests
haiku	Rapide, économique	Faible	Scan, lookup, extraction

Configuration par défaut

Le fichier framework/models.md définit les assignations par défaut :

Agents

Agent	Modèle par défaut	Pourquoi
analyst	opus	Raisonnement profond pour clarifier les besoins
architect	opus	Décisions architecturales complexes
executor	sonnet	Bon équilibre pour le code
code-reviewer	opus	Détection fine des bugs et failles
security-reviewer	opus	Audit sécurité approfondi
quality-reviewer	sonnet	Qualité et maintenabilité
test-engineer	sonnet	Stratégie de tests
explore	haiku	Scan rapide, pas de raisonnement complexe
debugger	sonnet	Analyse de cause racine

Presets

Trois presets sont disponibles pour adapter rapidement le framework :

Budget — minimiser les coûts

models:
  preset: budget

Tout en sonnet sauf les agents de scan en haiku. Idéal pour le prototypage ou les budgets serrés.

Standard — équilibre coût/qualité (défaut)

models:
  preset: standard

Analyse et review en opus, implémentation en sonnet, scan en haiku. C'est le réglage par défaut.

Quality — maximiser la qualité

models:
  preset: quality

Tout en opus sauf les agents de scan. Pour le code critique (auth, paiement, infrastructure).

Override par projet

Ajoutez dans votre CLAUDE.md :

## Models
models:
  preset: standard
  override:
    executor: opus       # je veux opus pour le code aussi
    code-reviewer: opus  # review plus poussée

Ordre de résolution

1. CLAUDE.md > models > override     ← priorité la plus haute
2. CLAUDE.md > models > preset
3. framework/models.md               ← défaut du framework
4. Frontmatter de l'agent            ← fallback

Pour les collaborateurs

Chaque développeur peut override les modèles dans le CLAUDE.md de son projet sans modifier le framework partagé.

Exemples

Développeur solo, budget limité

## Models
models:
  preset: budget

Équipe, code critique (fintech)

## Models
models:
  preset: quality

Personnalisé : opus pour l'analyse, haiku pour le reste

## Models
models:
  preset: budget
  override:
    analyst: opus
    architect: opus
    code-reviewer: opus

Utilisateurs OpenCode

Sur OpenCode, les modèles sont configurés via npx opencode-shingan setup --models (ou install.sh) avec 3 modes : un seul modèle, un modèle par tier, ou un modèle par agent. Voir le tutoriel dédié pour les détails.

Chargement

Les modèles sont chargés par APEX au Step 00 (Init) :

1. Lire framework/models.md (défauts)
2. Lire CLAUDE.md section models: (preset + overrides)
3. Résoudre les conflits par ordre de priorité
4. Stocker les assignations dans le contexte de la tâche
5. Chaque step utilise le modèle assigné à l'agent actif