CLI
Opcje i polecenia CLI opencode.
CLI opencode domyślnie uruchamia TUI, gdy wywołasz je bez argumentów.
opencodeCLI obsługuje też polecenia opisane na tej stronie, więc możesz używać opencode programowo.
opencode run "Explain how closures work in JavaScript"tui
Uruchomienie interfejsu użytkownika terminala opencode.
opencode [project]Flagi
| Flaga | Krótkie | Opis |
|---|---|---|
--continue | -c | Kontynuuj ostatnią datę |
--session | -s | Identyfikator sesji, aby kontynuować |
--fork | Rozgałęź sesję podczas kontynuacji (użyj z --continue lub --session) | |
--prompt | Monituj o zastosowanie | |
--model | -m | Model wykorzystania w postaci dostawcy/modelu |
--agent | Agent do użycia | |
--port | Port do słuchania | |
--hostname | Nazwa hosta, która jest częścią składową |
Polecenia
Interfejs CLI opencode zawiera także szczegółowe polecenie.
agent
Zarządzaj agentami opencode.
opencode agent [command]attach
Dołącz terminal do już działającego serwera zaplecza opencode uruchomionego za pomocą oprogramowania serve lub web.
opencode attach [url]Możliwość zabezpieczenia z TUI ze zdalnym backendem opencode. Na przykład:
# Start the backend server for web/mobile accessopencode web --port 4096 --hostname 0.0.0.0
# In another terminal, attach the TUI to the running backendopencode attach http://10.20.30.40:4096Flagi
| Flaga | Krótkie | Opis |
|---|---|---|
--dir | Katalog roboczy do uruchomienia TUI w | |
--session | -s | Identyfikator sesji, aby kontynuować |
create
Utwórz nowego agenta z niestandardową konfiguracją.
opencode agent createTo działanie poprowadził Cię przez proces tworzenia nowego agenta z niestandardowym monitem systemowym i konfiguracją narzędzia.
list
Lista wszystkich agentów.
opencode agent listauth
Polecenie do zarządzania danymi uwierzytelniającymi i logowaniem dla dostawców.
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.
opencode auth loginPo 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ń.
opencode auth listLub krótka wersja.
opencode auth lslogout
Wylogowuje Cię z dostawcy poprzez usunięcie go z pliku poświadczeń.
opencode auth logoutgithub
Zarządzaj agentem GitHub w celu automatyzacji repozytorium.
opencode github [command]install
Zainstaluj agenta GitHub w swoim repozytorium.
opencode github installSpowoduje 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.
opencode github runFlagi
| Flaga | Opis |
|---|---|
--event | Zdarzenie próbne GitHub, aby sprawdzić agenta dla |
--token | Osobisty token dostępu GitHub |
MCP
Zarządzaj serwerem kluczowego modelu kontekstowego.
opencode mcp [command]add
Dodaj serwer MCP do swojej konfiguracji.
opencode mcp addTo polecenie poprowadzić Cię przez proces dodawania lokalnego lub zdalnego serwera MCP.
list
Wyświetlanie list wszystkich skonfigurowanych serwerów MCP i ich awarii.
opencode mcp listLub skrót krótkiej wersji.
opencode mcp lsauth
Uwierzytelnij się za pomocą serwera MCP z włączoną funkcją OAuth.
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.
opencode mcp auth listLub skrót krótkiej wersji.
opencode mcp auth lslogout
Usuń doświadczenie OAuth dla serwera MCP.
opencode mcp logout [name]debug
Debuguj problemy z połączeniem OAuth dla serwera MCP.
opencode mcp debug <name>models
Wyświetlanie list modeli wszystkich skonfigurowanych dostawców.
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.
opencode models anthropicFlagi
| Flaga | Opis |
|---|---|
--refresh | Odśwież pamięć podręczną modele z models.dev |
--verbose | Bardziej 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.
opencode models --refreshchcesz
Uruchomiony opencode w trybie nieinteraktywnym, przekazując bezpośrednio monit.
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.
opencode run Explain the use of context in GoMożna również zastosować, uruchamiając opencode serve, aby wyłączyć zimne uruchamianie serwera MCP przy każdym uruchomieniu:
# Start a headless server in one terminalopencode serve
# In another terminal, run commands that attach to itopencode run --attach http://localhost:4096 "Explain async/await in JavaScript"Flagi
| Flaga | Krótkie | Opis |
|---|---|---|
--command | Polecenie do uruchomienia, komunikatu dla argumentów | |
--continue | -c | Kontynuuj ostatnią datę |
--session | -s | Identyfikator sesji, aby kontynuować |
--fork | Rozgałęź sesję podczas kontynuacji (użyj z --continue lub --session) | |
--share | Udostępnij sesję | |
--model | -m | Model wykorzystania w postaci dostawcy/modelu |
--agent | Agent do użycia | |
--file | -f | Pliki do załączenia do wiadomości |
--format | Format: domyślny (sformatowany) lub json (surowe rozwiązanie JSON) | |
--title | Tytuł sesji (używany skróconego monitu, jeśli nie podano wartości) | |
--attach | Dołącz do skutecznego serwera opencode (np. http://localhost:4096) | |
--port | Port 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.
opencode serveSpowoduje 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
| Flaga | Opis |
|---|---|
--port | Port do słuchania |
--hostname | Nazwa hosta, która jest częścią składową |
--mdns | Włącz wykrywanie mDNS |
--cors | Dodatkowe źródło użytkownika CORS |
session
Zarządzaj sesją opencode.
opencode session [command]list
Lista wszystkich sesji opencode.
opencode session listFlagi
| Flaga | Krótkie | Opis |
|---|---|---|
--max-count | -n | Ograniczony do ostatniego sesji |
--format | Format wyjściowy: tabela lub json (tabela) |
stats
Pokaż statystyki wykorzystania tokenów i sesji szkoleniowych opencode.
opencode statsFlagi
| Flaga | Opis |
|---|---|
--days | Pokaż statystyki z ostatnich N dni (cały czas) |
--tools | Liczba narzędzi do po specyfikacji (wszystkie) |
--models | Pokaż podział modelu wykorzystania (domyślnie ukryty). Podajnik usługowy, aby górne N |
--project | Filtruj według projektu (wszystkie projekty, pusty ciąg: dostęp projekt) |
export
Eksportuj dane sesji jako JSON.
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.
opencode import <file>Możesz importować z lokalnego lub adresu URL opencode.
opencode import session.jsonopencode import https://opncd.ai/s/abc123web
Uruchomiony bezgłowy serwer opencode z interfejsem internetowym.
opencode webSpowoduje 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
| Flaga | Opis |
|---|---|
--port | Port do słuchania |
--hostname | Nazwa hosta, która jest częścią składową |
--mdns | Włącz wykrywanie mDNS |
--cors | Dodatkowe źródło użytkownika CORS |
acp
Uruchomiony serwer ACP (Agent Client Protocol).
opencode acpAby udostępnić serwer ACP, który komunikuje się poprzez stdin/stdout przy użyciu nd-JSON.
Flagi
| Flaga | Opis |
|---|---|
--cwd | Katalog roboczy |
--port | Port do słuchania |
--hostname | Nazwa hosta, która jest częścią składową |
uninstall
Odinstaluj opencode i usuń wszystkie pliki powiązane.
opencode uninstallFlagi
| Flaga | Krótkie | Opis |
|---|---|---|
--keep-config | -c | Zachowaj pliki konfiguracyjne |
--keep-data | -d | Przechowuj dane sesji i snapshots |
--dry-run | Pokaż, wykluczy bez usuwania | |
--force | -f | Pomiń monity o potwierdzenie |
upgrade
Aktualizuje opencode do oryginalnej wersji lub oryginalnej wersji.
opencode upgrade [target]Aby zachować ostatnią wersję.
opencode upgradeAby zobaczyć wersję pierwotną.
opencode upgrade v0.1.48Flagi
| Flaga | Krótkie | Opis |
|---|---|---|
--method | -m | Zastosowana metoda instalacji; curl, npm, pnpm, bun, brew |
Flagi globalne
Interfejs CLI kod opencode przyjmuje flagi globalne.
| Flaga | Krótkie | Opis |
|---|---|---|
--help | -h | Wyświetl pomoc |
--version | -v | Drukuj numer wersji |
--print-logs | Wydrukuj logi na stderr | |
--log-level | Poziom dziennika (DEBUG, INFO, WARN, ERROR) |
Zmienne środowiskowe
opencode można skonfigurować za pomocą zmiennych środowiskowych.
| Zmienna | Wpisz | Opis |
|---|---|---|
OPENCODE_AUTO_SHARE | boolean | Automatycznie udostępniaj sesje |
OPENCODE_GIT_BASH_PATH | string | Ścieżka do pliku wykonywalnego Git Bash w systemie Windows |
OPENCODE_CONFIG | string | Ścieżka do pliku konfiguracyjnego |
OPENCODE_CONFIG_DIR | string | Ścieżka do katalogu konfiguracyjnego |
OPENCODE_CONFIG_CONTENT | string | Wbudowana treść konstrukcji JSON |
OPENCODE_DISABLE_AUTOUPDATE | boolean | Wyłącz automatyczne sprawdzanie aktualizacji |
OPENCODE_DISABLE_PRUNE | boolean | Wyłączenie regulowane |
OPENCODE_DISABLE_TERMINAL_TITLE | boolean | Wyłącz automatycznie tytuł terminala |
OPENCODE_PERMISSION | string | Wbudowane prawo JSON |
OPENCODE_DISABLE_DEFAULT_PLUGINS | boolean | Wyłączenie wtyczki |
OPENCODE_DISABLE_LSP_DOWNLOAD | boolean | Wyłącz automatyczne pobieranie z serwera LSP |
OPENCODE_ENABLE_EXPERIMENTAL_MODELS | boolean | Włącz modele eksperymentalne |
OPENCODE_DISABLE_AUTOCOMPACT | boolean | Wyłącz automatyczne zagęszczanie kontekstu |
OPENCODE_DISABLE_CLAUDE_CODE | boolean | Wyłączenie gry z .claude (podpowiedź + podłączenie) |
OPENCODE_DISABLE_CLAUDE_CODE_PROMPT | boolean | Wyłącz czytanie ~/.claude/CLAUDE.md |
OPENCODE_DISABLE_CLAUDE_CODE_SKILLS | boolean | Wyłącz ładowanie .claude/skills |
OPENCODE_DISABLE_MODELS_FETCH | boolean | Wyłączenie modeli pobierania ze źródeł niedostępnych |
OPENCODE_FAKE_VCS | string | Fałszywy sprzedawca VCS do celów testowych |
OPENCODE_DISABLE_FILETIME_CHECK | boolean | Wyłączone sprawdzanie pliku w celu optymalizacji |
OPENCODE_CLIENT | string | Identyfikator klienta (domyślnie cli) |
OPENCODE_ENABLE_EXA | boolean | Włącz narzędzie wyszukiwania internetowego Exa |
OPENCODE_SERVER_PASSWORD | string | Włącz uwierzytelnianie podstawowe dla serve/web |
OPENCODE_SERVER_USERNAME | string | Zakończenie stosowania użytkownika z autoryzacją (domyślnie opencode) |
OPENCODE_MODELS_URL | string | Niestandardowy adres URL do pobrania konfiguracji modeli |
Eksperymentalne
Te zmienne możliwości użycia funkcji eksperymentalnych, które mogą zostać lub usunięte.
| Zmienna | Wpisz | Opis |
|---|---|---|
OPENCODE_EXPERIMENTAL | boolean | Włącz wszystkie funkcje eksperymentalne |
OPENCODE_EXPERIMENTAL_ICON_DISCOVERY | boolean | Włącz wykrywanie ikon |
OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT | boolean | Wyłączenie kopiowania przy wyborze w TUI |
OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS | numer | Domyślny limit czasu dla ukrytego bash w ms |
OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX | numer | Maksymalne tokeny wyjściowe dla odpowiedzi LLM |
OPENCODE_EXPERIMENTAL_FILEWATCHER | boolean | Włącz obserwatora plików dla całego katalogu |
OPENCODE_EXPERIMENTAL_OXFMT | boolean | Włącz formater oxfmt |
OPENCODE_EXPERIMENTAL_LSP_TOOL | boolean | Włącz eksperymentalne narzędzie LSP |
OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER | boolean | Wyłącz obserwatora plików |
OPENCODE_EXPERIMENTAL_EXA | boolean | Włącz funkcje eksperymentalne Exa |
OPENCODE_EXPERIMENTAL_LSP_TY | boolean | Włącz eksperymentalne sprawdzanie typu LSP |
OPENCODE_EXPERIMENTAL_MARKDOWN | boolean | Włącz funkcje eksperymentalne Markdown |
OPENCODE_EXPERIMENTAL_PLAN_MODE | boolean | Włącz tryb planu |