Artykuł Technologie

OpenCode - co to jest, jak działa i jak zacząć w terminalu

OpenCode to otwartoźródłowy agent AI do kodowania, który działa w terminalu, IDE albo w aplikacji desktopowej. Podpinasz dowolny model - Claude, GPT, Gemini albo lokalny - i agent czyta projekt, edytuje pliki i uruchamia komendy. Start to jedna linia: curl -fsSL https://opencode.ai/install | bash.

Co to jest OpenCode

OpenCode to agent kodujący, a nie zwykły czat. Różnica jest praktyczna: czat odpowiada tekstem, którego kopiujesz i wklejasz do edytora. Agent sam ma dostęp do plików projektu, potrafi je czytać, edytować, uruchamiać polecenia w powłoce i weryfikować wynik. Pracujesz w pętli - opisujesz zadanie po ludzku, agent proponuje zmiany, ty je zatwierdzasz.

Projekt tworzy zespół stojący za SST (dziś pod szyldem firmy Anomaly), a kod jest publiczny na GitHubie. Stan na lipiec 2026: repozytorium ma ponad 182 tysiące gwiazdek, około 960 kontrybutorów i ponad 14 tysięcy commitów, a najnowsze wydanie to v1.17.13 z 1 lipca 2026. Według danych projektu z OpenCode korzysta ponad 7,5 miliona programistów miesięcznie. Trzon napisano w TypeScript.

To samo podejście "agent w terminalu" znajdziesz w Cursorze - OpenCode wyróżnia się tym, że jest w pełni otwarty i nie przywiązuje Cię do jednego dostawcy modelu.

Do pracy, nie tylko kodowanie

Konkret: choć OpenCode reklamuje się jako narzędzie do pisania kodu, w praktyce jest to uniwersalny agent operujący na plikach i powłoce. To otwiera zastosowania daleko poza programowaniem.

Skoro agent umie czytać katalog, edytować pliki tekstowe i uruchamiać komendy, użyjesz go do porządkowania dużych zbiorów dokumentów, masowej zamiany treści w plikach Markdown, generowania raportów z logów czy automatyzacji powtarzalnych zadań administracyjnych. Tryb plan (tylko odczyt) świetnie nadaje się do audytu - agent przeanalizuje strukturę projektu albo repozytorium konfiguracji i opisze, co i gdzie jest, bez ryzyka, że coś zmieni.

Dla właściciela firmy albo osoby nietechnicznej najważniejsze jest to: OpenCode obniża próg wejścia do pracy z plikami przez naturalny język. Nie musisz znać składni sed czy awk - opisujesz cel po polsku, a agent tłumaczy go na konkretne działania.

Jak działa i jak zainstalować

OpenCode instalujesz jednym poleceniem, które pobiera skrypt instalacyjny:

curl -fsSL https://opencode.ai/install | bash

Jeśli wolisz menedżer pakietów, masz do wyboru kilka ścieżek:

npm i -g opencode-ai@latest        # npm / bun / pnpm / yarn
brew install anomalyco/tap/opencode # macOS i Linux (zalecane, zawsze aktualne)
scoop install opencode             # Windows
choco install opencode             # Windows
sudo pacman -S opencode            # Arch Linux

Skrypt instalacyjny wybiera katalog docelowy według priorytetu: zmienna $OPENCODE_INSTALL_DIR, potem $XDG_BIN_DIR, dalej $HOME/bin, a na końcu fallback $HOME/.opencode/bin. Pro tip admina: jeśli chcesz mieć binarkę w konkretnym miejscu, ustaw OPENCODE_INSTALL_DIR przed uruchomieniem skryptu.

Po instalacji uruchamiasz OpenCode w katalogu projektu i logujesz się do wybranego dostawcy modelu. Możesz podłączyć konto Claude, GPT czy Gemini, zalogować się przez GitHub Copilot albo wykorzystać subskrypcję ChatGPT Plus/Pro. Dostępne są też darmowe modele w pakiecie oraz modele lokalne - jeśli masz u siebie Ollamę, więc model dostaje realny kontekst o kodzie, a nie sam tekst.

  • Wiele sesji naraz - uruchomisz kilku agentów równolegle na tym samym projekcie.
  • Dwa wbudowane tryby agenta - build (pełny dostęp, tryb domyślny) i plan (tylko odczyt, odmawia edycji plików i pyta przed uruchomieniem komend). Przełączasz je klawiszem Tab. Dochodzi podagent general do złożonych wyszukiwań, wywoływany przez @general.
  • Współdzielenie sesji - wygenerujesz link do sesji, żeby pokazać ją komuś albo wrócić do niej później.
  • Wiele interfejsów - terminal (TUI), aplikacja desktopowa (beta na macOS, Windows i Linux) oraz rozszerzenie do IDE.
  • Prywatność - według dokumentacji projektu OpenCode nie przechowuje Twojego kodu ani danych kontekstowych, co pozwala używać go w środowiskach wrażliwych na prywatność.

