Entorno
El panel Entorno define variables de entorno simples exportadas a todos los shells de la VM de la máquina (una máquina es un espacio de trabajo, en el editor de ajustes). Son para ajustes no secretos — niveles de registro, banderas de funcionalidad, interruptores de compilación — que quieres en el entorno del agente sin ningún manejo de credenciales.
El pie dice qué hace el panel y para qué no sirve: "Pares KEY=VALUE simples exportados a todos los shells de la VM mediante proxy.env (cargado desde .bashrc). Sin sustitución por el proxy — los valores llegan a la VM tal cual, así que no pongas secretos aquí. Bueno para niveles de registro, banderas de funcionalidad, interruptores de compilación." Sin nada configurado, dice No hay variables de entorno configuradas.
Cómo se exportan las variables
Cada variable se escribe en proxy.env, que el .bashrc gestionado de la máquina carga para todos los shells. El valor está presente en todos los terminales, en todos los comandos que el agente ejecuta, y en todos los shells de inicio de sesión y de no inicio de sesión, exactamente como lo escribiste. No hay ningún suplente ni cambio en el cable.
Para un token o una contraseña, usa en su lugar el panel Credenciales: ahí la VM solo recibe un sustituto, y el valor real se pone en el cable. Un secreto escrito en este panel llega dentro de la VM en texto claro.
Añadir y editar variables
Añadir variable añade una fila con un campo de nombre y un campo de valor; el botón menos la quita. El nombre debe ser un identificador de shell válido — una letra o un guion bajo, luego letras, dígitos y guiones bajos. Un nombre que no cumpla muestra un aviso naranja y no se exporta. El valor se usa tal como está escrito.
Cambios en una máquina en marcha
Guardar se aplica sin reinicio: proxy.env se reescribe, y los shells abiertos después de guardar ven los nuevos valores. Un agente que ya está en marcha conserva el entorno con el que arrancó; una pestaña nueva o una sesión nueva recoge el cambio.
Los valores se guardan en el secrets.enc cifrado de la máquina, como los demás datos del panel, no en profile.json.
Referencia de ajustes
| Ajuste | Tipo | Por omisión | Descripción |
|---|---|---|---|
| Lista de variables | Filas nombre / valor | Vacía | Cada fila exporta una variable a todos los shells mediante proxy.env. Los nombres inválidos muestran un aviso y se omiten. Los valores se usan tal cual. |
| Añadir variable | Botón | — | Añade una fila vacía. |
Capítulos relacionados
- Credenciales — donde pertenecen los secretos.
- MCP — servidores MCP, algunos de los cuales leen variables de entorno.
- Referencia de ajustes — todos los paneles de un vistazo.