Solucin de problemas

Problemas comunes y cmo resolverlos.

Para depurar cualquier problema con OpenCode, puede consultar los registros o los datos de sesin que almacena localmente.

Registros

Los archivos de registro se escriben en:

macOS/Linux: ~/.local/share/opencode/log/
Windows: %USERPROFILE%\.local\share\opencode\log\

Los archivos de registro se nombran con marcas de tiempo (por ejemplo, 2025-01-09T123456.log) y se mantienen los 10 archivos de registro ms recientes.

Puede establecer el nivel de registro con la opcin de lnea de comandos --log-level para obtener informacin de depuracin ms detallada. Por ejemplo, opencode --log-level DEBUG.

Almacenamiento

opencode almacena datos de sesin y otros datos de aplicacin en el disco en:

macOS/Linux: ~/.local/share/opencode/
Windows: %USERPROFILE%\.local\share\opencode

Este directorio contiene:

auth.json - Datos de autenticacin como claves API, tokens OAuth
log/ - Registros de aplicacin
project/ - Datos especficos del proyecto como datos de sesin y mensaje
- Si el proyecto est dentro de un repositorio Git, se almacena en ./<project-slug>/storage/
- Si no es un repositorio Git, se almacena en ./global/storage/

Obtener ayuda

Si est experimentando problemas con OpenCode:

Reportar problemas en GitHub

La mejor manera de reportar errores o solicitar caractersticas es a travs de nuestro repositorio de GitHub:

github.com/anomalyco/opencode/issues

Antes de crear un nuevo problema, busque en los problemas existentes para ver si el suyo ya ha sido reportado.
nase a nuestro Discord

Para ayuda en tiempo real y discusin comunitaria, nase a nuestro servidor de Discord:

opencode.ai/discord

Problemas comunes

Aqu hay algunos problemas comunes y cmo resolverlos.

OpenCode no se inicia

Verifique los registros para ver mensajes de error
Intente ejecutar con --print-logs para ver la salida en la terminal
Asegrese de tener la ltima versin con opencode upgrade

Problemas de autenticacin

Intente volver a autenticarse con el comando /connect en el TUI
Verifique que sus claves API sean vlidas
Asegrese de que su red permita conexiones a la API del proveedor

Modelo no disponible

Verifique que se haya autenticado con el proveedor
Verifique que el nombre del modelo en su configuracin sea correcto
Algunos modelos pueden requerir acceso o suscripciones especficas

Si encuentra ProviderModelNotFoundError, lo ms probable es que est haciendo referencia incorrectamente a un modelo. Los modelos deben referenciarse as: <providerId>/<modelId>

Ejemplos:

openai/gpt-4.1
openrouter/google/gemini-2.5-flash
opencode/kimi-k2

Para saber qu modelos tiene acceso, ejecute opencode models

ProviderInitError

Si encuentra un ProviderInitError, probablemente tenga una configuracin invlida o corrupta.

Para resolver esto:

Primero, verifique que su proveedor est configurado correctamente siguiendo la gua de proveedores
Si el problema persiste, intente borrar su configuracin almacenada:
Ventana de terminal
```
rm -rf ~/.local/share/opencode
```
Vuelva a autenticarse con su proveedor usando el comando /connect en el TUI.

AI_APICallError y problemas de paquetes de proveedor

Si encuentra errores de llamada API, esto puede deberse a paquetes de proveedor desactualizados. opencode instala dinmicamente paquetes de proveedor (OpenAI, Anthropic, Google, etc.) segn sea necesario y los almacena en cach localmente.

Para resolver problemas de paquetes de proveedor:

Borre el cach del paquete de proveedor:
Ventana de terminal
```
rm -rf ~/.cache/opencode
```
Reinicie opencode para reinstalar los ltimos paquetes de proveedor

Esto forzar a opencode a descargar las versiones ms recientes de los paquetes de proveedor, lo que a menudo resuelve problemas de compatibilidad con parmetros de modelo y cambios en la API.

Copiar/pegar no funciona en Linux

Los usuarios de Linux necesitan tener una de las siguientes utilidades de portapapeles instaladas para que la funcin de copiar/pegar funcione:

Para sistemas X11:

apt install -y xclip
# o
apt install -y xsel

Para sistemas Wayland:

apt install -y wl-clipboard

Para entornos sin interfaz grfica:

apt install -y xvfb
# y ejecute:
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0

opencode detectar si est usando Wayland y preferir wl-clipboard, de lo contrario intentar encontrar herramientas de portapapeles en orden: xclip y xsel.