Entorno

El panel Entorno define variables de entorno sencillas que se exportan a cada shell de la VM del espacio de trabajo. Se trata de perillas de configuración no secretas — niveles de registro, feature flags, conmutadores de compilación — que quieres tener presentes en el entorno del agente sin cablear ninguna maquinaria de sustitución ni de credenciales.

El pie del panel indica tanto lo que hace como aquello para lo que no sirve: Pares sencillos KEY=VALUE exportados a cada shell de la VM mediante proxy.env (cargados desde .bashrc). Sin sustitución de proxy — los valores llegan a la VM tal cual, así que no pongas secretos aquí. Ideal para niveles de registro, feature flags y conmutadores de compilación. Sin nada configurado se lee No hay variables de entorno configuradas.

Cómo se exportan las variables

Cada variable que añades se escribe en proxy.env, un archivo del recurso compartido de metadatos del espacio de trabajo que el .bashrc gestionado carga para cada shell. Eso significa que el valor está presente en cada pestaña de terminal, en cada comando que ejecuta el agente y en cada shell de inicio de sesión o sin inicio de sesión — tal cual, exactamente como lo escribiste. No hay ningún señuelo brm_… ni intercambio en la red: este panel es un traspaso directo, que es precisamente la razón por la que los secretos no pertenecen aquí.

Si necesitas que la VM contenga un token o una contraseña, usa el panel Credenciales en su lugar. Todo lo que se defina allí se inyecta como un señuelo y se intercambia por el valor real en la red; un secreto escrito en el panel Entorno, en cambio, llegaría al interior del sandbox en texto claro.

Añadir y editar variables

Haz clic en Añadir variable para agregar una fila. Cada fila es un campo Nombre y un campo Valor, con un botón de menos para eliminarla.

El nombre se valida contra la regla de identificadores de shell [A-Za-z_][A-Za-z0-9_]* — debe empezar por una letra o un guion bajo y contener solo letras, dígitos y guiones bajos. Un nombre que no coincida muestra una advertencia naranja en línea y no se exporta. El valor no tiene restricciones y se usa exactamente como se escribe.

Consejo: Agrupa los conmutadores relacionados en un mismo espacio de trabajo y deja un espacio de trabajo de pruebas vacío. Como estas variables son por espacio de trabajo, un espacio de trabajo ajustado para depuración detallada (RUST_LOG=debug, NODE_ENV=development) se mantiene separado de otro configurado para una compilación limpia similar a producción.

Actualización en vivo en una sesión en ejecución

Editar este panel y guardar no requiere reiniciar la VM. Bromure Agentic Coding incrementa un contador interno env.generation y reescribe proxy.env; los nuevos shells que se abran después de guardar lo vuelven a cargar y ven los valores actualizados de inmediato. Un agente en primer plano que ya se está ejecutando conserva el entorno con el que empezó hasta que finaliza — un nuevo prompt (o una nueva pestaña) recoge el cambio.

Aunque estos valores son no secretos por intención, al guardar se almacenan igualmente en el blob cifrado secrets.enc del espacio de trabajo, junto con los demás datos del panel, en lugar de en el profile.json de texto plano.

Referencia de configuración

Capítulos relacionados

• Credenciales — donde pertenecen los secretos; se inyectan como señuelos y se intercambian en la red.
• MCP — configuración de servidores de herramientas, algunos de los cuales leen variables de entorno.
• Referencia de configuración — todos los paneles de un vistazo.