Después de la sesión
Cuando algo falla
Algo va a fallar en algún momento, y es normal. Esta lección junta los problemas más comunes y cómo salir de cada uno.
La instalación
| Síntoma | Qué hacer |
|---|---|
command not found o "no se reconoce como un comando" | Cierra la terminal y abre una nueva. Si sigue, reinstala con otra opción de la lección de instalación. |
npm: command not found | Te falta Node.js. Instálalo desde nodejs.org (versión LTS) y abre una terminal nueva. |
| La interfaz se ve rara o con símbolos extraños | Usa una terminal moderna. En Windows, la app Terminal funciona mejor que la consola vieja. |
La conexión con el modelo
| Síntoma | Qué hacer |
|---|---|
| Error de autenticación o "invalid key" | La llave se pegó mal. /connect otra vez y pégala completa, sin espacios. |
| "Rate limit" o el modelo no contesta | El modelo gratuito está saturado o llegaste al tope del día. Cambia de modelo con /models, o espera al día siguiente. |
| Contesta pero muy lento | Pasa con los gratuitos en horas de mucho uso. Prueba otro modelo gratuito. |
El agente
| Síntoma | Qué hacer |
|---|---|
| Dice que no ve tus archivos | Lo abriste en otra carpeta. /exit, entra a la carpeta correcta y vuelve a abrir opencode. |
| No te pide permiso antes de cambiar archivos | Falta opencode.json en la carpeta, o tiene un error de formato. Revisa que sea idéntico al del taller. |
| Hizo algo distinto a lo que pediste | Recházalo y pídelo de nuevo con más detalle. Di también qué no debe tocar. |
| La conversación se hizo muy larga y se confunde | Empieza una nueva con /new. |
Cómo pedir ayuda bien
Si vas a preguntar en la comunidad, incluye tres cosas:
- Qué querías hacer (una frase).
- Qué comando escribiste o qué le pediste al agente, copiado tal cual.
- Qué salió, copiado tal cual, o una captura. Tapa tu llave si aparece.
Con esas tres cosas, casi cualquier problema se resuelve en un mensaje.
Resumen
- La mayoría de fallas de instalación se arreglan con una terminal nueva.
- La mayoría de fallas de conexión son la llave mal pegada o un modelo gratuito saturado.
- Para pedir ayuda: qué querías, qué escribiste, qué salió. Y nunca tu llave.