# Claves y secretos: variables de entorno

> 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.

## Analogía

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 env-var 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 gitignore, 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.

## 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

```text
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.
```

---
Fuente: [Agentic Makers](https://agenticmakers.app/es/aprende/claves-y-secretos) · Licencia: CC BY 4.0