La terminal, las carpetas y tu primer proyecto

El problema que vamos a resolver

En el capítulo anterior instalaste Python y ejecutaste un archivo. Pero algo pasó en silencio mientras lo hacías: cuando ejecutaste el archivo, la terminal ya estaba abierta en esa misma carpeta. VS Code lo hizo por ti.

No siempre será así. Cuando la terminal está en otra carpeta, tienes que ir tú mismo a la carpeta del archivo. Ese "ir" es lo que más atrapa a los principiantes, más que ninguna otra cosa. El código está bien, Python está bien, pero la terminal se encuentra en otra carpeta —y Python informa de que el archivo no existe—.

En el trabajo harás esto unos cientos de veces al día. Así que hoy convertimos la terminal de una pantalla negra desconocida en una herramienta que conoces.

Al terminar este capítulo podrás

• Saber en qué carpeta está la terminal en este momento
• Moverte de una carpeta a otra, y subir un nivel hacia atrás
• Crear una carpeta de proyecto y ejecutar un archivo dentro de ella
• Abrir y cerrar el intérprete interactivo de Python (el REPL)
• Explicar en qué se diferencia el REPL de un archivo .py —esta confusión concreta desperdicia mucho tiempo—

Requisitos previos: Instalar Python y ejecutar tu primer programa.

Qué es realmente la terminal

La terminal es un lugar donde le das órdenes a la computadora escribiendo en vez de haciendo clic. Y cada ventana de terminal está siempre "parada" dentro de alguna carpeta. Esa carpeta se llama el directorio actual.

Esta es toda la idea. Cuando escribes python hello.py, lo que realmente dices es: "ejecuta el archivo `hello.py` de la carpeta en la que estoy parado ahora mismo". Si el archivo está en otra carpeta, Python no lo encontrará —porque no busca en ningún otro sitio—.

Los comandos de este capítulo son casi los mismos en Windows PowerShell, la Terminal de macOS y la Terminal de Linux. Donde se diferencian, se muestran las dos versiones.

Abre PowerShell en Windows y normalmente verás algo como:

PS C:\Users\Rafi>

En macOS, algo como:

rafi@MacBook ~ %

Y en Linux, algo como:

rafi@laptop:~$

Esta línea se llama el prompt —la terminal está esperando tu comando. En Windows, la parte C:\Users\Rafi te dice dónde estás. En macOS y Linux, el signo ~ significa tu carpeta personal.

Cuatro comandos que cubren el trabajo

pwd — ¿dónde estoy?

pwd

En Windows PowerShell la respuesta se ve así:

Path
----
C:\Users\Rafi

En macOS o Linux obtienes solo la ruta:

/home/rafi

(En macOS la ruta es /Users/rafi.)

ls — ¿qué hay aquí?

ls

Lista las carpetas y los archivos. ls funciona en los tres sistemas; Windows también tiene un comando más antiguo para lo mismo, dir. Ejecutar ls antes de ejecutar un archivo es un buen hábito —confirma que el archivo que estás a punto de ejecutar está realmente ahí—.

cd — ve a otra carpeta

cd python-lab

Dos puntos suben un nivel hacia atrás:

cd ..

Y para volver directamente a tu carpeta personal desde cualquier lugar:

cd ~

Estos tres comandos funcionan igual en Windows, macOS y Linux.

Escribe menos. Escribe las dos o tres primeras letras del nombre de una carpeta o un archivo y pulsa Tab —la terminal completa el resto. Escribir los nombres a mano es la mayor fuente de erratas, y Tab la elimina.

mkdir — crea una carpeta nueva

mkdir lesson-02

Prepara una carpeta de proyecto

Si vas dispersando tus archivos por el Escritorio mientras aprendes, no encontrarás nada una semana después. Así que elige un lugar y dale a cada capítulo su propia carpeta. En el capítulo anterior creaste python-lab en tu carpeta personal; ahora crea dentro de ella la carpeta de este capítulo:

