Configuration

Environment variables

Variables de entorno soportadas y cómo se relacionan con el archivo de configuración.

Cuándo conviene usar variables de entorno

Para probar una credencial rápido sin guardarla en el archivo de configuración, o en entornos como CI donde preferís inyectar secretos por variable de entorno en vez de escribir un config.toml en disco.

Variables soportadas

export DEEPSEEK_API_KEY="tu-api-key"
export GEMINI_API_KEY="tu-api-key"
export YOUTUBE_COMMENTS="tu-api-key"

Una variable de entorno definida en la sesión actual se pierde al cerrar la terminal, salvo que la agregues a tu ~/.bashrc, ~/.zshrc o equivalente.

Precedencia

Cuando la misma credencial está definida tanto por variable de entorno como en config.toml, la variable de entorno tiene prioridad – pensada como una forma de sobreescribir puntualmente sin tocar el archivo guardado.

Por separado, una bandera explícita en la línea de comandos (como --proveedor o --model en run/generar) siempre gana sobre cualquiera de las dos fuentes de configuración, para esa corrida puntual, sin modificar nada persistente.

Ver también

Configuration reference para la lista completa de claves de config.toml, incluidas las que no tienen variable de entorno equivalente (como las de Cloudflare Workers AI, que requieren ogacai config set).