L14 · Construcción y vista previa · 5 min

Claves y secretos: variables de entorno

En una frase

Las claves de API y las contraseñas abren tus cuentas, así que tu app las lee de variables de entorno que solo viven en Vercel y en .env.local en tu equipo, nunca en tu código, en el chat ni en GitHub.

Piénsalo así

Una clave es como la llave de tu casa. No la pegas en la puerta (tu código) ni la lees en voz alta en una cafetería (el chat). La guardas solo en dos sitios seguros.

Cómo funciona

Una Definiciónvariable de entornoUn hueco con nombre, como `TOKENTIDE_API_KEY`, que guarda un ajuste o un secreto fuera de tu código.Abrir en el glosario → es un hueco con nombre, como TOKENTIDE_API_KEY. Tu código pide el hueco por su nombre; el valor vive fuera del código.

Solo dos hogares: Vercel (tipo Secret) para la app publicada y .env.local para tu equipo. Ese archivo está en Definición.gitignoreUn archivo con lo que Git nunca debe guardar, como `node_modules` y tus archivos secretos `.env`.Abrir en el glosario →, así que nunca llega a GitHub.

Las claves las pegas tú, en la web de Vercel o en VS Code. Tu agente nunca te pide una y comprueba nombres, nunca valores.

Solo dos hogares
Vercel · Producción y vista previa, tipo Secret
.env.local · En tu equipo, ignorado por Git
Nunca
Tu códigoEl chatGitHubLogs y URLs
FIG. 1 · Tu código pide una clave por su nombre; el valor solo vive en estos dos sitios.

Cómo se ve en tu proyecto

Cuando tu app necesita una clave, tu agente prepara .env.local con valores vacíos y te dice dónde pegar cada una. Después ejecuta una comprobación que solo dice «set» (puesta) o «missing» (falta).

Copia para tu agente

Haz una lista de las variables de entorno que necesita mi app, dónde vive cada una (Vercel o .env.local) y comprueba cuáles están puestas o faltan, sin enseñar ningún valor.

Comprobación rápida · 1 pregunta

¿Dónde debe vivir tu clave de API?

Profundiza

Siguiente lecciónVista previa y producción: cómo se publica tu app

Última revisión 8 nov 2026