OSWork
IA como sistema de trabajo

De cero a tu entorno de agentes, comando por comando: terminal en Windows, carpeta de proyectos, Codex o Claude Code, GitHub con clave SSH y una VPS. Quien aprende a navegar en Windows navega en la VPS de la misma forma.

Comando por comando · copia y pega

OSWork en la práctica

Sigue el orden en una computadora con Windows 10 u 11. Cada paso muestra el comando y lo que debes ver en pantalla. Donde aparezca TuNombre o TU-USUARIO, usa el tuyo.

Parte 1 — Tu computadora

La terminal es solo otra ventana a las mismas carpetas de Windows. Aquí lo ves con tus propios ojos.

  1. Paso 1

    Abre la terminal

    Pulsa la tecla Windows, escribe cmd y pulsa Enter.

    Verás: Una ventana negra con C:\Users\TuNombre> — esa es tu carpeta personal.

  2. Paso 2

    Crea la carpeta proyectos y la de tu primer proyecto

    Escribe un comando a la vez y pulsa Enter después de cada uno.

    cd %USERPROFILE%
    mkdir proyectos
    cd proyectos
    mkdir mi-sitio
    cd mi-sitio

    Verás: C:\Users\TuNombre\proyectos\mi-sitio>

  3. Paso 3

    Mira en Windows dónde queda todo

    Este es el paso más importante. El comando abre el Explorador de archivos justo en la carpeta donde está la terminal.

    explorer .

    Verás: La carpeta mi-sitio abierta en el Explorador, dentro de proyectos. La terminal y el Explorador muestran el mismo lugar: lo que creas en uno aparece en el otro.

  4. Paso 4

    Navega con 6 comandos

    Es todo lo que necesitas para moverte entre carpetas. Practica: sube una carpeta, lista y vuelve a entrar.

    dirlista lo que hay en la carpeta
    cd nombreentra en la carpeta
    cd ..sube una carpeta
    mkdir nombrecrea una carpeta
    explorer .abre la carpeta en Windows
    clslimpia la pantalla
    cd ..
    dir
    cd mi-sitio
  5. Paso 5

    Instala Git, GitHub CLI y Node (una vez)

    winget ya viene con Windows. Después de instalar, cierra cmd y ábrelo de nuevo para que vea los programas nuevos.

    winget install --id Git.Git -e
    winget install --id GitHub.cli -e
    winget install --id OpenJS.NodeJS.LTS -e

    Verás: Al reabrir: git --version y gh --version muestran un número de versión.

  6. Paso 6

    Instala el agente: Claude Code o Codex

    Elige uno, o los dos. La primera vez que lo abras, entra con tu suscripción (Claude Pro/Max o ChatGPT Plus/Pro).

    curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
    npm install -g @openai/codex

    Verás: La primera línea instala Claude Code; la segunda, Codex. En una ventana nueva: claude --version o codex --version.

  7. Paso 7

    Trabaja dentro de la carpeta del proyecto

    El agente solo ve la carpeta donde estás. Entra y abre el agente (claude o codex). Pide: “Crea un index.html con una página sencilla sobre mí y un archivo AGENTS.md con las reglas de este proyecto.” Para salir, escribe /exit.

    cd %USERPROFILE%\proyectos\mi-sitio
    claude
    dir
    start index.html

    Verás: Los archivos nuevos aparecen en dir y en el Explorador; start abre la página en el navegador.

Parte 2 — GitHub: guardar y publicar

git guarda versiones del proyecto, gh habla con tu cuenta de GitHub y la clave SSH es tu identidad sin contraseña.

  1. Paso 8

    Dile a Git quién eres

    Usa el mismo correo de tu cuenta de GitHub.

    git config --global user.name "Tu Nombre"
    git config --global user.email "tu@correo.com"
  2. Paso 9

    Crea tu clave SSH

    Pulsa Enter en las 3 preguntas. Luego abre la carpeta donde quedó la clave.

    ssh-keygen -t ed25519 -C "tu@correo.com"
    explorer %USERPROFILE%\.ssh

    Verás: id_ed25519 es la clave privada: nunca la envíes a nadie. id_ed25519.pub es la pública: es la que entregas a GitHub y a la VPS.

  3. Paso 10

    Conecta gh a tu cuenta y sube la clave

    Responde: GitHub.com → SSH → elige id_ed25519.pub → Login with a web browser. Luego prueba la clave (la primera vez responde yes).

    gh auth login
    ssh -T git@github.com

    Verás: Hi TU-USUARIO! You've successfully authenticated.

  4. Paso 11

    Crea el repositorio y sube el proyecto

    Público: cualquiera lo ve. Privado: solo tú y quien invites. Para privado, cambia --public por --private.

    cd %USERPROFILE%\proyectos\mi-sitio
    git init
    git add .
    git commit -m "primera versión"
    git branch -M main
    gh repo create mi-sitio --public --source=. --push

    Verás: La dirección github.com/TU-USUARIO/mi-sitio con tus archivos.

  5. Paso 12

    Publica la página en GitHub Pages

    Gratis en repositorios públicos. También desde el sitio: Settings → Pages → branch main.

    gh api repos/{owner}/{repo}/pages -X POST -f "source[branch]=main" -f "source[path]=/"

    Verás: En 1 o 2 minutos la página abre en https://TU-USUARIO.github.io/mi-sitio/

  6. Paso 13

    La rutina de cada día

    ¿Cambiaste algo? Guarda una versión y súbela. O pídele al agente: “guarda y sube a GitHub”.

    git add .
    git commit -m "qué cambió"
    git push

