Przejdź do głównej zawartości

CLI

Opcje i polecenia CLI opencode.

CLI opencode domyślnie uruchamia TUI, gdy wywołasz je bez argumentów.

Okno terminala
opencode

CLI obsługuje też polecenia opisane na tej stronie, więc możesz używać opencode programowo.

Okno terminala
opencode run "Explain how closures work in JavaScript"

tui

Uruchomienie interfejsu użytkownika terminala opencode.

Okno terminala
opencode [project]

Flagi

FlagaKrótkieOpis
--continue-cKontynuuj ostatnią datę
--session-sIdentyfikator sesji, aby kontynuować
--forkRozgałęź sesję podczas kontynuacji (użyj z --continue lub --session)
--promptMonituj o zastosowanie
--model-mModel wykorzystania w postaci dostawcy/modelu
--agentAgent do użycia
--portPort do słuchania
--hostnameNazwa hosta, która jest częścią składową

Polecenia

Interfejs CLI opencode zawiera także szczegółowe polecenie.


agent

Zarządzaj agentami opencode.

Okno terminala
opencode agent [command]

attach

Dołącz terminal do już działającego serwera zaplecza opencode uruchomionego za pomocą oprogramowania serve lub web.

Okno terminala
opencode attach [url]

Możliwość zabezpieczenia z TUI ze zdalnym backendem opencode. Na przykład:

Okno terminala
# Start the backend server for web/mobile access
opencode web --port 4096 --hostname 0.0.0.0
# In another terminal, attach the TUI to the running backend
opencode attach http://10.20.30.40:4096

Flagi

FlagaKrótkieOpis
--dirKatalog roboczy do uruchomienia TUI w
--session-sIdentyfikator sesji, aby kontynuować

create

Utwórz nowego agenta z niestandardową konfiguracją.

Okno terminala
opencode agent create

To działanie poprowadził Cię przez proces tworzenia nowego agenta z niestandardowym monitem systemowym i konfiguracją narzędzia.


list

Lista wszystkich agentów.

Okno terminala
opencode agent list

auth

Polecenie do zarządzania danymi uwierzytelniającymi i logowaniem dla dostawców.

Okno terminala
opencode auth [command]

login

opencode jest dostępny przez listę dostawców w Models.dev, więc można użyć opencode auth login do skonfigurowania klucza API dla dowolnego dostawcy, który może być kontrolowany. Jest to możliwe w ~/.local/share/opencode/auth.json.

Okno terminala
opencode auth login

Po uruchomieniu opencode ładuje dostawców z pliku poświadczeń. A jeśli twoje siedliskiem są jakieś klucze lub plik .env w twoim projekcie.


list

Wyświetlanie list wszystkich uwierzytelnionych dostawców przechowywanych w pliku poświadczeń.

Okno terminala
opencode auth list

Lub krótka wersja.

Okno terminala
opencode auth ls

logout

Wylogowuje Cię z dostawcy poprzez usunięcie go z pliku poświadczeń.

Okno terminala
opencode auth logout

github

Zarządzaj agentem GitHub w celu automatyzacji repozytorium.

Okno terminala
opencode github [command]

install

Zainstaluj agenta GitHub w swoim repozytorium.

Okno terminala
opencode github install

Spowoduje to konieczność uruchomienia akcji GitHub i przeprowadzi cię przez proces tworzenia. Dowiedz się więcej.


run

Uruchom agenta na GitHubie. Jest to zwykły użytkownik w akcjach GitHub.

Okno terminala
opencode github run
Flagi
FlagaOpis
--eventZdarzenie próbne GitHub, aby sprawdzić agenta dla
--tokenOsobisty token dostępu GitHub

MCP

Zarządzaj serwerem kluczowego modelu kontekstowego.

Okno terminala
opencode mcp [command]

add

Dodaj serwer MCP do swojej konfiguracji.

Okno terminala
opencode mcp add

