blob: eea984348c28e72cfb26148b2d96feb1ec522a4a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
|
---
title: Windows (WSL)
description: Ejecuta OpenCode en Windows con WSL para una mejor experiencia.
---
import { Steps } from "@astrojs/starlight/components"
Aunque OpenCode puede ejecutarse directamente en Windows, recomendamos usar [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) para obtener la mejor experiencia. WSL ofrece un entorno Linux que funciona perfectamente con las funciones de OpenCode.
:::tip[¿Por qué WSL?]
WSL ofrece mejor rendimiento del sistema de archivos, soporte completo de terminal y compatibilidad con las herramientas de desarrollo de las que depende OpenCode.
:::
---
## Configuración
<Steps>
1. **Instala WSL**
Si aún no lo hiciste, [instala WSL](https://learn.microsoft.com/en-us/windows/wsl/install) usando la guía oficial de Microsoft.
2. **Instala OpenCode en WSL**
Cuando WSL esté listo, abre tu terminal de WSL e instala OpenCode con uno de los [métodos de instalación](/docs/).
```bash
curl -fsSL https://opencode.ai/install | bash
```
3. **Usa OpenCode desde WSL**
Ve al directorio de tu proyecto (accede a los archivos de Windows desde `/mnt/c/`, `/mnt/d/`, etc.) y ejecuta OpenCode.
```bash
cd /mnt/c/Users/YourName/project
opencode
```
</Steps>
---
## Aplicación de escritorio + servidor WSL
Si prefieres usar la app de escritorio de OpenCode pero quieres ejecutar el servidor en WSL:
1. **Inicia el servidor en WSL** con `--hostname 0.0.0.0` para permitir conexiones externas:
```bash
opencode serve --hostname 0.0.0.0 --port 4096
```
2. **Conecta la app de escritorio** a `http://localhost:4096`
:::note
Si `localhost` no funciona en tu configuración, conéctate usando la dirección IP de WSL (desde WSL: `hostname -I`) y usa `http://<wsl-ip>:4096`.
:::
:::caution
Cuando uses `--hostname 0.0.0.0`, define `OPENCODE_SERVER_PASSWORD` para proteger el servidor.
```bash
OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
```
:::
---
## Cliente web + WSL
Para obtener la mejor experiencia web en Windows:
1. **Ejecuta `opencode web` en la terminal de WSL** en lugar de PowerShell:
```bash
opencode web --hostname 0.0.0.0
```
2. **Accede desde tu navegador de Windows** en `http://localhost:<port>` (OpenCode muestra la URL)
Ejecutar `opencode web` desde WSL garantiza acceso correcto al sistema de archivos e integración con la terminal, manteniéndolo accesible desde tu navegador de Windows.
---
## Acceso a archivos de Windows
WSL puede acceder a todos tus archivos de Windows mediante el directorio `/mnt/`:
- Unidad `C:` → `/mnt/c/`
- Unidad `D:` → `/mnt/d/`
- Y así sucesivamente...
Ejemplo:
```bash
cd /mnt/c/Users/YourName/Documents/project
opencode
```
:::tip
Para una experiencia más fluida, considera clonar o copiar tu repo al sistema de archivos de WSL (por ejemplo en `~/code/`) y ejecutar OpenCode ahí.
:::
---
## Consejos
- Ejecuta OpenCode en WSL para proyectos guardados en unidades de Windows: el acceso a archivos es transparente
- Usa la [extensión WSL de VS Code](https://code.visualstudio.com/docs/remote/wsl) junto con OpenCode para un flujo de desarrollo integrado
- Tu configuración y tus sesiones de OpenCode se guardan dentro del entorno WSL en `~/.local/share/opencode/`
|
