Windows (WSL)

Ejecuta OpenCode en Windows usando WSL para la mejor experiencia.

Aunque OpenCode puede ejecutarse directamente en Windows, recomendamos usar Windows Subsystem for Linux (WSL) (opens in a new tab) para la mejor experiencia. WSL proporciona un entorno Linux que funciona perfectamente con las características de OpenCode.

💡

¿Por qué WSL?

WSL ofrece mejor rendimiento del sistema de archivos, soporte completo de terminal y compatibilidad con herramientas de desarrollo de las que depende OpenCode.

Configuración

Instalar WSL

Si aún no lo has hecho, instala WSL (opens in a new tab) usando la guía oficial de Microsoft.
Instalar OpenCode en WSL

Una vez que WSL esté configurado, abre tu terminal de WSL e instala OpenCode usando uno de los métodos de instalación.
```
curl -fsSL https://opencode.ai/install | bash
```
Usar OpenCode desde WSL

Navega a tu directorio de proyecto (accede a los archivos de Windows a través de /mnt/c/, /mnt/d/, etc.) y ejecuta OpenCode.
```
cd /mnt/c/Users/YourName/project
opencode
```

Aplicación de Escritorio + Servidor WSL

Si prefieres usar la aplicación de escritorio de OpenCode pero quieres ejecutar el servidor en WSL:

Inicia el servidor en WSL con --hostname 0.0.0.0 para permitir conexiones externas:
```
opencode serve --hostname 0.0.0.0 --port 4096
```
Conecta la aplicación de escritorio a http://localhost:4096

Si localhost no funciona en tu configuración, conéctate usando la dirección IP de WSL en su lugar (desde WSL: hostname -I) y usa http://<wsl-ip>:4096.

⚠️

Cuando uses --hostname 0.0.0.0, configura OPENCODE_SERVER_PASSWORD para asegurar el servidor.

OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0

Cliente Web + WSL

Para la mejor experiencia web en Windows:

Ejecuta opencode web en la terminal de WSL en lugar de PowerShell:
```
opencode web --hostname 0.0.0.0
```
Accede desde tu navegador de Windows en http://localhost:<port> (OpenCode muestra la URL)

Ejecutar opencode web desde WSL asegura el acceso adecuado al sistema de archivos y la integración del terminal mientras sigue siendo accesible desde tu navegador de Windows.

Acceder a Archivos de Windows

WSL puede acceder a todos tus archivos de Windows a través del directorio /mnt/:

Unidad C: → /mnt/c/
Unidad D: → /mnt/d/
Y así sucesivamente…

Ejemplo:

cd /mnt/c/Users/YourName/Documents/project
opencode

💡

Para la experiencia más fluida, considera clonar/copiar tu repositorio en el sistema de archivos de WSL (por ejemplo bajo ~/code/) y ejecutar OpenCode allí.

Consejos

Mantén OpenCode ejecutándose en WSL para proyectos almacenados en unidades de Windows - el acceso a archivos es transparente
Usa la extensión WSL (opens in a new tab) de VS Code junto con OpenCode para un flujo de trabajo de desarrollo integrado
Tu configuración y sesiones de OpenCode se almacenan dentro del entorno WSL en ~/.local/share/opencode/

Solución de Problemas Migración a 1.0