1. El sistema de archivos y primeros comandos

Objetivo

Entender qué son los archivos y directorios, conocer los comandos básicos para moverte por el sistema y saber cómo visualizar los documentos que vas a crear.

Duración estimada: 15 minutos

Ficheros de texto plano, el secreto de la IA

Los seres humanos necesitamos formatos de visualización de la información para aprovechar el funcionamiento de nuestro cerebro.

Por contra la IA puede construir su conocimiento directamente con los datos y sus contextos. La información se extrae e introduce más fácilmente con ficheros que tienen formatos de texto plano; el formato líder es markdown, que tiene la ventaja de ser fácil de leer y editar por seres humanos.

ConsejoOpción manual: el editor de texto

OpenCode modifica los archivos cuando se lo pides, pero tú también puedes abrir cualquier .md en un editor y editarlo directamente. Algunas opciones gratuitas:

  • Bloc de notas — viene preinstalado en cualquier sistema
  • Notepad++ — sencillo en Windows
  • VS Code — explorador integrado, resaltado de sintaxis, vistas previas
  • Sublime Text — ligero y rápido
  • … hay muchos, elige el que más se adapte a tus gustos.

No necesitas instalar nada especial: un .md es texto plano, se abre y se guarda como cualquier otro documento.

Para contextualizar nada mejor que organizar nuestra información en proyectos, directorios o carpetas.

Así, tenemos información en ficheros, organizada en directorios y gestionable desde una terminal, que podemos compartir con un modelo de IA, una combinación ganadora.

Evidentemente, si quieres sacar partido debes pagar un pequeño precio, aprender el uso de algunas cosas básicas.

¿Archivo? ¿Directorio? ¿Terminal?

Cuando trabajas con OpenCode, todo son archivos dentro de directorios (también llamados carpetas).

  • Un archivo (o fichero) es un documento individual: informe.md, datos.csv, presentacion.qmd, también un documento.odt, o una hoja-de-calculo.xls, o una presentación.pdf

  • Un directorio (o carpeta) es un contenedor de archivos y otros directorios; también de subdirectorios con los que organizamos los archivos.

  • La terminal es la ventana donde escribes comandos. Como veremos, OpenCode se abre dentro de una terminal, si bien hay otras opciones. Parecen feas y adustas, pero proporcionan potencia de trabajo y una vez te acostumbras no puedes prescindir de ellas.

    ¿Qué terminal usar en cada sistema?

    • Windows: incluye Símbolo del sistema (CMD) y PowerShell, pero están muy limitados para el trabajo con IA. Por eso usaremos WSL.

      Tras instalar WSL (lo harás en el paso 2), abre Ubuntu desde el menú de inicio. Esa es tu terminal

    • macOS: Terminal (está en Aplicaciones > Utilidades)

    • Linux: Cualquier terminal: GNOME Terminal, Konsole, xterm …

ConsejoTu explorador de archivos

Si estás en Windows, no te preocupes si no ves aún la terminal. En el paso 2 instalaremos WSL y tendrás una terminal Linux preparada para usar.

Piensa en las terminales como el explorador de archivos de tu ordenador,
pero manejado con texto en lugar de iconos.


Recomendación: ten un explorador de archivos abierto

Mientras haces el curso, es muy útil tener abierta una ventana del explorador de archivos de tu sistema apuntando al directorio de trabajo:

Sistema Explorador
Windows Explorador de archivos
macOS Finder
Linux Thunar, Nautilus, Dolphin o similar
VS Code El panel izquierdo (Explorador)

Así verás en tiempo real cómo OpenCode crea, modifica y organiza los archivos según avanzas en los ejercicios.


Comandos básicos que usarás a menudo

Aquí tienes los comandos imprescindibles. Pruébalos en tu terminal. Verás que puedes utilizarlos dentro de OpenCode.

cd — Cambiar de directorio

Cambia al directorio que indiques:

cd nombre-de-mi-directorio

Usa cd .. para subir al directorio padre.

pwd — ¿Dónde estoy?

Muestra la ruta del directorio en el que te encuentras:

pwd

Resultado: /home/tu-usuario o similar.

ls — ¿Qué hay aquí?

Lista los archivos en el directorio actual:

ls

Añade -l para ver detalles (tamaño, fecha):

ls -l

mkdir — Crear un directorio

mkdir nombre-de-mi-carpeta

cat — Ver el contenido de un archivo

cat mi-archivo.md

Muestra el contenido directamente en la terminal. Muy útil para echar un vistazo rápido a un archivo de texto. Hay alternativas como less para ficheros muy largos.


Visualizar documentos

Para ver estos documentos puedes hacerlo de varias formas, de la más sencilla a la más avanzada:

  1. Abrir con el navegador de archivos: haz doble clic sobre el archivo .md o .html y se abrirá con la aplicación predeterminada de tu sistema.

  2. Convertir a HTML con Quarto: puedes ver los ficheros markdown directamente. Para un formato más cómodo (negritas, tablas, etc.) conviértelos a HTML:

    quarto render mi-documento.md

    Se genera mi-documento.html, que puedes abrir arrastrándolo a tu navegador.

ConsejoHTML en el navegador

El HTML se ve exactamente igual que el documento final, con formato, tablas, negritas, etc.

Si te animas a usar la terminal, también puedes abrirlo con:

explorer.exe mi-documento.html        # Windows (WSL)
open mi-documento.html                 # macOS
xdg-open mi-documento.html             # Linux

Manos a la obra

Vamos a seguir el protocolo habitual para iniciar un proyecto empezando por crear el directorio, cambiar a nuevo directorio y verificar el directorio activo. Es importante que te familiarices con esto.

AvisoNombres adecuados para ficheros y directorios

Usa solo letras minúsculas, números y guiones (-) en los nombres. Evita espacios, mayúsculas y caracteres especiales (acentos, ñ, etc.). Ejemplo: curso-opencode ✅ — Curso OpenCode ❌

1. Crear el directorio del curso

Abre tu terminal y crea un directorio para trabajar durante el curso, usaremos el comando make directory:

mkdir curso-opencode

Entra en él, con el comando change directory:

cd curso-opencode

2. Comprobar que estás dentro

Este comando hace: print work directory, mostrar el directorio de trabajo.

pwd

Debería mostrar algo como /home/tu-usuario/curso-opencode.

3. ¿Qué hay en este directorio?

Para listar el contenido del directorio activo

ls -l

De momento está vacío. En el próximo paso crearás tu primer documento aquí.

4. Abre el explorador de archivos

Abre tu explorador de archivos y navega hasta curso-opencode. Ahora está vacío. En los próximos pasos verás cómo aparecen archivos aquí a medida que trabajes con OpenCode.


Resumen del paso

  • ✅ Sabes qué son archivos y directorios
  • ✅ Conoces los comandos cd, pwd, ls, y mkdir
  • ✅ Tienes un directorio de trabajo creado (curso-opencode)
  • ✅ Sabes que puedes ver los .md como HTML en el navegador
  • ✅ Tienes el explorador de archivos abierto para seguir el curso

En el próximo paso instalaremos OpenCode, y lo abriremos usando este mismo directorio para empezar a trabajar.


Curso OpenCode 101 · Idea original de JA Palazón · Mayo 2026