To polecenie poprowadzić Cię przez proces dodawania lokalnego lub zdalnego serwera MCP.


list

Wyświetlanie list wszystkich skonfigurowanych serwerów MCP i ich awarii.

Okno terminala
opencode mcp list

Lub skrót krótkiej wersji.

Okno terminala
opencode mcp ls

auth

Uwierzytelnij się za pomocą serwera MCP z włączoną funkcją OAuth.

Okno terminala
opencode mcp auth [name]

Jeśli nie poddasz nazwy serwera, zostaniesz poproszony o wybranie jednego z serwerów obsługujących OAuth.

Możesz także uruchomić serwery obsługujące OAuth i ich status uwierzytelnienia.

Okno terminala
opencode mcp auth list

Lub skrót krótkiej wersji.

Okno terminala
opencode mcp auth ls

logout

Usuń doświadczenie OAuth dla serwera MCP.

Okno terminala
opencode mcp logout [name]

debug

Debuguj problemy z połączeniem OAuth dla serwera MCP.

Okno terminala
opencode mcp debug <name>

models

Wyświetlanie list modeli wszystkich skonfigurowanych dostawców.

Okno terminala
opencode models [provider]

Do sterowania dostępnymi modelami u dostawców w provider/model.

Jest to wydanie do nazwy modelu, który jest używany w [twoja] (./config/).

Opcjonalnie możesz udostępnić identyfikator dostawcy, aby filtrować modele według tego dostawcy.

Okno terminala
opencode models anthropic

Flagi

FlagaOpis
--refreshOdśwież pamięć podręczną modele z models.dev
--verboseBardziej szczegółowe dane wyjściowe modelu (zawiera metadane, takie jak koszty)

flagi --refresh, aby znaleźć listę modeli w pamięci podręcznej. Jest to wymagane, gdy dostawca dodano nowe modele, które chcesz zobaczyć w opencode.

Okno terminala
opencode models --refresh

chcesz

Uruchomiony opencode w trybie nieinteraktywnym, przekazując bezpośrednio monit.

Okno terminala
opencode run [message..]

Jest to wymagane w przypadku tworzenia skryptów, automatyzacji lub gdy zostanie wysłane natychmiastowe przesłanie bez uruchomienia TUI. Na przykład.

Okno terminala
opencode run Explain the use of context in Go

Można również zastosować, uruchamiając opencode serve, aby wyłączyć zimne uruchamianie serwera MCP przy każdym uruchomieniu:

Okno terminala
# Start a headless server in one terminal
opencode serve
# In another terminal, run commands that attach to it
opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"

Flagi

