blob: a4b9ac11ad053d52f6170c6a430e85d7e2d56f65 (
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: Execute o opencode no Windows com WSL para melhor experiência.
---
import { Steps } from "@astrojs/starlight/components"
Embora o opencode possa rodar direto no Windows, recomendamos usar [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) para a melhor experiência. O WSL oferece um ambiente Linux que funciona de forma integrada com os recursos do opencode.
:::tip[Por que WSL?]
O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a terminal e compatibilidade com as ferramentas de desenvolvimento das quais o opencode depende.
:::
---
## Configuração
<Steps>
1. **Instale o WSL**
Se ainda não instalou, [instale o WSL](https://learn.microsoft.com/en-us/windows/wsl/install) usando o guia oficial da Microsoft.
2. **Instale o opencode no WSL**
Depois de configurar o WSL, abra o terminal do WSL e instale o opencode usando um dos [métodos de instalação](/docs/).
```bash
curl -fsSL https://opencode.ai/install | bash
```
3. **Use o opencode pelo WSL**
Vá para o diretório do seu projeto (acesse arquivos do Windows via `/mnt/c/`, `/mnt/d/` etc.) e execute o opencode.
```bash
cd /mnt/c/Users/YourName/project
opencode
```
</Steps>
---
## App desktop + servidor WSL
Se você prefere usar o app desktop do opencode, mas quer rodar o servidor no WSL:
1. **Inicie o servidor no WSL** com `--hostname 0.0.0.0` para permitir conexões externas:
```bash
opencode serve --hostname 0.0.0.0 --port 4096
```
2. **Conecte o app desktop** em `http://localhost:4096`
:::note
Se `localhost` não funcionar no seu ambiente, conecte usando o IP do WSL (no WSL: `hostname -I`) e use `http://<wsl-ip>:4096`.
:::
:::caution
Ao usar `--hostname 0.0.0.0`, defina `OPENCODE_SERVER_PASSWORD` para proteger o servidor.
```bash
OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
```
:::
---
## Cliente web + WSL
Para a melhor experiência web no Windows:
1. **Execute `opencode web` no terminal WSL** em vez do PowerShell:
```bash
opencode web --hostname 0.0.0.0
```
2. **Acesse pelo navegador do Windows** em `http://localhost:<port>` (o opencode mostra a URL)
Executar `opencode web` a partir do WSL garante acesso correto ao sistema de arquivos e integração com o terminal, continuando acessível no navegador do Windows.
---
## Acessar arquivos do Windows
O WSL pode acessar todos os arquivos do Windows pelo diretório `/mnt/`:
- Unidade `C:` → `/mnt/c/`
- Unidade `D:` → `/mnt/d/`
- E assim por diante...
Exemplo:
```bash
cd /mnt/c/Users/YourName/Documents/project
opencode
```
:::tip
Para uma experiência mais fluida, considere clonar/copiar seu repositório para o sistema de arquivos do WSL (por exemplo em `~/code/`) e executar o opencode por lá.
:::
---
## Dicas
- Mantenha o opencode rodando no WSL para projetos armazenados em unidades do Windows - o acesso aos arquivos fica fluido
- Use a [extensão WSL do VS Code](https://code.visualstudio.com/docs/remote/wsl) junto com o opencode para um fluxo de desenvolvimento integrado
- Sua configuração e suas sessões do opencode ficam armazenadas no ambiente WSL em `~/.local/share/opencode/`
|
