📖 Glosario para principiantes
¿Te has perdido con alguna palabra técnica? Aquí tienes los términos que más aparecen al usar Claude Code, explicados con palabras normales y analogías de la vida real.
Terminal (o consola)
Una ventana donde escribes comandos de texto para darle órdenes al ordenador, en lugar de hacer clic con el ratón.
💡 Como enviarle instrucciones escritas a tu ordenador en vez de señalar botones.
CLI
Command Line Interface (interfaz de línea de comandos). Un programa que usas escribiendo en la terminal. Claude Code es una CLI.
Comando
Una orden que escribes en la terminal para que el ordenador haga algo. Por ejemplo, 'ls' lista los archivos de una carpeta.
Directorio
Es lo mismo que una carpeta. Los programadores suelen decir 'directorio'.
Repositorio (repo)
Una carpeta de proyecto cuyo historial de cambios se guarda con git. Puede estar en tu ordenador y/o en internet (GitHub).
💡 Como una carpeta con 'máquina del tiempo' incorporada.
git
Una herramienta que guarda el historial de todos los cambios de tu proyecto, para que puedas volver atrás o ver qué cambió y cuándo.
💡 Como el historial de versiones de un documento, pero para código.
Commit
Un 'punto de guardado' en git. Cada commit captura cómo estaba tu proyecto en ese momento, con un mensaje que explica qué cambiaste.
💡 Como una foto del estado de tu proyecto con una etiqueta describiéndola.
GitHub
Una web donde puedes guardar tus repositorios en internet, compartirlos y colaborar con otras personas.
Branch (rama)
Una línea de trabajo paralela en git. Te permite hacer cambios sin tocar la versión principal hasta que estés seguro.
💡 Como hacer una copia para experimentar sin estropear el original.
Pull Request (PR)
Una propuesta para añadir tus cambios al proyecto principal, para que alguien los revise antes de aceptarlos.
API
Application Programming Interface. Una forma de que dos programas hablen entre sí. Por ejemplo, una web que consulta el tiempo usa la API de un servicio meteorológico.
💡 Como el camarero de un restaurante: tú pides, él trae lo que la cocina prepara, sin que entres a la cocina.
API key
Una contraseña secreta que identifica quién usa un servicio. Claude Code necesita tu API key de Anthropic para funcionar.
💡 Como tu carné personal para entrar a un servicio.
Frontend
La parte de una aplicación que ve y usa el usuario: botones, textos, colores, formularios.
💡 El escaparate y la sala de una tienda.
Backend
La parte que no se ve: la lógica, la base de datos, los cálculos. Funciona 'por detrás'.
💡 El almacén y la trastienda donde se gestiona todo.
Base de datos
Un sitio organizado donde se guardan los datos de una aplicación (usuarios, productos, mensajes...).
💡 Como un archivador gigante, ordenado y consultable al instante.
Framework / Librería
Código ya hecho por otras personas que reutilizas para no empezar de cero. Por ejemplo, React es una librería para construir interfaces.
💡 Como usar muebles de IKEA en vez de fabricar cada tornillo.
Dependencia
Una librería externa que tu proyecto necesita para funcionar. Se instalan normalmente con npm o pip.
npm
El gestor de paquetes de Node.js. Sirve para instalar librerías de JavaScript con un comando.
Paquete
Una librería empaquetada y lista para instalar. 'Instalar un paquete' = añadir código de otra persona a tu proyecto.
Función
Un bloque de código con nombre que hace una tarea concreta y puedes reutilizar las veces que quieras.
💡 Como una receta: la escribes una vez y la usas cuando quieras.
Variable
Un nombre que guarda un valor (un número, un texto...) para usarlo después.
💡 Como una caja etiquetada donde guardas algo.
Bug
Un error o fallo en el código que hace que no funcione como debería.
Debug (depurar)
El proceso de encontrar y arreglar bugs.
Stack trace / Traceback
El texto largo que aparece cuando algo falla. Muestra dónde y por qué se rompió el programa. Es muy útil: cópialo entero al pedir ayuda.
Deploy (desplegar)
Publicar tu proyecto en internet para que otras personas puedan usarlo. Vercel, por ejemplo, despliega webs.
Servidor
Un ordenador (normalmente en internet) que ejecuta tu aplicación y responde a las peticiones de los usuarios.
localhost
Tu propio ordenador actuando como servidor, para probar tu proyecto antes de publicarlo. Suele verse como 'localhost:3000'.
JSON
Un formato de texto para guardar y compartir datos de forma organizada. Lo usan casi todas las aplicaciones para comunicarse.
Entorno (environment)
El conjunto de programas y configuraciones donde se ejecuta tu código. Tu ordenador es un entorno; un servidor es otro.
Variable de entorno
Un valor de configuración que vive fuera del código (como una API key), para no escribir datos secretos directamente en los archivos.
Hook
En Claude Code, un script que se ejecuta solo cuando ocurre algo (antes o después de una acción). Sirve para automatizar.
MCP
Model Context Protocol. La forma en que Claude Code se conecta a herramientas externas como bases de datos o el navegador.
💡 Como un enchufe universal para conectar herramientas a la IA.