Zastosowania

OpenCode sprawdza się wszędzie tam, gdzie chcesz mieć asystenta operującego bezpośrednio na plikach projektu. Krok po kroku typowe scenariusze:

  • Rozwój oprogramowania - pisanie i refaktoryzacja kodu, poprawianie błędów, dodawanie testów, przeglądanie nieznanego repozytorium w trybie plan.
  • DevOps i administracja - generowanie i poprawianie plików konfiguracyjnych, analiza logów, przygotowywanie skryptów powłoki.
  • Praca z lokalnym modelem - jeśli dane nie mogą opuścić firmy, podpinasz model uruchomiony przez Ollamę i cały kontekst zostaje na Twojej maszynie.
  • Automatyzacja zadań na plikach - masowe operacje na dokumentach, migracje treści, porządkowanie katalogów opisane naturalnym językiem.

Ponieważ OpenCode żyje w terminalu, dobrze łączy się z sesjami tmux. Trade-off jest czytelny: Cursor to zamknięty, płatny edytor oparty na Visual Studio Code z bardzo dopracowanym interfejsem graficznym. OpenCode to otwarty projekt działający głównie w terminalu, bez przywiązania do jednego dostawcy modelu i bez licencyjnych ograniczeń.

Jeśli pracujesz na serwerach przez SSH, cenisz otwarty kod i chcesz sam decydować, który model napędza agenta - OpenCode jest naturalnym wyborem. Jeśli wolisz klasyczne, graficzne IDE z gotowym doświadczeniem out of the box, bliżej Ci do Cursora. Oba narzędzia realizują ten sam wzorzec agenta kodującego, różnią się filozofią otwartości i miejscem pracy.

FAQ

Czym OpenCode różni się od zwykłego czatu AI?

Czat zwraca tekst, który sam kopiujesz do edytora. OpenCode to agent - ma dostęp do plików projektu i powłoki, więc samodzielnie czyta kod, edytuje pliki i uruchamia komendy, a Ty zatwierdzasz zmiany. Pracujesz w pętli zadanie - propozycja - akceptacja, zamiast ręcznie przenosić fragmenty kodu.

Czy OpenCode jest darmowy?

Sam OpenCode jest otwartoźródłowy i dostępny za darmo, a w pakiecie masz darmowe modele na start. Płacisz dopiero za model, który podepniesz - jeśli wybierzesz płatnego dostawcę jak Claude czy GPT, rozliczasz się z nim. Możesz też użyć modelu lokalnego i wtedy nie płacisz za żadną subskrypcję AI.

Czy muszę mieć osobną subskrypcję AI?

Nie musisz kupować nowej subskrypcji. Możesz wykorzystać konta, które już masz - zalogować się przez GitHub Copilot albo podpiąć subskrypcję ChatGPT Plus/Pro. Alternatywnie użyjesz darmowych modeli w pakiecie lub modelu uruchomionego lokalnie, na przykład przez Ollamę.

Czy OpenCode działa tylko w terminalu?

Nie. Terminal (interfejs TUI) to podstawowy sposób pracy, ale OpenCode jest też dostępny jako aplikacja desktopowa - stan na lipiec 2026 w wersji beta na macOS, Windows i Linux - oraz jako rozszerzenie do IDE. Wybierasz interfejs pasujący do Twojego stylu pracy.

Czy mogę używać OpenCode z lokalnym modelem?

Tak. OpenCode obsługuje ponad 75 dostawców modeli przez Models.dev, w tym modele lokalne. Jeśli uruchomisz model przez Ollamę oraz możliwość pracy z modelem lokalnym, gdy nic nie może wyjść poza sieć firmy.