Objetivos
- Crear una cuenta de GitHub con verificación en dos pasos.
- Entender qué es una clave de API y por qué vale tanto como una contraseña.
- Conseguir al menos una clave de IA sin tarjeta (Google AI Studio, Groq u OpenRouter).
- Guardar la clave en un fichero .env y comprobar que .gitignore impide subirla.
- Saber revocar una clave en cada proveedor en menos de un minuto.
Antes de empezar: pe01 terminado (o un Codespace abierto) y un correo electrónico.
Prompt de arranque
Soy principiante. Tengo una carpeta de proyecto abierta en VS Code. Quiero guardar una clave de API en un fichero .env para que mis programas la lean, y quiero estar seguro de que ese fichero nunca se sube a GitHub. Dime qué ficheros crear, qué escribir dentro de cada uno y con qué comando de Git compruebo que .env está ignorado. No me pidas que pegue mi clave en el chat.
Esto lo escribe la IA, tú compruebas que funciona. Fíjate en la última frase del prompt: una clave nunca se pega en un chat, ni siquiera en el de una IA.
Explicación
Cuentas y claves: el carné y la llave
Para construir con IA necesitas dos cosas de los servicios que vas a usar: una cuenta y una clave.
La cuenta es tu carné de socio: tu nombre, tu correo y tu contraseña. Con ella entras en la web del servicio y ves tus proyectos, tu consumo y tus ajustes.
La clave de API es otra cosa. Es una llave que le das a tus programas para que puedan usar el servicio en tu nombre sin abrir el navegador. Si la cuenta es tu carné del gimnasio, la clave es la tarjeta que pasas por el torno: quien la tenga entra como si fueras tú. Por eso una clave vale exactamente lo mismo que una contraseña, y en algunos casos más, porque permite gastar tu cuota o tu dinero de forma automática, a miles de peticiones por minuto.
Una API (interfaz de programación de aplicaciones) es simplemente la «ventanilla» por la que un programa le pide cosas a otro. Cuando tu script de pe04 le pregunte algo a la IA, lo hará por esa ventanilla, enseñando la clave en cada petición.
Las cuentas que vas a crear
GitHub (https://github.com/signup). Es el sitio donde se guardan y comparten proyectos de código. Lo necesitas para Codespaces, para guardar tu trabajo del itinerario y como «carné» para entrar en otros servicios. Al crearla, GitHub te pedirá activar la verificación en dos pasos (2FA): además de la contraseña, un código de una app del móvil. Hazlo: es la medida que más ataques evita.
Un proveedor de IA con nivel sin coste. Te proponemos tres, todos sin tarjeta en octubre de 2026. Basta con uno; tener dos te salva el día si uno falla.
- Google AI Studio (https://aistudio.google.com/apikey). Da acceso a los modelos Gemini. Entras con una cuenta de Google y creas la clave en dos clics. Es el proveedor por defecto del Curso 0 y el que usa el script de pe04.
- Groq (https://console.groq.com/keys). Ejecuta modelos abiertos (Llama, gpt-oss) a una velocidad muy alta. Te registras con correo, Google o GitHub. Es la alternativa si AI Studio no te funciona.
- OpenRouter (https://openrouter.ai/settings/keys). Es un «centro comercial» de modelos: una sola clave da acceso a cientos de ellos, algunos marcados como
:free. Sin comprar créditos, los modelos gratuitos tienen un tope de 50 peticiones al día y 20 por minuto.
Los límites gratuitos cambian a menudo. No te aprendas cifras: cuando dudes, mira la página oficial de límites de cada proveedor (están en la tabla de URLs).
Una advertencia sobre los niveles gratuitos: lo que envías a un servicio gratuito puede usarse según sus condiciones, que no siempre son las de un plan de pago. Regla práctica para todo el curso: en las pruebas, nada de datos personales, de clientes ni de tu empresa.
Qué aspecto tiene una clave
Las claves son cadenas largas de letras y números con un prefijo que delata de dónde vienen:
| Proveedor | Empieza por |
|---|---|
| Google AI Studio | AQ. (las claves antiguas, AIza) |
| Groq | gsk_ |
| OpenRouter | sk-or-v1- |
| GitHub (token personal) | ghp_ o github_pat_ |
Esos prefijos existen precisamente para que los robots los reconozcan. Y ojo: hay robots buenos y malos. Los buenos, como el escaneo de secretos de GitHub, avisan al proveedor y a veces revocan la clave al instante. Los malos rastrean repositorios públicos día y noche y usan una clave publicada en cuestión de minutos.
La regla de oro
Una clave nunca se pega en un chat, ni en un repositorio, ni en una captura de pantalla.
- Ni en un chat: ni en el de una IA, ni en WhatsApp, ni en un foro pidiendo ayuda. Si necesitas ayuda con un error, copia el error, no la clave. Si la IA te pide la clave, responde «está en mi .env, no la voy a compartir».
- Ni en un repositorio: aunque sea privado. Los repositorios privados se hacen públicos por error, se comparten con colaboradores o se clonan en ordenadores ajenos.
- Ni en una captura: ni en un vídeo. Si vas a grabar tu pantalla, oculta la clave antes.
El fichero .env: la caja fuerte del proyecto
Si la clave no puede ir en el código, ¿dónde va? En un fichero llamado exactamente .env (con el punto delante y sin nada detrás), en la carpeta del proyecto. Dentro, una línea por clave, con el formato NOMBRE=valor, sin espacios alrededor del igual y sin comillas:
GEMINI_API_KEY=AQ.pega_aqui_tu_clave
Tu programa leerá ese fichero al arrancar (en pe04 verás cómo, con una línea de Python). La clave queda separada del código: puedes enseñar el código a quien quieras sin enseñar la llave.
El fichero .gitignore: la lista de lo que no se sube
Git, la máquina del tiempo de pe01, guarda fotos de todos los ficheros del proyecto. Para que nunca fotografíe el .env, se crea otro fichero, .gitignore, con la lista de cosas que Git debe ignorar. La línea .env dentro de .gitignore es tu seguro. Y se comprueba, no se supone: el comando git check-ignore -v .env te dice si Git lo está ignorando y por qué regla.
Un truco profesional: crea también un .env.example con los nombres de las variables pero sin valores. Ese sí se sube, y sirve para que cualquiera (incluido tú dentro de seis meses) sepa qué claves necesita el proyecto.
Qué hacer si una clave se escapa
Pasa hasta en las mejores familias. Lo importante es el orden:
- Revoca la clave en el proveedor. Ya. Antes de borrar el commit, antes de avisar a nadie. Una clave revocada deja de funcionar al instante y deja de ser peligrosa.
- Crea una nueva y ponla en tu
.env. - Revisa el consumo en el panel del proveedor por si alguien la usó.
- Después, si quieres, limpia el historial. Pero borrar el commit no basta: la clave pudo copiarse en el minuto en que estuvo publicada.
Revocar es igual en los tres proveedores: entras en la página de claves, localizas la clave por su nombre y pulsas el icono de papelera o «Delete». Por eso conviene poner nombres descriptivos a las claves («portatil-curso0», «grabacion-demo»): sabrás cuál borrar sin dudar.
Lab paso a paso
Objetivo: una cuenta de GitHub con 2FA, una clave de IA guardada en .env, y la prueba de que Git la ignora. Los pasos de navegador son iguales en los tres sistemas; los de terminal cambian.
Paso 3. Carpeta del proyecto con Git (terminal)
Windows (PowerShell)
mkdir $HOME\lab\mi-primera-ia
cd $HOME\lab\mi-primera-ia
git init
Y abre la carpeta en VS Code:
code .
macOS y Ubuntu
mkdir -p ~/lab/mi-primera-ia
cd ~/lab/mi-primera-ia
git init
Y abre la carpeta en VS Code:
code .
Qué debe verse: Initialized empty Git repository in .../mi-primera-ia/.git/ y VS Code abierto en esa carpeta. En Codespaces, sustituye la ruta por /workspaces/<tu-codespace>/mi-primera-ia y omite code ..
Paso 4. Crear .gitignore, .env y .env.example (en VS Code)
En el panel izquierdo de VS Code, pulsa el icono New File (Nuevo archivo) y crea estos tres ficheros. Escribe el nombre exacto, con el punto delante.
.gitignore:
.env
.venv/
__pycache__/
.env (pega tu clave en lugar del texto de ejemplo y guarda con Ctrl + S o Cmd + S):
GEMINI_API_KEY=AQ.pega_aqui_tu_clave
.env.example:
GEMINI_API_KEY=
Si usas otro proveedor, cambia el nombre de la variable: GROQ_API_KEY para Groq u OPENROUTER_API_KEY para OpenRouter.
Paso 5. Comprobar que Git ignora .env (terminal)
Los comandos son iguales en Windows, macOS y Ubuntu:
git check-ignore -v .env
git status
Qué debe verse:
.gitignore:1:.env .env
Y en git status, en la lista de «Untracked files», aparecen .env.example y .gitignore, pero no aparece .env. Si .env aparece en git status, para: revisa el error frecuente sobre el nombre del fichero.
Evidencia
- Captura de la página de seguridad de GitHub con la verificación en dos pasos activada (tapa el correo).
- Captura de la terminal con la salida de
git check-ignore -v .envy degit statussin.enven la lista. - Captura de la lista de claves del proveedor con la clave
simulacro-borrarya eliminada (las claves salen recortadas, pero tapa igualmente cualquier fragmento visible).
Criterio de aceptación
URLs de activación
Verificadas el 11-10-2026 (200 OK; github.com/signup devuelve 403 a peticiones automáticas pero abre bien en el navegador).
| Para qué | URL oficial |
|---|---|
| Crear cuenta de GitHub | https://github.com/signup |
| Activar 2FA en GitHub | https://github.com/settings/security |
| Tokens personales de GitHub (revocar) | https://github.com/settings/tokens |
| Clave de Google AI Studio (crear y borrar) | https://aistudio.google.com/apikey |
| Límites de Gemini API | https://ai.google.dev/gemini-api/docs/rate-limits |
| Clave de Groq (crear y borrar) | https://console.groq.com/keys |
| Límites de Groq | https://console.groq.com/docs/rate-limits |
| Clave de OpenRouter (crear y borrar) | https://openrouter.ai/settings/keys |
| Límites de OpenRouter | https://openrouter.ai/docs/api/reference/limits |
| Escaneo de secretos de GitHub | https://docs.github.com/es/code-security/secret-scanning/introduction/about-secret-scanning |
Errores frecuentes
| Síntoma | Qué pasa | Cómo se arregla |
|---|---|---|
.env aparece en git status aunque está en .gitignore | En Windows, el Bloc de notas guardó el fichero como .env.txt, o el .gitignore se llama .gitignore.txt. | Crea los ficheros desde VS Code. Para comprobar nombres reales: Get-ChildItem -Force en PowerShell o ls -la en macOS y Linux. Renombra con Rename-Item .env.txt .env o mv .env.txt .env. |
.env sigue apareciendo en GitHub después de añadirlo a .gitignore | El fichero ya se había incluido en un commit antes de crear .gitignore. .gitignore solo afecta a ficheros nuevos. | Revoca la clave (está expuesta). Después: git rm --cached .env, haz commit y crea una clave nueva. |
Error 401 Unauthorized o Invalid API Key al usar la clave | La clave está mal copiada (falta un carácter, hay un espacio o unas comillas), es de otro proveedor o fue revocada. | Copia de nuevo la clave desde el panel, sin espacios ni comillas: NOMBRE=valor. Comprueba que el prefijo coincide con el proveedor. Si la perdiste, crea una nueva: no se pueden volver a ver. |
Error 429 Too Many Requests | Has superado el límite gratuito por minuto o por día. | Espera un minuto (o al día siguiente si es el límite diario), haz menos peticiones seguidas o cambia temporalmente a otro proveedor con su propia clave. |
| AI Studio dice que el servicio no está disponible o pide facturación | Cuenta de Google gestionada (trabajo o centro educativo) con la API desactivada, o país no admitido. | Usa una cuenta personal de Google o pasa a Groq u OpenRouter, que no piden tarjeta. |
| No encuentras la clave que creaste ayer | Los proveedores solo la muestran completa una vez, al crearla. | Bórrala y crea otra; esta vez pégala directamente en .env. |
| GitHub te envía un correo «secret detected» | Has subido una clave y el escaneo de secretos la ha detectado. | No lo ignores: revoca la clave en el proveedor, crea una nueva y retírala del repositorio. |
Quiz
Cinco preguntas para comprobar que lo has entendido. Necesitas un 70 % para aprobar.