---
title: OpenCode Server
description: Połącz OpenChamber z lokalnym lub zdalnym serwerem OpenCode.
---

# OpenCode Server

OpenChamber działa na bazie serwera OpenCode. Domyślnie uruchamia go za Ciebie, więc nie musisz robić nic dodatkowego. Ta strona jest potrzebna tylko wtedy, gdy chcesz wskazać OpenChamber serwer, który już uruchamiasz, albo zarządzać tym, który sam startuje.

## Jak OpenChamber znajduje serwer

Gdy OpenChamber się uruchamia, szuka serwera w tej kolejności:

1. ponownie używa serwera, który już uruchomił
2. łączy się z zewnętrznym, jeśli mu to wskazałeś (zobacz niżej)
3. automatycznie wykrywa serwer na domyślnym porcie (`4096`)
4. w przeciwnym razie uruchamia i obsługuje własny

Jeśli nic nie jest skonfigurowane, krok 4 dzieje się automatycznie i od razu możesz pracować.

## Połącz się z serwerem, który już uruchamiasz

Ustaw te wartości przed uruchomieniem OpenChamber:

```bash
OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber
```

- `OPENCODE_HOST` — pełny adres Twojego serwera OpenCode, wraz z portem (wartość taka jak `http://localhost:4096`). Nie może zawierać ścieżki na końcu.
- `OPENCODE_SKIP_START=true` — informuje OpenChamber, aby nie uruchamiał własnego serwera.

Jeśli chcesz zmienić tylko port, ustaw `OPENCODE_PORT` zamiast `OPENCODE_HOST`.

Jeśli w `OPENCODE_HOST` brakuje portu lub zawiera ścieżkę, OpenChamber go zignoruje i wróci do uruchamiania własnego serwera. Obserwuj logi startowe pod kątem ostrzeżenia `[config]`, jeśli oczekiwane połączenie nie nastąpiło.

## Zarządzaj serwerem z poziomu CLI

```bash
openchamber status
openchamber logs
openchamber restart
openchamber stop
```

Samo `openchamber` uruchamia serwer w tle. Dodaj `--foreground`, aby pozostał dołączony do Twojego terminala.

## Uruchamianie OpenChamber po zalogowaniu

Użyj `startup enable`, aby zainstalować natywną usługę użytkownika. OpenChamber używa `launchd` na macOS, `systemd --user` na Linuksie i Harmonogramu zadań w Windows.

```bash
openchamber startup enable
openchamber startup status
openchamber startup disable
```

Aby zabezpieczyć UI, ustaw hasło podczas włączania usługi:

```bash
OPENCHAMBER_UI_PASSWORD='secret' openchamber startup enable
```

Dla serwera headless uruchamianego przy logowaniu i używanego przez aplikacje desktopowe lub mobilne dodaj `--api-only` oraz osiągalny host:

```bash
openchamber startup enable --port 3000 --api-only --host 0.0.0.0 --ui-password secret
```

`startup enable` zapisuje migawkę bieżącego środowiska w usłudze, aby uruchomienie było bliższe ręcznemu startowi `openchamber` z tej samej powłoki. Zachowuje to tokeny dostawców, `PATH`, ustawienia agenta SSH i inne zmienne CLI auth/config. Użyj `--no-env-snapshot`, jeśli chcesz minimalne środowisko usługi.

Usługa startowa pamięta `--port`, `--host`, `--ui-password` i `--api-only`. Restart z CLI oraz restart podczas aktualizacji używają tych zapisanych ustawień.

Aby utworzyć link połączenia dla innej aplikacji OpenChamber, użyj:

```bash
openchamber connect-url --port 3000 --server http://your-host:3000 --qr
```

Uruchom `openchamber connect-url --help`, aby zobaczyć wszystkie opcje linku, w tym `--name`, `--lan`, `--server`, `--api-only`, `--ui-password` i `--qr`.

Tunelami dla tej działającej usługi możesz zarządzać niezależnie:

```bash
openchamber tunnel start --port 3000
openchamber tunnel stop --port 3000
```

Zatrzymanie tunelu nie restartuje usługi ani aplikacji.

## „OpenCode uruchamia się ponownie”

Gdy serwer startuje lub uruchamia się ponownie, OpenChamber pokazuje stan „OpenCode uruchamia się ponownie” i wstrzymuje żądania, aż będzie gotowy. To normalne tuż po uruchomieniu lub restarcie. Jeśli ten stan nigdy nie znika, zobacz [Połączenie z OpenCode](/pl/troubleshooting/opencode-connection/).

## Powiązane

- [Dostawcy, modele i agenci](/pl/providers/) — skonfiguruj to, z czym serwer się komunikuje
- [Połączenie z OpenCode](/pl/troubleshooting/opencode-connection/) — jeśli nie chce się połączyć