Parte 3 — VPS: lo mismo, en un servidor

Una VPS es una computadora Linux encendida las 24 horas. Entras desde la misma terminal y navegas igual; solo cambian algunos nombres.

  1. Paso 14

    Contrata la VPS con tu clave

    Elige Ubuntu. Al crearla, el proveedor pide una clave SSH: pega el texto que muestra este comando.

    type %USERPROFILE%\.ssh\id_ed25519.pub

    Verás: Una línea que empieza con ssh-ed25519. Copia la línea completa.

  2. Paso 15

    Entra en la VPS

    Cambia IP-DE-LA-VPS por el número que te dio el proveedor. La primera vez responde yes. Para salir, escribe exit.

    ssh root@IP-DE-LA-VPS

    Verás: root@nombre-de-la-vps:~# — ahora la terminal es el servidor.

  3. Paso 16

    Misma navegación, otros nombres

    En la VPS no hay Explorador: ls cumple ese papel.

    dirls
    cd nombre / cd ..cd nombre / cd ..
    mkdir nombremkdir nombre
    clsclear
    type archivocat archivo
    %USERPROFILE%~
    mkdir -p ~/proyectos
    cd ~/proyectos
    ls
  4. Paso 17

    Trae el proyecto e instala el agente

    Un repositorio público se clona directo. Si es privado, instala gh (apt install -y gh) y ejecuta gh auth login, como en Windows.

    apt update && apt install -y git
    git clone https://github.com/TU-USUARIO/mi-sitio.git
    cd mi-sitio
    ls
    curl -fsSL https://claude.ai/install.sh | bash

    Verás: Los mismos archivos de tu Windows, ahora en la VPS. Ejecuta claude dentro de la carpeta, como en el paso 7.

Parte 4 — Cuando quieras conectar otros sistemas

VercelImporta el repositorio de GitHub y publica el sitio en cada git push, con dominio propio. Bueno para sitios y apps que van a crecer.
SupabaseBase de datos, inicio de sesión de usuarios y archivos para tu app. El agente escribe la integración; tú guardas las claves fuera del repositorio.

¿Quieres profundizar? Elige el curso

El paso a paso de arriba es el camino. Los cursos explican cada parte con calma.

Todas las ediciones ↓

Elige tu edición de OSWork

Dos caminos para organizar tu trabajo con IA. Elige según tu experiencia y el tiempo que tienes. Las ediciones anteriores están al final de la página.

OSWork v6.2 — el recorrido completo, paso a paso

El recorrido completo de v2 rehecho para quien está empezando: ocho módulos y 49 lecciones de unos 15 minutos. Del chat a la terminal y Codex, carpetas, Skills, Git, un bot de Telegram y una VPS, con paso a paso visual y un glosario de los términos técnicos.

OSWork Quick — en la práctica

Los 25 pasos de esta página como curso: cmd y carpetas en Windows, Explorador de archivos, Claude Code o Codex, Git con gh y clave SSH, GitHub Pages y VPS. Cuatro partes, con progreso, notas y chuleta de comandos.

El paso a paso en video, con Nei

Los 17 pasos de esta página hechos comando por comando, copiando y pegando: desde la terminal vacía en Windows hasta el sitio publicado en GitHub Pages y el mismo proyecto en una VPS, con el agente trabajando dentro de la carpeta. Avatar y voz de Nei, 8 minutos, en portugués, subtítulos SRT.

Videos de la edición anterior de Quick

La primera edición de Quick (organizar el trabajo con IA, sin terminal) en siete clases, con el avatar y la voz de Nei, ilustraciones y subtítulos SRT.

Avanzado

El recorrido técnico v2, módulo a módulo

Abre cada módulo para conocer sus seis temas. Los enlaces llevan al curso completo en el idioma de esta página.

Módulo 1 — Modelos: elige según la tarea

