Changer l'identité et le modèle de l'assistant

Comment choisir l'identité de l'assistant (Koog / Claude Code / Codex), où changer de modèle et les quatre erreurs rencontrées quand le basculement échoue.

Le modèle utilisé par l'assistant se choisit en deux temps : d'abord l'identité de l'assistant (qui l'exécute), ensuite le modèle (ce qui est exécuté). La plupart des gens bloquent parce qu'ils confondent les deux étapes.

Étape 1 : choisir l'identité de l'assistant

Ouvrez Paramètres du compte → Assistant IA. Le tout premier champ est le type d'identité de l'assistant, avec trois choix :

Identité	De quoi il s'agit	Quel identifiant il faut
Koog	Le moteur intégré : appelle directement des LLM classiques via fournisseur + modèle. C'est l'option par défaut.	Une clé d'API du fournisseur concerné (OpenAI, Anthropic, OpenRouter, DeepSeek, etc.)
Claude Code	Exécute la ligne de commande Claude Code en tant qu'assistant lui-même.	Un jeton d'abonnement Claude — à enregistrer avec le provider claude_code_oauth
Codex	Exécute la ligne de commande Codex en tant qu'assistant lui-même.	Le fichier auth.json de Codex — à enregistrer avec le provider codex_subscription

Vous avez choisi une identité externe sans pouvoir enregistrer ?

Si vous passez à Claude Code ou Codex sans l'identifiant d'abonnement correspondant, la page affiche « aucun identifiant d'abonnement utilisable pour cette identité » et refuse l'enregistrement — volontairement, pour ne pas conserver une configuration inutilisable. La solution : ajoutez l'identifiant dans Intégrations → Fournisseurs de modèles, puis revenez changer d'identité.

Étape 2 : choisir le modèle

Avec l'identité Koog

Choisissez d'abord le mode de configuration : modèle prédéfini (une configuration toute faite) ou configuration personnalisée (vous remplissez chaque champ).
Choisissez le fournisseur : la liste de modèles est chargée par fournisseur, donc après un changement, rouvrez la liste déroulante des modèles pour la recharger.
Choisissez le modèle LLM. Si le vôtre n'est pas dans la liste, saisissez son identifiant à la main.
Facultatif : indiquez quel identifiant chaque fournisseur doit utiliser. Laissé vide, le système cherche un identifiant du même fournisseur, d'abord personnel puis d'équipe.

Avec l'identité Claude Code / Codex

Les modèles proposés viennent de ce que prend en charge votre compte d'abonnement, pas de la liste des fournisseurs. Suivez les indications du bloc de configuration de ce runtime : côté Codex, des noms comme gpt-5.6-sol sont courants.

Le point le plus souvent confondu

Avec l'identité Koog, un autre bloc apparaît plus bas : « Claude Code / Codex (sous-agent externe appelé comme outil) ». C'est tout autre chose que le type d'identité de l'assistant :

Rôle — Détermine qui exécute toute la conversation. Choisissez Claude Code et l'assistant lui-même devient Claude Code.
Sous-agent externe — L'assistant reste Koog et se contente d'appeler Claude Code ou Codex comme un outil en cas de besoin. Ce bloc n'apparaît que si external_agent est coché dans le jeu d'outils.

Pour remplacer l'assistant lui-même, changez l'identité ci-dessus ; pour qu'il emprunte occasionnellement une CLI externe, configurez le sous-agent ci-dessous.

L'identité détermine aussi s'il peut modifier les workflows

L'identité Koog crée et modifie des workflows dans la conversation nativement. Avec Claude Code ou Codex, cela dépend d'un canal d'édition configuré côté déploiement ; s'il manque, demander la création d'un flux renvoie un message clair : cette identité d'assistant ne prend pas en charge les outils d'édition intégrés, revenez à Koog.

Construisez d'abord le flux, changez d'identité ensuite

Si votre objectif principal est que l'assistant construise vos workflows, rester sur Koog est le plus simple. Basculez quand vous voulez précisément les capacités de codage de Claude Code ou Codex — ou choisissez-les seulement pour une étape d'agent dans le workflow, comme l'explique la page suivante.

Erreurs fréquentes et ce qu'elles signifient

Ce que vous voyez	La cause réelle	Que faire
Aucune identification d'abonnement trouvée pour l'identité actuelle	Vous êtes passé à une identité externe alors que le centre d'identifiants ne contient aucun identifiant d'abonnement pour ce fournisseur.	Ajoutez d'abord un identifiant claude_code_oauth ou codex_subscription, puis changez d'identité.
Cette identité d'assistant ne prend pas en charge les outils d'édition de workflow intégrés	Le canal d'édition utilisé par les identités externes n'est pas prêt sur ce déploiement.	Repassez sur Koog pour terminer l'édition, ou demandez à un administrateur de vérifier la configuration du déploiement.
La liste déroulante des modèles est vide	La liste des modèles de ce fournisseur n'a pas pu être chargée, ou vous venez de changer de fournisseur sans rechargement.	Refermez puis rouvrez la liste pour relancer le chargement ; si elle reste vide, saisissez directement l'identifiant du modèle.
L'enregistrement passe, mais dès le premier message une clé manquante est signalée	Un fournisseur est sélectionné mais aucun identifiant ne se résout : ni le personnel ni l'équipe n'en possède pour ce fournisseur.	Ajoutez un identifiant pour ce fournisseur dans le centre d'identifiants, ou sélectionnez explicitement un identifiant existant dans la configuration.