Instalación y conmutación de agentes

Elija un marco de Agente para ejecutar conversaciones y herramientas. Después de instalarlo, configure un proveedor de modelos compatible. Puede mantener varios marcos instalados y cambiar el activo para un proyecto.

Lea la página del agente

Abre Settings → Agent. La página separa Installed de Available. Lea la versión, la ruta y el marcador Active en la tarjeta instalada antes de cambiar cualquier cosa.

Control/establecimiento	Significado y acción
Tarjeta instalada	Seleccione una tarjeta inactiva elegible para solicitar un interruptor. Una instalación listada todavía necesita acceso modelo compatible.
Activo	El backend seleccionado. Su acción de desinstalación está deshabilitada.
Volver a detectar	Refresca el descubrimiento después de una instalación o cambio de ruta. Muestra temporalmente la detección; no instala el software perdido.
No instalado	No se detectó tiempo de funcionamiento utilizable para ese marco.
Menú de instalación	Elija una fuente ofrecida para ese marco, luego inspeccione el progreso de la instalación.
Instalar el registro / Retry	Lea el paso fallido y vuelva a entrar después de resolver esa causa.
Reparar	Aparece cuando la instalación gestionada necesita reparación; inspeccionar el tiempo de ejecución afectado antes de confirmar.

La página inspeccionada ofrece Codex, Claude Agent, OpenCode y CodeBuddy. Las fuentes disponibles y los requisitos de autenticación difieren; no asuma cada marco ofrece el mismo método de instalación o de inicio de sesión.

Instalar y verificar

1. Seleccione Instala [framework] y revise la fuente ofrecida. Una instalación gestionada se mantiene bajo almacenamiento controlado por la aplicación; una instalación manual debe ser descubierta por la aplicación.
2. Siga el progreso y lea el registro de instalación si un paso falla. Resolver el medio ambiente/requisitos de red antes de reintentar.
3. Utilice Re-detect después de una instalación manual. Confirme la versión y el camino esperados en lugar de depender de la presencia de un comando en otro terminal.
4. Seleccione la tarjeta lista. Revise el diálogo de conmutación, luego confirme el backend deseado.
5. Chequee Settings → Model, ejecute una pequeña solicitud, e inspeccione un resultado de respuesta/herramienta real.

Para OpenCode, Install → App-managed download (recommended) descarga un tiempo de ejecución autocontenido. La página mostró Resolver, descargar el progreso, y luego una tarjeta Installed con su versión y ruta. Seleccione esa tarjeta, confirme ¿Cambiar a OpenCode? y elija un modelo compatible. El ejemplo de conexión local devolvió una respuesta completa; ver configuración del proveedor local para sus límites API y token.

Para Codex, el adaptador ACP y el tiempo de funcionamiento nativo deben pasar la detección como un par compatible. Instalar sólo un componente no es equivalente a un backend listo. La suscripción de proveedor está cubierta en Configuración del proveedor.

Actualizar un tiempo de ejecución Codex gestionado por aplicaciones

Abrir Settings → Agent y leer las versiones Codex CLI y ACP de la tarjeta Codex por separado. Si se ofrece una actualización al par probado, termine o cierre las sesiones usando ese tiempo de ejecución, elija la acción de actualización y espere a que la detección se complete. Confirme las nuevas versiones y la preparación, luego envíe una pequeña solicitud en una sesión.

Una actualización administrada por aplicaciones sustituye el tiempo de ejecución de propiedad de la aplicación; un CLI externo debe ser actualizado a través de su método de instalación original, seguido por Re-detect. La aplicación se niega a reemplazar mientras que un proceso Codex de la aplicación está utilizando el objetivo. Esta operación no actualiza el Open-Science en sí o migra una tarea en vuelo.

Interruptor sin confundir la historia retenida con el estado vivo

Terminar o detener la operación actual antes de cambiar. El interruptor crea una sesión de backend fresca y reproduce la transcripción de la conversación abierta. No transfiere un proceso de herramienta en vuelo ni reproduce cada variable de intérprete. Compruebe los archivos de la sesión, Notebook y permisos antes de continuar una computación.

Después de cambiar, compruebe el modelo seleccionado para la conversación. Las suscripciones Codex admiten Side Chat; las operaciones o la recuperación pendientes de sesión pueden impedir temporalmente la apertura. Siga el mensaje mostrado por la entrada.

Reparación y remoción

Utilice el flujo de reparación de la aplicación para un tiempo de ejecución gestionado roto; no eliminar sus directorios durante un instalador de funcionamiento. Si se muestra una instalación externa, repara esa instalación y redetectala. Para eliminar un backend gestionado, active otro backend listo primero, abra Uninstall, y lea la lista de componentes de la confirmación. La eliminación no es un paso de limpieza necesario simplemente para cambiar los modelos.

Desinstalar y reinstalar un tiempo de ejecución gestionado por la aplicación

1. Mantenga un backend diferente Active. En este ejemplo, Codex permaneció activo mientras que OpenCode fue eliminado.
2. En la tarjeta OpenCode inactiva, elija Uninstall. La confirmación se aplica a la copia descargada y gestionada por esta aplicación; una copia instalada por separado no se ve afectada.
3. Confirme Uninstall, luego elija Re-detect. OpenCode debe moverse a Available con Not installed.
4. Elige Install OpenCode → App-managed download (recommended). Espere a la tarjeta Installed, luego seleccione y confirme Switch.
5. Chequee Active, la ruta de ejecución y la selección de modelos compatibles. Reinstalar el backend no configura un proveedor de modelo para él.

Antes de eliminar un backend, cambie a otro backend disponible; el backend activo no puede ser eliminado a través de este control. Después de reinstalar, re-detectar y activarlo, luego abrir un proyecto existente y ejecutar una pequeña solicitud para comprobar la conexión.

Si las acciones de instalación son deshabilitadas, compruebe otra instalación/switch en progreso y el error previo declarado. Si la detección tiene éxito pero las solicitudes fallan, inspeccione la autenticación del modelo y compatibilidad marco/API por separado.

Fuentes: Panel de Agentes, tarjeta marco.