cd ~
cd python-lab
mkdir lesson-02
cd lesson-02
pwd

Si python-lab todavía no existe, ejecuta mkdir python-lab después de cd ~. Estos comandos son iguales en los tres sistemas.

En Windows, ese último comando debería responder:

Path
----
C:\Users\Rafi\python-lab\lesson-02

En Linux:

/home/rafi/python-lab/lesson-02

En macOS la ruta empieza por /Users/rafi. Tu propio nombre de usuario aparece donde está Rafi o rafi.

Ahora crea en esta carpeta un archivo llamado notes.py que contenga:

print("Folder:", "lesson-02")
print("Squares:", 2 * 2, 3 * 3, 4 * 4)

Y ejecútalo —en Windows:

python notes.py

En macOS o Linux:

python3 notes.py

Folder: lesson-02
Squares: 4 9 16

El intérprete interactivo de Python

Escribe solo python en la terminal (python3 en macOS y Linux) y pulsa Enter, y el propio Python se abre:

python3

Python 3.12.3 (main, Aug 31 2026, 10:18:26) [GCC 13.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>>

La primera línea será distinta en tu computadora —muestra tu versión de Python, una fecha y el nombre de tu sistema operativo (en Windows termina con on win32, en macOS con on darwin)—. El signo >>> es igual en todas partes, y significa que Python está esperando una línea tuya. Todo lo que escribas aquí se responde de inmediato:

>>> 2 + 3
5
>>> "Python"
'Python'
>>> len("terminal")
8

Esto se llama el REPL —Read, Eval, Print, Loop—. Es muy útil para comprobar algo pequeño: si un cálculo está bien, o qué devuelve una función.

Para salir:

>>> exit()

La diferencia que a la gente le cuesta horas: en el REPL, escribir 2 + 3 te muestra 5 por sí solo. Pero pon solo 2 + 3 en un archivo .py y ejecútalo, y no aparece nada —Python hace la aritmética, tira el resultado y se queda callado—. En un archivo tienes que escribir print para ver algo. Esa es la verdadera diferencia entre el REPL y un script.

Cuando algo falla

python : The term 'python' is not recognized... (Windows) o command not found: python (macOS, Linux) En Windows, Python no está en el PATH —mira la sección "Cuando algo falla" del capítulo anterior: vuelve a ejecutar el instalador y marca la casilla en Modify—. En macOS y Linux el comando se llama python3.

can't open file '...notes.py': [Errno 2] No such file or directory La terminal está en la carpeta equivocada, o el nombre del archivo tiene una errata. Ejecuta pwd para ver dónde estás, y luego ls para ver si el archivo está ahí.

cd : Cannot find path ... because it does not exist (Windows) o cd: no such file or directory (macOS, Linux) La carpeta todavía no se ha creado, o el nombre está mal. Créala con mkdir, y la próxima vez que escribas el nombre pulsa Tab.

La terminal parece atascada, mostrando solo >>> Estás dentro del REPL, no fuera de él. ls y python notes.py no funcionarán aquí —esos son comandos de terminal, no de Python—. Escribe exit() para salir.

El nombre de la carpeta tiene espacios Pon el nombre entero entre comillas: cd "my python lab". Esto funciona en los tres sistemas. Nombrar las carpetas sin espacios evita el problema por completo, y por eso python-lab y my_notes son mejores hábitos.

Tu turno

Desde la terminal, usando solo comandos:

1. Crea una carpeta llamada practice dentro de python-lab
2. Entra en ella y confírmalo con pwd
3. Crea ahí un archivo llamado about.py que imprima tu nombre y la fecha de hoy
4. Ejecútalo con python about.py (python3 about.py en macOS o Linux)
5. Ahora haz cd .. para subir un nivel y ejecuta el mismo comando otra vez —¿qué ha pasado?

Ese último paso es la lección de verdad. Una vez que has visto el fallo a propósito, reconocerás su causa en un segundo cuando aparezca en el trabajo real.