Przejdź do treści
Dokumentacja V1
Pierwsze kroki

Web

opencode może działać jako aplikacja internetowa w przeglądarce, zapewniając takie same możliwości kodowania AI bez konieczności korzystania z terminala.

Sieć opencode - Nowa sesja

Uruchom interfejs sieciowy, uruchamiając:

Terminal
opencode web

Spowoduje to uruchomienie lokalnego serwera na 127.0.0.1 z losowo dostępnym portem i automatyczne otwarcie opencode w domyślnej przeglądarce.


Możesz skonfigurować serwer WWW za pomocą flag wiersza poleceń lub w [pliku konfiguracyjnym] (./config).

Domyślnie opencode wybiera dostępny port. Możesz określić port:

Terminal
opencode web --port 4096

Domyślnie serwer łączy się z 127.0.0.1 (tylko localhost). Aby udostępnić opencode w swojej sieci:

Terminal
opencode web --hostname 0.0.0.0

Podczas korzystania z 0.0.0.0 opencode wyświetli zarówno adresy lokalne, jak i sieciowe:

  Local access:       http://localhost:4096
  Network access:     http://192.168.1.100:4096

Włącz mDNS, aby Twój serwer był wykrywalny w sieci lokalnej:

Terminal
opencode web --mdns

To automatycznie ustawia nazwę hosta na 0.0.0.0 i anonsuje serwer jako opencode.local.

Możesz dostosować nazwę domeny mDNS, aby uruchamiała wiele instancji w tej samej sieci:

Terminal
opencode web --mdns --mdns-domain myproject.local

Aby zezwolić na dodatkowe domeny dla CORS (przydatne w przypadku niestandardowych interfejsów):

Terminal
opencode web --cors https://example.com

Aby chronić dostęp, ustaw hasło za pomocą zmiennej środowiskowej OPENCODE_SERVER_PASSWORD:

Terminal
OPENCODE_SERVER_PASSWORD=secret opencode web

Domyślna nazwa użytkownika to opencode, ale można ją zmienić za pomocą OPENCODE_SERVER_USERNAME.


Po uruchomieniu interfejs sieciowy zapewnia dostęp do sesji opencode.

Przeglądaj sesje i zarządzaj nimi ze strony głównej. Możesz zobaczyć aktywne sesje i rozpocząć nowe.

opencode Web - Aktywna sesja

Kliknij „Zobacz serwery”, aby wyświetlić podłączone serwery i ich status.

opencode Web - See Servers


Możesz podłączyć terminal TUI do działającego serwera WWW:

Terminal
# Start the web server
opencode web --port 4096

# In another terminal, attach the TUI
opencode attach http://localhost:4096

Umożliwia to jednoczesne korzystanie z interfejsu sieciowego i terminala, współdzieląc te same sesje i stan.


Możesz także skonfigurować ustawienia serwera w pliku konfiguracyjnym opencode.json:

JSON
{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}

Flagi wiersza poleceń mają pierwszeństwo przed ustawieniami pliku konfiguracyjnego.