FlagaKrótkieOpis
--commandPolecenie do uruchomienia, komunikatu dla argumentów
--continue-cKontynuuj ostatnią datę
--session-sIdentyfikator sesji, aby kontynuować
--forkRozgałęź sesję podczas kontynuacji (użyj z --continue lub --session)
--shareUdostępnij sesję
--model-mModel wykorzystania w postaci dostawcy/modelu
--agentAgent do użycia
--file-fPliki do załączenia do wiadomości
--formatFormat: domyślny (sformatowany) lub json (surowe rozwiązanie JSON)
--titleTytuł sesji (używany skróconego monitu, jeśli nie podano wartości)
--attachDołącz do skutecznego serwera opencode (np. http://localhost:4096)
--portPort dla serwera lokalnego (domyślnie jest do portu losowego)

serve

Uruchom bezgłowy serwer opencode w celu uzyskania dostępu do API. Pełny interfejs HTTP w dokumentacji serwera.

Okno terminala
opencode serve

Spowoduje dostęp do serwera HTTP, który zapewnia dostęp do API opencode bez interfejsu TUI. Ustaw OPENCODE_SERVER_PASSWORD, aby włączyć podstawowe uwierzytelnianie HTTP (domyślna nazwa użytkownika do opencode).

Flagi

FlagaOpis
--portPort do słuchania
--hostnameNazwa hosta, która jest częścią składową
--mdnsWłącz wykrywanie mDNS
--corsDodatkowe źródło użytkownika CORS

session

Zarządzaj sesją opencode.

Okno terminala
opencode session [command]

list

Lista wszystkich sesji opencode.

Okno terminala
opencode session list
Flagi
FlagaKrótkieOpis
--max-count-nOgraniczony do ostatniego sesji
--formatFormat wyjściowy: tabela lub json (tabela)

stats

Pokaż statystyki wykorzystania tokenów i sesji szkoleniowych opencode.

Okno terminala
opencode stats

Flagi

FlagaOpis
--daysPokaż statystyki z ostatnich N dni (cały czas)
--toolsLiczba narzędzi do po specyfikacji (wszystkie)
--modelsPokaż podział modelu wykorzystania (domyślnie ukryty). Podajnik usługowy, aby górne N
--projectFiltruj według projektu (wszystkie projekty, pusty ciąg: dostęp projekt)

export

Eksportuj dane sesji jako JSON.

Okno terminala
opencode export [sessionID]

Jeśli nie poddasz identyfikatora sesji, zostaniesz poproszony o wybranie jednego z sesji.


import

Importuj dane sesji z pliku JSON lub adresu URL udostępniania opencode.

Okno terminala
opencode import <file>

Możesz importować z lokalnego lub adresu URL opencode.

Okno terminala
opencode import session.json
opencode import https://opncd.ai/s/abc123

web

Uruchomiony bezgłowy serwer opencode z interfejsem internetowym.

Okno terminala
opencode web

Spowoduje dostęp do serwera HTTP i otwarcie dostępu do opencode przez interfejs sieciowy. Ustaw OPENCODE_SERVER_PASSWORD, aby włączyć podstawowe uwierzytelnianie HTTP (domyślna nazwa użytkownika do opencode).

Flagi

FlagaOpis
--portPort do słuchania
--hostnameNazwa hosta, która jest częścią składową
--mdnsWłącz wykrywanie mDNS
--corsDodatkowe źródło użytkownika CORS

acp

Uruchomiony serwer ACP (Agent Client Protocol).

Okno terminala
opencode acp

Aby udostępnić serwer ACP, który komunikuje się poprzez stdin/stdout przy użyciu nd-JSON.

Flagi

FlagaOpis
--cwdKatalog roboczy
--portPort do słuchania
--hostnameNazwa hosta, która jest częścią składową

uninstall

Odinstaluj opencode i usuń wszystkie pliki powiązane.

Okno terminala
opencode uninstall

Flagi

FlagaKrótkieOpis
--keep-config-cZachowaj pliki konfiguracyjne
--keep-data-dPrzechowuj dane sesji i snapshots
--dry-runPokaż, wykluczy bez usuwania
--force-fPomiń monity o potwierdzenie

upgrade

Aktualizuje opencode do oryginalnej wersji lub oryginalnej wersji.

Okno terminala
opencode upgrade [target]

Aby zachować ostatnią wersję.

Okno terminala
opencode upgrade

Aby zobaczyć wersję pierwotną.

Okno terminala
opencode upgrade v0.1.48

Flagi

FlagaKrótkieOpis
--method-mZastosowana metoda instalacji; curl, npm, pnpm, bun, brew

Flagi globalne

Interfejs CLI kod opencode przyjmuje flagi globalne.

FlagaKrótkieOpis
--help-hWyświetl pomoc
--version-vDrukuj numer wersji
--print-logsWydrukuj logi na stderr
--log-levelPoziom dziennika (DEBUG, INFO, WARN, ERROR)

Zmienne środowiskowe

opencode można skonfigurować za pomocą zmiennych środowiskowych.

ZmiennaWpiszOpis
OPENCODE_AUTO_SHAREbooleanAutomatycznie udostępniaj sesje
OPENCODE_GIT_BASH_PATHstringŚcieżka do pliku wykonywalnego Git Bash w systemie Windows
OPENCODE_CONFIGstringŚcieżka do pliku konfiguracyjnego
OPENCODE_CONFIG_DIRstringŚcieżka do katalogu konfiguracyjnego
OPENCODE_CONFIG_CONTENTstringWbudowana treść konstrukcji JSON
OPENCODE_DISABLE_AUTOUPDATEbooleanWyłącz automatyczne sprawdzanie aktualizacji
OPENCODE_DISABLE_PRUNEbooleanWyłączenie regulowane
OPENCODE_DISABLE_TERMINAL_TITLEbooleanWyłącz automatycznie tytuł terminala
OPENCODE_PERMISSIONstringWbudowane prawo JSON
OPENCODE_DISABLE_DEFAULT_PLUGINSbooleanWyłączenie wtyczki
OPENCODE_DISABLE_LSP_DOWNLOADbooleanWyłącz automatyczne pobieranie z serwera LSP
OPENCODE_ENABLE_EXPERIMENTAL_MODELSbooleanWłącz modele eksperymentalne
OPENCODE_DISABLE_AUTOCOMPACTbooleanWyłącz automatyczne zagęszczanie kontekstu
OPENCODE_DISABLE_CLAUDE_CODEbooleanWyłączenie gry z .claude (podpowiedź + podłączenie)
OPENCODE_DISABLE_CLAUDE_CODE_PROMPTbooleanWyłącz czytanie ~/.claude/CLAUDE.md
OPENCODE_DISABLE_CLAUDE_CODE_SKILLSbooleanWyłącz ładowanie .claude/skills
OPENCODE_DISABLE_MODELS_FETCHbooleanWyłączenie modeli pobierania ze źródeł niedostępnych
OPENCODE_FAKE_VCSstringFałszywy sprzedawca VCS do celów testowych
OPENCODE_DISABLE_FILETIME_CHECKbooleanWyłączone sprawdzanie pliku w celu optymalizacji
OPENCODE_CLIENTstringIdentyfikator klienta (domyślnie cli)
OPENCODE_ENABLE_EXAbooleanWłącz narzędzie wyszukiwania internetowego Exa
OPENCODE_SERVER_PASSWORDstringWłącz uwierzytelnianie podstawowe dla serve/web
OPENCODE_SERVER_USERNAMEstringZakończenie stosowania użytkownika z autoryzacją (domyślnie opencode)
OPENCODE_MODELS_URLstringNiestandardowy adres URL do pobrania konfiguracji modeli

Eksperymentalne

Te zmienne możliwości użycia funkcji eksperymentalnych, które mogą zostać lub usunięte.

ZmiennaWpiszOpis
OPENCODE_EXPERIMENTALbooleanWłącz wszystkie funkcje eksperymentalne
OPENCODE_EXPERIMENTAL_ICON_DISCOVERYbooleanWłącz wykrywanie ikon
OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECTbooleanWyłączenie kopiowania przy wyborze w TUI
OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MSnumerDomyślny limit czasu dla ukrytego bash w ms
OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAXnumerMaksymalne tokeny wyjściowe dla odpowiedzi LLM
OPENCODE_EXPERIMENTAL_FILEWATCHERbooleanWłącz obserwatora plików dla całego katalogu
OPENCODE_EXPERIMENTAL_OXFMTbooleanWłącz formater oxfmt
OPENCODE_EXPERIMENTAL_LSP_TOOLbooleanWłącz eksperymentalne narzędzie LSP
OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHERbooleanWyłącz obserwatora plików
OPENCODE_EXPERIMENTAL_EXAbooleanWłącz funkcje eksperymentalne Exa
OPENCODE_EXPERIMENTAL_LSP_TYbooleanWłącz eksperymentalne sprawdzanie typu LSP
OPENCODE_EXPERIMENTAL_MARKDOWNbooleanWłącz funkcje eksperymentalne Markdown
OPENCODE_EXPERIMENTAL_PLAN_MODEbooleanWłącz tryb planu