blob: a1a7aa4efc10902b5db5ff31d9bd73a1f1116248 (
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: Esegui OpenCode su Windows con WSL per la migliore esperienza.
---
import { Steps } from "@astrojs/starlight/components"
Anche se OpenCode puo essere eseguito direttamente su Windows, consigliamo di usare [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) per la migliore esperienza. WSL fornisce un ambiente Linux che funziona in modo ottimale con le funzionalita di OpenCode.
:::tip[Perche WSL?]
WSL offre prestazioni migliori del file system, supporto completo del terminale e compatibilita con gli strumenti di sviluppo su cui OpenCode fa affidamento.
:::
---
## Configurazione
<Steps>
1. **Installa WSL**
Se non l'hai ancora fatto, [installa WSL](https://learn.microsoft.com/en-us/windows/wsl/install) seguendo la guida ufficiale Microsoft.
2. **Installa OpenCode in WSL**
Dopo aver configurato WSL, apri il terminale WSL e installa OpenCode usando uno dei [metodi di installazione](/docs/).
```bash
curl -fsSL https://opencode.ai/install | bash
```
3. **Usa OpenCode da WSL**
Vai nella directory del progetto (accedi ai file Windows tramite `/mnt/c/`, `/mnt/d/`, ecc.) ed esegui OpenCode.
```bash
cd /mnt/c/Users/YourName/project
opencode
```
</Steps>
---
## App desktop + server WSL
Se preferisci usare l'app desktop di OpenCode ma vuoi eseguire il server in WSL:
1. **Avvia il server in WSL** con `--hostname 0.0.0.0` per consentire connessioni esterne:
```bash
opencode serve --hostname 0.0.0.0 --port 4096
```
2. **Collega l'app desktop** a `http://localhost:4096`
:::note
Se `localhost` non funziona nella tua configurazione, usa l'indirizzo IP di WSL (da WSL: `hostname -I`) e collega `http://<wsl-ip>:4096`.
:::
:::caution
Quando usi `--hostname 0.0.0.0`, imposta `OPENCODE_SERVER_PASSWORD` per proteggere il server.
```bash
OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
```
:::
---
## Client web + WSL
Per la migliore esperienza web su Windows:
1. **Esegui `opencode web` nel terminale WSL** invece che in PowerShell:
```bash
opencode web --hostname 0.0.0.0
```
2. **Accedi dal browser Windows** su `http://localhost:<port>` (OpenCode stampa l'URL)
Eseguire `opencode web` da WSL garantisce accesso corretto al file system e integrazione del terminale, restando comunque accessibile dal browser Windows.
---
## Accesso ai file Windows
WSL puo accedere a tutti i file Windows tramite la directory `/mnt/`:
- Unita `C:` → `/mnt/c/`
- Unita `D:` → `/mnt/d/`
- E cosi via...
Esempio:
```bash
cd /mnt/c/Users/YourName/Documents/project
opencode
```
:::tip
Per un'esperienza piu fluida, valuta di clonare o copiare il repository nel file system di WSL (per esempio in `~/code/`) ed eseguire OpenCode li.
:::
---
## Suggerimenti
- Tieni OpenCode in esecuzione su WSL per i progetti salvati su unita Windows: l'accesso ai file e immediato
- Usa l'[estensione WSL di VS Code](https://code.visualstudio.com/docs/remote/wsl) insieme a OpenCode per un flusso di lavoro integrato
- Configurazione e sessioni di OpenCode sono salvate nell'ambiente WSL in `~/.local/share/opencode/`
|
