10. Modelos por rol

Permite que cada rol trabaje con un modelo distinto (por ejemplo, un modelo más potente para diseño y código y uno más rápido para el resto). Se abre con Modelos por rol… (menú del agente o panel Roles) y también al crear un proyecto.

• Una tabla con cada rol, su Modelo y, en los modelos que lo admiten, el Razonamiento (esfuerzo).
• Por defecto usa el modelo elegido en la barra superior y, si allí tampoco hay, el por defecto de la app.
• Proponer rellena una propuesta (Opus para diseño y código, Sonnet para el resto) con los modelos que incluye tu plan; Todo por defecto la borra.
• Con Codex, la lista de modelos se obtiene de tu cuenta.

De dónde sale el modelo de cada rol. En cada turno, la app elige el modelo en este orden y se lo pasa al agente:

1. El modelo del rol en Modelos por rol de este proyecto.
2. Si no hay, el que sugiere el equipo para ese rol (solo Claude Code).
3. Si no hay, el elegido en la barra superior del proyecto.
4. Si tampoco hay, el modelo por defecto de la app: Sonnet con Claude Code; con Codex, el que tu cuenta marca como predeterminado. En la barra superior, esta opción se llama «Por defecto de la app (Sonnet)».

Lo que tengas configurado fuera de la app en el agente (~/.claude/settings.json, variables como ANTHROPIC_MODEL o ANTHROPIC_DEFAULT_SONNET_MODEL, o ~/.codex/config.toml) no cambia el modelo de los roles, tampoco al cambiar de rol ni en «Aparte» con un rol. Si Codex no da su lista de modelos, la app usa el último que conocía y lo dice en el chat. Si el modelo elegido no está disponible en tu cuenta, la app te lo avisa (ver Modelo no disponible al usarlo); nunca usa en silencio el del agente. Los editores de roles y de equipos y «Aparte» con el modelo siguen usando su propio selector.

Modelos según tu plan (Claude Code). La app lee el plan de tu sesión de Claude Code y solo deja elegir los modelos que incluye: los demás aparecen desactivados con «(no disponible en tu plan)». Con Pro, Fable no está incluido (solo se puede usar pagando créditos de uso); con Max están todos; con una sesión que factura por API, también. Esto vale en el editor de modelos por rol, en el modelo para generar la documentación al adoptar un proyecto y en el modelo para escribir la entrega al cambiar de equipo.

• Alternativa. Si el modelo que tocaba no está en tu plan, se propone el más parecido que sí lo está (primero uno menos potente, en el orden Fable, Opus, Sonnet, Haiku) y la app lo dice: «Opus no está disponible en tu plan; «Tech Lead» usará Sonnet.» Puedes cambiarlo. Lo mismo pasa con el modelo que sugiere el equipo para un rol: al enviar el mensaje se usa la alternativa.
• Plan desconocido. Si la app no puede saber qué modelos incluye tu plan (sin sesión iniciada, o con un plan que no conoce, como Team o Enterprise), lo avisa y puedes elegir cualquier modelo.
• Modelo no disponible al usarlo. Si Claude Code rechaza un modelo porque tu cuenta no lo permite, el chat muestra «“{rol}” no puede usar {modelo} con tu plan.» con Usar {alternativa} (cambia el modelo de ese rol) y Elegir otro… (abre los modelos por rol). El mensaje no se reenvía solo: envíalo de nuevo. Desde ese momento, y hasta cerrar la app, ese modelo aparece como no disponible.

Al pasar de un rol a otro, el agente cambia al modelo de ese rol dentro de la misma conversación. Cambiar de modelo reprocesa la conversación en el primer turno, así que ahorra más cuando un rol trabaja varios turnos seguidos y en chats cortos.

Un agente distinto por rol

Si tienes Claude Code y Codex instalados, cada rol puede trabajar con uno u otro dentro del mismo proyecto: por ejemplo, el Product Owner con Claude Code y el Full Stack Developer con Codex. Con un solo agente instalado no cambia nada: el editor y el chat se ven como siempre.

• Dónde se elige. En Modelos por rol… (menú del agente o panel Roles), que pasa a llamarse Agente y modelo de cada rol. La tabla gana la columna Agente con tres opciones: Proyecto (por defecto: el agente del chat), Claude Code y Codex. El modelo y el razonamiento de cada fila son los de su agente; el razonamiento solo existe en Codex («—» en Claude Code). Cambiar el agente de un rol no borra el modelo que tenía con el otro: vuelve al elegirlo de nuevo. Proponer solo cambia las filas de Claude Code y Todo por defecto devuelve también los agentes a «Proyecto». Este editor, abierto desde el chat, es el único sitio donde se elige: al crear o adoptar un proyecto sigue habiendo pestañas por agente, sin columna Agente.
• Qué se ve en el chat. El botón del agente en la barra, la sesión de al lado y la línea del paso actual del panel Flujo muestran el agente del rol activo y cambian al cambiar de rol.
• Al pasar a un rol con otro agente. Una sesión no puede pasar de un agente a otro, así que el chat deja una nota: «Ahora trabaja Codex (Full Stack Developer). Empieza una sesión nueva que parte de los documentos del sprint; no ve la conversación anterior.» Si ese agente ya tenía una sesión en el chat, la nota es «Vuelve {agente} ({rol}). Retoma su sesión anterior, que no vio lo ocurrido desde entonces…». El agente que entra recibe, sin que se vea en el chat, el estado del flujo, el último mensaje del rol anterior y la lista de documentos del sprint. Lo que se dijo en el chat y no quedó escrito en un documento no le llega.
• Si el agente asignado no está disponible (no instalado, sin la sesión iniciada o sin licencia para él), el turno lo responde el agente del proyecto y el chat lo dice: «Codex no tiene la sesión iniciada. Este turno de Full Stack Developer lo responde Claude Code.» La misma frase aparece en la fila del editor. No se bloquea nada.
• Skills. Si las skills de un rol no están instaladas para el agente que le asignas, el editor y la nota del cambio de agente lo avisan («Las skills de «{rol}» no están instaladas para Codex. Puedes seguir; el rol trabajará sin ellas.»). No impide enviar.
• Detener, permisos y preguntas van siempre al agente que tiene el turno.
• Modelo del proyecto. El modelo elegido en la barra superior solo vale para el agente del chat; los roles con el otro agente usan su modelo por rol o, si no tienen, el por defecto de la app para ese agente.
• El chat «Aparte» y los editores de roles y de equipos siguen con su propio agente. Sin la función Modelos por rol de la licencia, la columna Agente se ve pero no se puede cambiar.