OpenCode: cuando deja de arrancar (borrar la caché)

A veces OpenCode deja de arrancar o da errores raros de conexión, de proveedores o de configuración. Antes de desinstalar y volver a instalar, hay una prueba que arregla muchos de esos casos: borrar su caché.

La caché es una carpeta donde el programa guarda paquetes y datos temporales para ir más rápido. No son tus cosas: si se estropea, el programa empieza a portarse mal. Borrarla es como empezar de cero con esos temporales, porque el programa los vuelve a descargar la próxima vez que arranca.

Para recuperarlo en unos segundos sin reinstalar nada.

• Arreglar errores raros de conexión, de proveedores o de configuración.
• No reinstalar ni perder la calma: si el fallo estaba en la caché, esto lo quita de en medio.
• Ver el error de verdad antes de tocar nada, arrancando con más detalle.

• Cierra OpenCode por completo.

• Abre la terminal.

• Si quieres ver antes qué está fallando, arráncalo con más detalle y lee el mensaje:

opencode --log-level DEBUG

• Cierra ese arranque y borra la caché de paquetes:

rm -rf ~/.cache/opencode

• Vuelve a abrirlo con normalidad:

opencode

• Si arranca, ya está. Si sigue igual, mira las recetas de abajo.

Para hacerlo hace falta OpenCode instalado y teclear un comando en la terminal (el paso que más cuesta al principio, pero que se copia y se pega).

Lo comprobado el 5 de octubre de 2026:

• rm -rf borra sin preguntar. El comando que te doy borra solo la carpeta de caché, que son datos temporales. Copia la ruta tal cual: no la cambies ni le añadas nada.
• No borres la carpeta de datos. Ahí sí tienes cosas tuyas: si borras ~/.local/share/opencode, pierdes las sesiones y tendrás que volver a entrar.
• La caché no son tus ficheros. Lo que tú has creado en tu proyecto no está ahí: este truco no toca tu trabajo.

1. Sigo con el mismo error después de borrar la caché. Arranca con el detalle activado, copia el mensaje y guárdalo para buscar ayuda:

opencode --log-level DEBUG

Ese texto dice de qué se queja, y con eso deja de ser un misterio.

2. Me da miedo escribir rm -rf. Es normal: ese comando borra sin papelera. Aquí lo único que borra es la carpeta de caché, que son datos temporales. Escribe la ruta exactamente así:

rm -rf ~/.cache/opencode

3. He perdido mis sesiones y me pide volver a entrar. Eso pasa si además se ha borrado la carpeta de datos, que es la que guarda el trabajo de tus sesiones:

~/.local/share/opencode

Toca volver a iniciar sesión; la próxima vez, borra solo la caché y deja esta quieta.