Inicio rápido

Este capítulo te guía a través de tu primera sesión completa con Bromure Agentic Coding: crear un espacio de trabajo, elegir un agente y su forma de autenticación, compartir una carpeta de proyecto en el entorno aislado, ejecutar una primera tarea, inspeccionar lo que el agente envió a través de la red y cerrar la sesión para poder retomarla más tarde. Reserva unos diez minutos.

El recorrido usa deliberadamente los valores predeterminados siempre que puede. Cada ajuste que toques aquí tiene una referencia completa más adelante en el manual; los enlaces se proporcionan a lo largo del camino y se recopilan en Dónde ir a continuación.

Antes de empezar

Necesitas:

• Bromure Agentic Coding instalado y ejecutado al menos una vez, con la imagen base del sistema operativo lista; consulta Instalación. (Se requiere un Mac con Apple Silicon que ejecute macOS 14 o posterior.)
• Una forma de autenticar el agente de programación. Para Claude Code —el agente predeterminado— eso es una clave de API de Anthropic o una suscripción de Claude a la que puedas iniciar sesión. Ambas rutas se cubren en el paso 4 más abajo.
• Opcionalmente, una carpeta de proyecto en tu Mac en la que quieras que trabaje el agente. Un repositorio git pequeño es la mejor primera prueba, pero cualquier carpeta funciona.

Una idea para tener presente antes de empezar: el agente se ejecuta dentro de una VM de Ubuntu desechable, y tus credenciales reales nunca entran en esa VM. La VM solo contiene tokens ficticios de marcador de posición; un proxy del lado del anfitrión los intercambia por los valores reales en el momento en que una solicitud sale de tu Mac. Este es el límite de red, y es la razón por la que el recorrido te pide que pegues una clave de API en la app en lugar de en el terminal.

Crea tu primer espacio de trabajo

Un espacio de trabajo es la unidad de aislamiento: una VM de Ubuntu con su propio disco de sistema, su propia carpeta personal persistente, sus propios agentes, credenciales y políticas de seguridad. Puedes crear tantos como quieras; este recorrido crea uno.

1. Abre la ventana principal. La barra lateral izquierda tiene el encabezado ESPACIOS DE TRABAJO; en su parte inferior hay un botón circular negro + (información sobre herramientas: Nuevo espacio de trabajo). Haz clic en él.

2. Se abre un editor de ajustes en una ventana titulada Nuevo espacio de trabajo, precargado desde tu plantilla de preferencias y llamado "Espacio de trabajo predeterminado" (numerado automáticamente si ese nombre ya está en uso). Se muestra el panel General. Escribe un nombre propio, por ejemplo My First Project. El nombre es el único campo obligatorio; todo lo demás en este recorrido es un retoque opcional. Si quieres, elige un Color: tiñe el mosaico del espacio de trabajo en la barra lateral.

No hagas clic en Crear todavía; conviene visitar antes dos paneles.

Elige un agente y la autenticación

3. Haz clic en Agentes en la barra lateral de categorías del editor. El panel muestra una tarjeta por cada agente compatible —Claude Code, Codex y Grok Build— cada una con un interruptor de activación. Claude Code está activado y lleva la etiqueta naranja Principal de fábrica: el agente principal es el que se inicia automáticamente en la primera pestaña de la sesión. Otros agentes activados también se instalan y autentican, pero los inicias tú mismo desde una pestaña nueva.

Dentro de la tarjeta de Claude Code ves cuatro modos de autenticación: Token de API, Suscripción (inicio de sesión interactivo) con un enlace Registrar…, Bedrock (AWS) y Modelo local (atenuado con "— descarga un modelo en Modelos locales" hasta que se instala un modelo local). Elige uno de los dos primeros:

4. Si tienes una clave de API de Anthropic: selecciona Token de API y pega la clave en el campo Clave de API de Anthropic. La clave se almacena cifrada en el anfitrión; la VM solo recibe una versión ficticia que preserva la estructura, y el proxy sustituye la clave real en las solicitudes a Anthropic, en ningún otro lugar. Deja desactivada la casilla Requerir aprobación para usar por ahora; activarla haría que la app pidiera tu consentimiento la primera vez que cada sesión usara la clave (consulta Credenciales).

5. Si tienes una suscripción de Claude: selecciona Suscripción (inicio de sesión interactivo) —el valor predeterminado de fábrica— y haz clic en Registrar…. Bromure arranca una VM temporal y desechable sin acceso a tus carpetas ni credenciales, ejecuta el inicio de sesión real de Claude dentro de ella y abre la página de inicio de sesión del proveedor en el navegador predeterminado de tu Mac. Inicia sesión ahí; tienes unos minutos antes de que el flujo caduque. Si tiene éxito, los tokens capturados se almacenan cifrados en el anfitrión, la VM desechable se destruye y la app pregunta si compartir el registro con Todos los espacios de trabajo o Solo este espacio de trabajo. Una vez registrado, la tarjeta muestra un sello verde junto con los controles Volver a registrar… y Olvidar. Tus VM de espacio de trabajo nunca realizan OAuth por sí mismas ni contienen los tokens reales: el anfitrión los inyecta en la red y gestiona la renovación.