Comparar modelos con una tarea real y un criterio de calidad.

  1. IA como sistema de trabajo
  2. Tipos de IA y para qué sirven
  3. Modelo no es esfuerzo de razonamiento
  4. Cree una regla de calidad
  5. Entienda acceso y facturación
  6. Delimite la autonomía
Abrir el módulo completo
Módulo 2 — Chat, Work y Escritorio

Redactar una orden de trabajo con entradas, salida y revisión.

  1. Chat resuelve una conversación
  2. Work recibe una encomienda
  3. Desktop aproxima los archivos
  4. Local y nube son opciones de ejecución
  5. Escribe un contrato de entrega
  6. Revisa el trabajo recibido
Abrir el módulo completo
Módulo 3 — Terminal y Codex en la práctica

Abre un proyecto de entrenamiento en Codex y produce una modificación verificable.

  1. El terminal es una puerta de entrada
  2. Instala desde la fuente oficial
  3. Autentica sin divulgar secretos
  4. Entra en la carpeta antes de solicitar
  5. Realiza una primera tarea de lectura
  6. Usa permisos y recuperación
Abrir el módulo completo
Módulo 4 — Carpetas, Markdown y secretos

Construye la casa digital y separa conocimiento de credenciales.

  1. Una carpeta representa un contexto
  2. Markdown es texto organizado
  3. Cada archivo tiene un trabajo
  4. Los secretos no son conocimiento compartible
  5. Ignorar antes del primer commit
  6. Haga una limpieza de contexto
Abrir el módulo completo
Módulo 5 — AGENTS, Skills y memoria

Crear instrucciones de proyecto y una capacidad reutilizable con criterio de revisión.

  1. AGENTS.md orienta la ejecución
  2. Global y proyecto se complementan
  3. Las Skills empaquetan procedimientos
  4. La memoria necesita mantenimiento
  5. Los fallos se convierten en pequeñas protecciones
  6. Pruebe la capacidad reutilizable
Abrir el módulo completo
Módulo 6 — Git y GitHub sin perder trabajo

Guardar una versión, inspeccionar diferencias y recuperar un cambio de entrenamiento.

  1. Git es el historial del proyecto
  2. Observa antes de preparar
  3. Guarda una versión con intención
  4. Clona y actualiza con cuidado
  5. Recupera sin borrar el historial
  6. Publique solo lo que revisó
Abrir el módulo completo
Módulo 7 — Telegram como interfaz de trabajo

Ejecute un bot restringido de consulta y entienda dónde entra la IA.

  1. Telegram es la interfaz, no el agente
  2. Cree el bot y proteja el token
  3. Autorice personas y acciones
  4. Comience con long polling
  5. Conecte capacidades en etapas
  6. Pruebe operación y fallas
Abrir el módulo completo
Módulo 8 — VPS desde cero y operación 24/7

Prepare un plan de despliegue, supervisión, respaldo y verificación del servicio.

  1. Una VPS es una máquina bajo su responsabilidad
  2. Entre por SSH y preserve acceso
  3. Instale solo lo necesario
  4. Proteja la red y las credenciales
  5. Systemd supervisa el proceso
  6. Disponibilidad exige rutina de cuidado
Abrir el módulo completo

Avanzado

Kit del recorrido técnico

El kit reúne plantillas de AGENTS.md, memoria, decisiones, registro de fallos, contrato de tarea, Skill de informe y plan de VPS. Incluye un bot Python con autoprueba sin conexión.

El bot de práctica es determinista: no llama a un modelo de IA ni ejecuta mensajes como comandos. La integración con IA se explica como una etapa posterior.

Versiones anteriores

OSWork v6.2 rehízo el recorrido completo de v2 para quien está empezando. Las ediciones anteriores siguen abiertas para quien ya empezó con ellas.

Versión anterior · PT · EN · ES

OSWork v2 — recorrido técnico

Ocho módulos, cuatro rutas y 48 temas. Del chat a la terminal y Codex, archivos, Skills, Git, un bot de Telegram y operación supervisada en VPS. Incluye un kit de práctica.

Versión anterior · PT · EN · ES

OSWork v6 — principiantes, visual

Para quien está empezando: siete lecciones de unos 15 minutos con pantallas de chat simuladas, antes y después reales y paso a paso visual. Arma carpetas por tema, una ficha con tus reglas, una plantilla de pedido y una rutina de verificación, sin configurar nada.

Versión anterior · PT · EN · ES

OSWork v5 — para principiantes

Para profesionales mayores de 40 años con poca experiencia en IA. Siete clases de 20 a 25 minutos para organizar carpetas, instrucciones, solicitudes reutilizables y una rutina de revisión, sin programación.