Clave de API y variables de entorno
En esta página
Lección actualizada el 2 de noviembre de 2026 según Claves de API y perfiles: la clave introducida durante la instalación se guarda en el llavero del sistema (el archivo
~/.vibe/.enves solo una alternativa), el inicio de sesión mediante navegador se ofrece por defecto, y/statuso/whoamiindican la fuente utilizada. Fuente: Claves de API y perfiles.
Obtén tu clave de API de Mistral
Para usar Vibe, necesitas una clave de API de Mistral. Esta clave autentica tus peticiones y permite que Vibe se comunique con los modelos de Mistral. Sin ella, la herramienta se instala y arranca, pero no es posible generar nada. Creas la clave en la Consola de Mistral en seis pasos:
- Ve a console.mistral.ai
- Crea una cuenta o inicia sesión
- Navega hasta la sección API Keys
- Haz clic en Create new key
- Asígnale un nombre descriptivo (por ejemplo, “vibe-cli-dev”)
- Copia la clave inmediatamente; no volverá a mostrarse
Ese último punto no es un mero trámite: la clave solo es visible una vez. Si cierras la pestaña demasiado pronto, tendrás que generar una nueva. La clave sigue el formato sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx y debe permanecer confidencial. Cualquiera que la tenga puede usar tu cuota de API y, por tanto, gastar tu presupuesto.
Tres métodos de configuración
Vibe acepta tres formas de proporcionar esta clave. Tu elección depende enteramente de tu contexto de trabajo.
Método 1: Configuración interactiva
Este es el método por defecto en el primer lanzamiento y el más sencillo para una estación de trabajo personal. Vibe te pide la clave directamente y la guarda:
vibe
# → "Por favor, introduce tu clave de API de Mistral:"
# Pega tu clave, pulsa Intro
La clave se almacena en tu llavero del sistema (Llavero de macOS, Administrador de credenciales de Windows…). Si no hay ningún llavero disponible, recurre al archivo ~/.vibe/.env, que solo es legible por ti. Ten en cuenta que, en el primer lanzamiento, iniciar sesión a través de tu navegador con tu cuenta de Mistral suele eliminar por completo la necesidad de una clave. Para ver qué fuente está usando realmente Vibe, escribe /status o /whoami durante una sesión.
# Si la clave está en el archivo .env (no hay llavero disponible)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...
Método 2: Variable de entorno
En cuanto sales del entorno de la estación de trabajo personal, como en una tubería CI/CD, un script automatizado o un servidor compartido, una variable de entorno resulta preferible porque no escribe nada en el disco:
export MISTRAL_API_KEY="sk-your-key-here"
Para hacerla persistente en tu máquina, añade esta línea a tu archivo de configuración del intérprete de comandos:
# En ~/.bashrc, ~/.zshrc o ~/.profile
export MISTRAL_API_KEY="sk-your-key-here"
La variable de entorno tiene prioridad sobre el archivo .env. Esto habilita un patrón de uso muy práctico: cambiar de clave temporalmente sin realizar cambios permanentes. Puedes trabajar con tu clave de desarrollo y luego anteponer una clave diferente a un único comando para una operación sensible:
# Clave de desarrollo
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"
# Clave de producción (temporal)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"
Método 3: Archivo config.toml
Por último, puedes hacer referencia a la variable de entorno en el archivo de configuración TOML de Vibe:
# ~/.vibe/config.toml
api_key_env_var = "MISTRAL_API_KEY"
Ten en cuenta que este parámetro no contiene la clave en sí, solo el nombre de la variable que debe leerse. Esta indirección tiene sentido cuando se trabaja con varios proveedores, cada uno con su propia variable: api_key_env_var le indica a Vibe cuál usar para la clave por defecto.
Orden de prioridad
Cuando varios métodos están configurados simultáneamente, Vibe aplica este orden:
- Variable de entorno
MISTRAL_API_KEY(si está definida en el intérprete de comandos) - Archivo
.enven~/.vibe/.env - Llavero del sistema, donde el asistente de configuración guarda la clave
Para un proveedor personalizado, api_key_env_var en config.toml simplemente designa la variable que debe leerse, siguiendo el mismo orden.
Recuerda la primera línea anterior: si una petición falla en la autenticación aunque tu .env contenga una clave válida, comprueba primero si hay alguna variable antigua residendo en tu intérprete de comandos y anulándola.
Seguridad de la clave de API
La primera regla es nunca confirmar tu clave en un repositorio de Git. Añade .env a tu .gitignore antes incluso de crear el archivo. Un secreto subido a un repositorio público se considera comprometido, aunque borres la confirmación más tarde. Por la misma lógica, no compartas tu clave en texto plano en un mensaje o documento. Si sospechas de una fuga, regenérala inmediatamente.
A nivel organizativo, usa claves separadas para desarrollo y producción. Si una se filtra, puedes revocarla sin interrumpir la otra. Por último, establece límites de gasto en la Consola de Mistral. Esta es la red de seguridad más eficaz contra un script en bucle o una clave expuesta: la facturación se detiene automáticamente.
Verifica que la clave funciona
Tras la configuración, no des nada por sentado. Prueba con una petición mínima:
vibe "Say hello"
Si la clave es válida, Vibe responde con normalidad. Si no lo es o ha caducado, obtendrás un error de autenticación claro, lo que te ahorrará buscar la causa en la instalación.
Si configuras proveedores adicionales como OpenRouter, cada uno necesita su propia variable. Ambos coexisten sin problemas:
export MISTRAL_API_KEY="sk-mistral-xxxx"
export OPENROUTER_API_KEY="sk-or-xxxx"
Cubriremos la configuración de proveedores de terceros en detalle en la lección dedicada.
Puntos clave
- Obtén tu clave de API de Mistral en console.mistral.ai
- Tres métodos de configuración: configuración interactiva, variable de entorno, config.toml
- La variable de entorno tiene prioridad sobre el archivo .env
- Nunca confirmes tu clave en Git
- Establece límites de gasto en la Consola de Mistral