6. Eso es todo lo que el panel de Agentes necesita para una primera sesión. (Activar Codex o Grok Build junto a él funciona de la misma manera —cada tarjeta obtiene su propio modo de autenticación— pero un solo agente es suficiente por hoy.)

Comparte una carpeta de proyecto

7. Haz clic en Carpetas en la barra lateral de categorías. Este panel enumera las carpetas del anfitrión que se montarán en la VM. Como dice el pie de texto, cada carpeta se monta bajo su nombre real —por ejemplo, ~/Documents en tu Mac aparece como ~ubuntu/Documents en la VM— y un espacio de trabajo tiene un límite de 8 carpetas. Un espacio de trabajo recién creado muestra "No hay carpetas compartidas".

8. Haz clic en Añadir carpeta… y elige tu carpeta de proyecto en el selector de directorios. Aparece en la lista con su ruta completa del anfitrión (elimínala más tarde con el botón menos si cambias de opinión). Dentro de la VM estará activa en /home/ubuntu/<basename> —los mismos archivos, no una copia— por lo que los cambios que haga el agente están en tu Mac al instante.

Nota: Compartir una carpeta es opcional. Todo lo que está bajo /home/ubuntu de la VM es persistente por espacio de trabajo, así que también puedes clonar un repositorio dentro de la VM y mantener el entorno aislado completamente separado del sistema de archivos de tu Mac. Eliminar un espacio de trabajo nunca afecta a las carpetas compartidas del anfitrión.

9. Haz clic en Crear. El editor se cierra y tu espacio de trabajo aparece en la barra lateral con la etiqueta de estado Apagado.

Inicia la sesión

10. Haz clic en la fila del espacio de trabajo en la barra lateral. El escenario de la derecha muestra el panel de control del espacio de trabajo: una etiqueta Apagado bajo el nombre, tarjetas de CPU, Memoria, vCPU, Disco y Tiempo de actividad (en su mayoría guiones y ceros antes del primer inicio; el disco se crea en el primer arranque), un resumen de CONFIGURACIÓN que enumera tu agente y modo de autenticación, los estados de las Salvaguardas y del análisis de inyección de prompts, y tus carpetas compartidas. Haz clic en el botón Iniciar en la parte superior derecha.

11. En el primer inicio, Bromure crea el disco de sistema privado del espacio de trabajo como un clon de copia sobre escritura de la imagen base compartida —esto es instantáneo y casi no ocupa espacio en disco— y arranca la VM con 4 vCPU y la RAM que se muestra en el panel de control (dimensionada según tu Mac de forma predeterminada: 4, 6 u 8 GB). Mientras la VM arranca, una superposición animada con el nombre del espacio de trabajo y una barra de progreso cubre el panel; se desvanece en el momento en que aparece el primer terminal del invitado, normalmente en cuestión de segundos. Si no aparece ningún terminal en 30 segundos, la superposición cambia a un panel de DIVE FAILED con los botones Keep Waiting y Reset Base Image…; consulta Solución de problemas si eso ocurre.

12. Cuando el arranque se completa, estás mirando un terminal en el escenario, y el agente principal —Claude Code— ya se está ejecutando en él, listo para un prompt. Nunca ejecutas claude login dentro de la VM; la autenticación se gestionó en el límite de red. En la barra lateral, el punto de estado del espacio de trabajo ahora es verde, la etiqueta de estado indica En ejecución, y su primera pestaña (etiquetada con el programa en primer plano, p. ej. claude) queda anidada bajo la fila del espacio de trabajo junto con un nodo de Docker. La barra de herramientas de la ventana muestra ahora un grupo de controles para esta VM: su dirección IP como una etiqueta de clic para copiar, y botones para explorar archivos, reiniciar, inspeccionar la traza, editar el espacio de trabajo, sacar la sesión a su propia ventana y alternar los paneles del navegador y de archivos del repositorio.

Ejecuta tu primera tarea

13. Escribe una tarea en el prompt de Claude Code, haciendo referencia a la carpeta compartida por su ruta dentro de la VM. Por ejemplo:

    Read the code in ~/my-project and summarize what it does.
    Then add a README.md with build instructions.
    

    Observa el punto de estado en el icono de la pestaña en la barra lateral: parpadea en naranja mientras el agente trabaja, se vuelve verde cuando el agente termina, y se vuelve rojo cuando el agente necesita tu intervención.

14. Como la carpeta compartida es un montaje en vivo, el README.md que escribe el agente está inmediatamente en tu Mac; compruébalo en Finder si quieres. Si tu carpeta es un repositorio git, el panel del explorador de archivos del repositorio se abre automáticamente cuando el directorio de trabajo de la pestaña activa entra en el repositorio, mostrando un árbol al estilo de un IDE con el estado de git y las diferencias por archivo; también puedes alternarlo en cualquier momento con ⌃⌘E. Pulsa ⌘T para una pestaña de shell simple adicional junto al agente; cada pestaña es una ventana de la misma sesión tmux dentro de la VM.

