# Consola y prompts del curso — macOS/Linux

Estado: maqueta revisable. Se probaron provisión MCP desde Claude web y texto, código y herramienta FFmpeg en A40. El chat agregado, la ruta de disco de red y la reapertura desde Claude Code requieren validación antes de publicar como tutorial ejecutable. Los esquemas no son evidencia de ejecución.

## 1. Preparación inicial

Requisito previo: Claude Code instalado y autenticado. Si todavía no lo tienes, usa la guía oficial de instalación y acceso enlazada en los recursos: https://code.claude.com/docs/en/quickstart. Este paso ocurre antes de poder pedirle acciones a Claude; no se presenta como una autoinstalación del propio asistente.

Descarga la carpeta del curso con INSTRUCCIONES.md, chat_server.py y demo_tools.py. Abre Claude Code en esa carpeta. Si utilizas Terminal, la única entrada necesaria para iniciar la conversación es `claude` desde ella; también puedes abrir la carpeta con el acceso que uses habitualmente. No necesitas copiar comandos de diagnóstico ni instalar Ollama o FFmpeg en tu computadora.

> Lee INSTRUCCIONES.md. Revisa mi computadora e instala las herramientas de conexión que falten para este curso. Explícame solo las autorizaciones necesarias y comprueba el resultado.

Claude identifica macOS o la distribución Linux, revisa curl y OpenSSH y prepara lo que falte. El usuario revisa las autorizaciones que el sistema requiera.

## 2. Conectar Runpod con un prompt

> Conecta el MCP oficial de Runpod y guíame para autorizar mi cuenta. No crees recursos.

Claude ejecuta la configuración. El usuario completa OAuth en el navegador, comprueba la cuenta y autoriza. Nunca pega contraseñas en el chat. Si Claude indica reabrir la conversación, hacerlo y volver a pedir que compruebe la conexión.

## 3. Primera comprobación

> Lee INSTRUCCIONES.md. Comprueba mis herramientas y consulta mis pods y el precio actual. No crees nada todavía.

Si Claude no puede listar recursos, resolver MCP/autorización antes de avanzar.

## 4. Elegir y crear

> Propón un solo pod para este curso con una GPU de al menos 24 GB y un disco de red estándar de 20 GB en el mismo centro de datos. Muéstrame disponibilidad, GPU, RAM, disco, tarifa de cómputo y costo del disco antes de crear. Sigue INSTRUCCIONES.md. No crees nada todavía.

Revisar cotización concreta. Solo después:

> Acepto esa configuración y ese precio. Crea mi pod y guarda su ID. Comprueba cada paso antes de continuar.

No copiar una aceptación sin revisar lo que Claude acaba de cotizar. Si falta stock:

> No crees otro todavía. Muéstrame una alternativa disponible y cuánto cambia el costo.

## 5. Abrir tu propio chat

> Comprueba Ollama y el modelo. Abre el túnel protegido y muéstrame mi chat en el navegador.

Señales: modelo en lista; Ollama responde; navegador muestra el chat servido por el pod. La interfaz no debe fingir respuestas.

## 6. Probar lo que puede hacer

> Haz una pregunta de prueba y mide la primera respuesta y la siguiente por separado.

> Envía mi imagen de prueba al modelo y compara su respuesta con lo que contiene.

> Pídele una función pequeña y ejecuta cinco casos para comprobarla. Muéstrame qué pasó.

> Copia demo_tools.py a /workspace en el pod. Ejecuta python3 /workspace/demo_tools.py para comprobar una llamada real a la herramienta de FFmpeg. Crea un clip de cinco segundos y verifica archivo, duración, resolución y reproducción. Muéstrame la petición del modelo y el resultado real.

## 7. Usarlo desde otra app

> Muéstrame la dirección y el modelo para conectarme desde otra app de esta computadora. Haz una petición real fuera del chat web.

No necesitas copiar una petición de consola. Claude debe ejecutarla, comprobar la respuesta real y entregarte la dirección y el nombre del modelo para tu aplicación.

Las apps compatibles pueden usar Ollama u otras rutas compatibles que se verifiquen. No confundir la dirección local del túnel con una API pública accesible desde cualquier lugar.

## 8. Apagar

> Elimina únicamente el pod de este curso y conserva su disco de red. Confirma que el pod desapareció y dime qué costo queda por el disco.

No basta cerrar el navegador o la terminal. Verificar ausencia del pod en Runpod y presencia del disco de red guardado. Ese disco sigue cobrando. El disco temporal del pod se pierde: los datos necesarios deben estar en /workspace, en el disco de red.

## 9. Volver

> Consulta una GPU disponible en el mismo centro de datos del disco guardado. Muéstrame la cotización antes de crear un nuevo pod con ese disco. Después comprueba el modelo, abre el túnel y verifica chat y API. No borres el disco ni cambies de región por tu cuenta.

## 10. Terminar la prueba

> Descarga mis archivos de muestra. Después elimina únicamente el pod y el disco de red identificados en ESTADO-POD.md. Confirma por separado que desaparecieron y cierra el túnel.

Eliminar el disco de red borra sus archivos. Verificar los IDs antes de cada eliminación y no tocar recursos ajenos.

## Costo orientativo

Ejemplo de tarifa consultada, sin garantía de disponibilidad: RTX 4090 Secure en EU-RO-1 a US$0.89/h. En 30 días, 3 h/día son 90 h: GPU US$80.10 + contenedor de 20 GB durante 90 h aproximadamente US$0.25 + disco de red estándar de 20 GB conservado todo el mes US$1.40 = **US$81.75/mes**, sin impuestos ni Claude. La región del disco debe tener GPU compatible disponible; consultar precio y stock antes de aceptar. La medición de rendimiento previa en A40 no representa un benchmark de la RTX 4090.

## Apéndice técnico para Claude

Estas instrucciones son para el asistente, no una lista de comandos que el espectador deba copiar. Con Claude Code ya instalado, configurar el MCP remoto mediante `claude mcp add --transport http runpod --scope user https://mcp.getrunpod.io/`. Si la conexión nueva no aparece en la conversación actual, indicar cómo reabrirla y completar la autorización. Comprobar herramientas con command -v y elegir la instalación apropiada al sistema. Para comprobar la API, ejecutar una petición HTTP real a http://127.0.0.1:11435/api/chat con model qwen3.5:9b, messages de prueba, stream false y think false.

## Prompts breves que aparecen en pantalla

Se usan con INSTRUCCIONES.md ya cargado. Las URLs, tamaños y pasos técnicos están en ese archivo y en el apéndice; no hace falta dictarlos al asistente.

> Revisa mi equipo y prepara las herramientas de conexión.

> Lee INSTRUCCIONES.md y guíame paso a paso.

> Conecta el MCP oficial de Runpod y guíame para autorizar mi cuenta. No crees recursos.

> Verifica el acceso a mi cuenta Runpod, sin crear recursos.

> Revisa mis herramientas, pods y precios actuales. No crees nada.

> Propón un solo pod para este curso. Muéstrame memoria y precio antes de crear.

> Acepto la propuesta y el precio. Crea el pod y comprueba el resultado.

> Comprueba conexión, modelo completo, respuesta y uso real de GPU.

> Abre el túnel protegido y muéstrame mi chat.

> Pide una función a mi modelo y compruébala con cinco pruebas en el pod.

> Prueba mi API y dame la dirección y el modelo para conectarla a otra app.

> Elimina solo el pod del curso. Conserva el disco y verifica el cierre.

> Cotiza una GPU compatible con mi disco. Tras mi aprobación, reutilízalo y verifica chat y API.

> Confirma que no quedan pods ni discos de este curso.

