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 sin problemas con las funciones de OpenCode.

Consejo: WSL ofrece un mejor rendimiento del sistema de archivos, soporte completo de terminal y compatibilidad con las herramientas de desarrollo en las que se basa OpenCode.

Configuración

Instala WSL Si aún no lo has hecho, instala WSL (opens in a new tab) usando la guía oficial de Microsoft.
Instala 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
```
Usa OpenCode desde WSL Navega al directorio de tu proyecto (accede a los archivos de Windows mediante /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

Nota: 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.

Precaución: Al usar --hostname 0.0.0.0, establece OPENCODE_SERVER_PASSWORD para proteger 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 imprime la URL)

Ejecutar opencode web desde WSL garantiza un acceso adecuado al sistema de archivos y la integración con la 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

Consejo: 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í.

Tips

Mantén OpenCode ejecutándose en WSL para los proyectos almacenados en unidades de Windows; el acceso a los archivos es fluido
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 TUI