15. Cualquier otra cosa que haga el agente —apt install, npm install, escribir archivos desechables en la carpeta personal de la VM— permanece dentro del entorno aislado. El disco de sistema y la carpeta personal persisten entre sesiones, y ambos pueden restablecerse de forma independiente más tarde (Espacios de trabajo).

Inspecciona la traza

16. Pulsa ⇧⌘I (o haz clic en el botón Inspeccionar traza de la barra de herramientas) para abrir el Inspector de trazas. Los nuevos espacios de trabajo registran al nivel de Detalles de solicitud de IA: cada solicitud de red que hizo el agente se enumera con anfitrión, estado y latencia, y para anfitriones LLM conocidos también se capturan los cuerpos completos de la solicitud y la respuesta. Selecciona una de las solicitudes a Anthropic y el inspector la representa como una conversación: encabezado de proveedor y modelo con recuentos de tokens, el prompt del sistema y los mensajes del usuario, del asistente y de herramientas como burbujas de chat.

17. Dos cosas dignas de mención en tu primera traza. Primero, el informe de intercambio: el token de API ficticio que contiene la VM se intercambió por tu credencial real en la red, exactamente una vez por solicitud, limitado al anfitrión del proveedor. Segundo, todo lo capturado permanece en tu Mac, cifrado en reposo. Los niveles de traza, los límites de retención y las advertencias de fugas se cubren en Trazado.

Cierra y reanuda

18. Cierra la sesión: pasa el cursor sobre la fila del espacio de trabajo en la barra lateral y haz clic en su botón × (o pulsa ⌘W en su última pestaña). Los nuevos espacios de trabajo tienen su acción de cierre configurada en Preguntar, así que aparece un aviso —"¿Cerrar «My First Project»?"— con los botones Ejecutar en segundo plano, Suspender, Apagar y Cancelar, y la explicación: "Ejecutar en segundo plano mantiene la VM en ejecución para que puedas reconectarte más tarde. Suspender guarda su estado en disco. Apagar la apaga por completo."

19. Haz clic en Suspender. Se toma una instantánea de la RAM de la VM en disco y la etiqueta de estado de la fila de la barra lateral cambia a Suspendido. No se pierde nada: ni la conversación del agente, ni el historial de tu shell, ni la disposición de las pestañas.

20. Reanuda: haz clic en el espacio de trabajo y pulsa Reanudar en su panel de control (o usa el menú ⋯ de la fila → Reanudar). La sesión se restaura casi al instante, exactamente donde la dejaste: los mismos terminales, con Claude Code a mitad de la conversación.

21. Si siempre quieres el mismo comportamiento al cerrar, abre el menú ⋯ de la fila → Editar… y establece Al cerrar la ventana en el panel General en Suspender (o Ejecutar en segundo plano / Apagar) para que el aviso nunca aparezca. Consulta Ajustes — General.

Consejo: Un espacio de trabajo suspendido o apagado conserva su disco de sistema y su carpeta personal. Destruir datos es siempre un acto explícito —Restablecer disco, Borrar carpeta personal… o Eliminar espacio de trabajo— e incluso eliminar un espacio de trabajo nunca afecta a las carpetas del anfitrión que compartiste en él.

Dónde ir a continuación

• Conceptos — el modelo mental detrás de lo que acabas de hacer: los espacios de trabajo, el ciclo de vida de la VM, el límite de red y cómo encajan las piezas.
• Espacios de trabajo — duplicar, restablecer y eliminar espacios de trabajo; capas de almacenamiento, puntos de control y la plantilla de preferencias de la que se deriva cada nuevo espacio de trabajo.
• Sesiones — pestañas y worktrees de Git, la cuadrícula de terminales, el panel del navegador agéntico, la transferencia de archivos hacia y desde la VM, y todos los atajos de teclado.
• Referencia de ajustes — cada panel de ajustes, una página cada uno, incluidos Agentes y Carpetas de este recorrido.
• Credenciales — el catálogo completo de credenciales (tokens de git, claves SSH, AWS, Kubernetes, registros de contenedores, bases de datos y más), los avisos de aprobación y cómo funciona en detalle el intercambio de ficticio a real.
• Trazado — los niveles de traza, el Inspector de trazas y la detección de fugas.
• Cadena de suministro e Inyección de prompts — las protecciones que puedes añadir a un espacio de trabajo antes de apuntar un agente hacia código no confiable.
• Fusion y Modelos locales — responder a los prompts con varios modelos a la vez, y ejecutar modelos en tu Mac en lugar de en la nube.
• Automatización y CLI — controlar espacios de trabajo desde scripts, la API HTTP y el servidor bromure-cli mcp.