Agentes

El panel Agentes decide qué agentes de codificación están disponibles en un espacio de trabajo y cómo inicia sesión cada uno. Bromure Agentic Coding incluye tres agentes — Claude Code, Codex y Grok Build — y se puede habilitar cualquier subconjunto por espacio de trabajo. El subtítulo del panel expone el modelo con claridad: habilita cada agente que quieras tener disponible en este espacio de trabajo; el que esté marcado como Principal se inicia automáticamente en la primera pestaña, y los demás agentes habilitados quedan instalados y autenticados pero los ejecutas cuando lo necesites desde una nueva pestaña.

Cualquier credencial que introduzcas aquí nunca llega a la VM. Al agente que está dentro del sandbox se le entrega una clave señuelo; el proxy del anfitrión intercambia el señuelo por el valor real en la red. Ese límite de red — y la maquinaria de registro de suscripciones e intercambio de tokens de la que dependen los modos de autenticación siguientes — es el tema del capítulo Credenciales.

El panel Agentes de la ventana Editar espacio de trabajo: la tarjeta de Claude Code está habilitada y marcada como Principal, mostrando las opciones de autenticación con token de API, Suscripción, Bedrock y Modelo local, con Codex y Grok Build contraídos debajo

Habilitar agentes y elegir el principal

Cada agente es una tarjeta con un interruptor de habilitación en su esquina superior derecha. Actívalo para revelar las opciones de autenticación de ese agente; desactívalo para contraer la tarjeta y quitar el agente del espacio de trabajo.

Un agente habilitado es siempre el Principal, marcado con una insignia de estrella naranja. El principal se inicia automáticamente en la primera pestaña de terminal cuando se abre una sesión; los demás agentes habilitados quedan instalados y autenticados, pero esperan hasta que los inicies desde una nueva pestaña. Para promover a otro agente, habilítalo y haz clic en Hacer principal en su tarjeta — el principal anterior queda degradado pero conserva su propia autenticación. Al deshabilitar el principal actual se promueve automáticamente otro agente habilitado, y el último agente que quede no se puede deshabilitar: un espacio de trabajo siempre tiene al menos uno.

Modos de autenticación

Cuando un agente está habilitado, un grupo de botones de opción selecciona cómo se autentica. Los modos que se ofrecen dependen del agente — Bedrock es exclusivo de Claude Code:

ModoClaude CodeCodexGrok Build
Token de API
Suscripción (inicio de sesión interactivo)
Bedrock (AWS)
Modelo local

Token de API

Pega una clave de API del proveedor en el campo seguro — su texto de marcador de posición nombra al proveedor: Anthropic API key, OpenAI API key o xAI API key. La clave se almacena en el anfitrión, cifrada; la VM solo ve un señuelo que el proxy reescribe al valor real en las solicitudes destinadas a ese proveedor. Una casilla Requerir aprobación para su uso (desactivada de forma predeterminada) se describe en Requerir aprobación para su uso más abajo.

Los agentes recién habilitados usan este modo de forma predeterminada.

Suscripción (inicio de sesión interactivo)

Inicia sesión con el agente usando tu suscripción de pago (Claude, ChatGPT/Codex o Grok) en lugar de una clave de API. Un botón Registrar… en línea ejecuta un flujo de inicio de sesión interactivo único; una vez completado, aparece un sello verde junto al modo, junto con los controles Volver a registrar… y Olvidar. Los tokens OAuth reales permanecen en el anfitrión y se renuevan allí mientras a la VM se le sirven señuelos — si ese intercambio está activo actualmente se muestra, y se puede restablecer, en el panel Trazado.

Este es el valor predeterminado de la plantilla de fábrica para Claude Code.

Bedrock (AWS) — solo Claude Code

Enruta Claude Code a través de Amazon Bedrock usando las credenciales de AWS que configures en Credenciales → AWS. Un campo ID de modelo predeterminado anula el modelo de Bedrock que solicita Claude Code — por ejemplo us.anthropic.claude-sonnet-4-6-v1:0; déjalo vacío para usar el valor predeterminado integrado de Claude Code. Bedrock no se ofrece para Codex ni Grok Build.

Modelo local

Ejecuta el agente por completo contra un modelo en el dispositivo servido por el anfitrión, sin ningún proveedor en la nube involucrado. La opción aparece atenuada — etiquetada como — descarga un modelo en Modelos locales — hasta que al menos un modelo esté instalado en el panel Modelos locales. Una vez que hay un modelo disponible, el agente se dirige al motor local a través de su variable de entorno de URL base (ANTHROPIC_BASE_URL, OPENAI_BASE_URL o XAI_BASE_URL) y sirve el modelo seleccionado en Modelos locales. El motor, el enrutamiento en el dispositivo y el respaldo híbrido se tratan en el capítulo Modelos locales.

Nota: Activar Habilitar modelos locales para el espacio de trabajo fija automáticamente todos los agentes habilitados en Modelo local, y volver a desactivarlo restaura el modo anterior de cada agente. Normalmente configuras la inferencia en el dispositivo desde el panel Modelos locales en lugar de agente por agente.

Requerir aprobación para su uso

En el modo Token de API, la casilla Requerir aprobación para su uso añade una barrera de consentimiento: antes de que el proxy intercambie la clave señuelo por la real, el anfitrión muestra un cuadro de diálogo para que permitas el uso una vez, durante un breve intervalo o para el resto de la sesión. Está desactivada de forma predeterminada. El mismo patrón de aprobación por credencial se repite a lo largo del panel Credenciales.

Referencia de configuración

AjusteDescripción
Habilitar (por agente)Hace que el agente esté disponible en este espacio de trabajo. Predeterminado: Claude Code activado y principal; Codex y Grok Build desactivados.
Principal / Hacer principalMarca el agente que se inicia automáticamente en la primera pestaña. Predeterminado: Claude Code. El último agente habilitado no se puede desactivar.
Modo de autenticaciónBotón de opción: Token de API / Suscripción (inicio de sesión interactivo) / Bedrock (AWS) (solo Claude Code) / Modelo local (necesita un modelo local instalado). Predeterminado: Suscripción (inicio de sesión interactivo) para Claude Code en la plantilla de fábrica; los agentes recién habilitados usan Token de API de forma predeterminada.
Clave de APICampo seguro para la clave del proveedor en modo token (ANTHROPIC_API_KEY / OPENAI_API_KEY / XAI_API_KEY). Se inyecta en la VM como señuelo; se intercambia en la red. Predeterminado: vacío.
Requerir aprobación para su usoCasilla (modo token). Cuadro de diálogo de consentimiento antes de cada intercambio de clave señuelo→real. Predeterminado: desactivada.
ID de modelo predeterminadoSolo modo Bedrock. Anula el id de modelo de Bedrock, p. ej. us.anthropic.claude-sonnet-4-6-v1:0. Predeterminado: vacío (valor predeterminado integrado del agente).
Registrar… / Volver a registrar… / OlvidarSolo modo Suscripción. Ejecuta o borra el registro de inicio de sesión interactivo. Predeterminado: no registrado.

Capítulos relacionados

  • Credenciales — cómo se conservan las claves, los tokens de suscripción y las credenciales de AWS en el anfitrión y se intercambian de señuelo a real en la red.
  • Modelos locales — el motor en el dispositivo que respalda el modo de autenticación Modelo local.
  • Fusion — el panel multimodelo obtiene sus vías a partir de los agentes que configuras aquí.
  • Trazado — las filas de estado de intercambio de tokens de suscripción para los modos Suscripción.