Gå til innholdet

CLI

opencode CLI alternativer og kommandoer.

OpenCode CLI starter som standard TUI når den kjøres uten noen argumenter.

Terminal window
opencode

Men den godtar også kommandoer som dokumentert på denne siden. Dette lar deg samhandle med OpenCode programmatisk.

Terminal window
opencode run "Explain how closures work in JavaScript"

tui

Start OpenCode-terminalbrukergrensesnittet.

Terminal window
opencode [project]

Flagg

FlaggKortBeskrivelse
--continue-cFortsett siste økt
--session-sØkt ID for å fortsette
--forkForgren økten ved fortsettelse (bruk med --continue eller --session)
--promptLedetekst som skal brukes
--model-mModell å bruke i form av leverandør/modell
--agentAgent å bruke
--portPort å lytte på
--hostnameVertsnavn å lytte på

Kommandoer

OpenCode CLI har også følgende kommandoer.


agent

Administrer agenter for OpenCode.

Terminal window
opencode agent [command]

attach

Koble en terminal til en allerede kjørende OpenCode-backend-server startet via serve eller web kommandoer.

Terminal window
opencode attach [url]

Dette gjør det mulig å bruke TUI med en ekstern OpenCode-backend. For eksempel:

Terminal window
# 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

Flagg

FlaggKortBeskrivelse
--dirArbeidskatalog for å starte TUI i
--session-sØkt ID for å fortsette

create

Opprett en ny agent med tilpasset konfigurasjon.

Terminal window
opencode agent create

Denne kommandoen vil veilede deg gjennom å lage en ny agent med en tilpasset systemmelding og verktøykonfigurasjon.


list

List opp alle tilgjengelige agenter.

Terminal window
opencode agent list

auth

Kommando for å administrere legitimasjon og pålogging for leverandører.

Terminal window
opencode auth [command]

login

OpenCode drives av leverandørlisten på Models.dev, så du kan bruke opencode auth login til å konfigurere API-nøkler for enhver leverandør du vil bruke. Dette er lagret i ~/.local/share/opencode/auth.json.

Terminal window
opencode auth login

Når OpenCode starter opp, laster den leverandørene fra legitimasjonsfilen. Og hvis det er noen nøkler definert i miljøene dine eller en .env-fil i prosjektet ditt.


list

Viser alle de autentiserte leverandørene som er lagret i legitimasjonsfilen.

Terminal window
opencode auth list

Eller kortversjonen.

Terminal window
opencode auth ls

logout

Logger deg ut av en leverandør ved å fjerne den fra legitimasjonsfilen.

Terminal window
opencode auth logout

github

Administrer GitHub-agenten for depotautomatisering.

Terminal window
opencode github [command]

install

Installer GitHub-agenten i depotet ditt.

Terminal window
opencode github install

Dette setter opp den nødvendige GitHub Actions-arbeidsflyten og veileder deg gjennom konfigurasjonsprosessen. Finn ut mer.


run

Kjør GitHub-agenten. Dette brukes vanligvis i GitHub Actions.

Terminal window
opencode github run
Flagg
FlaggBeskrivelse
--eventGitHub mock-hendelse å kjøre agenten for
--tokenGitHub personlig tilgangstoken

mcp

Administrer Model Context Protocol-servere.

Terminal window
opencode mcp [command]

add

Legg til en MCP-server til konfigurasjonen.

Terminal window
opencode mcp add

Denne kommandoen vil veilede deg gjennom å legge til enten en lokal eller ekstern MCP-server.


list

Liste alle konfigurerte MCP-servere og deres tilkoblingsstatus.

Terminal window
opencode mcp list

Eller bruk den korte versjonen.

Terminal window
opencode mcp ls

auth

Autentiser med en OAuth-aktivert MCP-server.

Terminal window
opencode mcp auth [name]

Hvis du ikke oppgir et servernavn, blir du bedt om å velge blant tilgjengelige OAuth-kompatible servere.

Du kan også liste opp OAuth-kompatible servere og deres autentiseringsstatus.

Terminal window
opencode mcp auth list

Eller bruk den korte versjonen.

Terminal window
opencode mcp auth ls

logout

Fjern OAuth-legitimasjon for en MCP-server.

Terminal window
opencode mcp logout [name]

debug

Feilsøk OAuth-tilkoblingsproblemer for en MCP-server.

Terminal window
opencode mcp debug <name>

models

List opp alle tilgjengelige modeller fra konfigurerte leverandører.

Terminal window
opencode models [provider]

Denne kommandoen viser alle modeller som er tilgjengelige på tvers av dine konfigurerte leverandører i formatet provider/model.

Dette er nyttig for å finne ut det eksakte modellnavnet som skal brukes i din konfigurasjon.

Du kan eventuelt sende en leverandør ID for å filtrere modeller etter den leverandøren.

Terminal window
opencode models anthropic

Flagg

FlaggBeskrivelse
--refreshOppdater modellbufferen fra models.dev
--verboseBruk mer detaljert modellutdata (inkluderer metadata som kostnader)

Bruk --refresh-flagget for å oppdatere den bufrede modelllisten. Dette er nyttig når nye modeller er lagt til en leverandør og du vil se dem i OpenCode.

Terminal window
opencode models --refresh

run

Kjør OpenCode i ikke-interaktiv modus ved å sende en melding direkte.

Terminal window
opencode run [message..]

Dette er nyttig for skripting, automatisering eller når du vil ha et raskt svar uten å starte hele TUI. For eksempel.

Terminal window
opencode run Explain the use of context in Go

Du kan også koble til en kjørende opencode serve-forekomst for å unngå MCP-tjenerkaldoppstartstider ved hver kjøring:

Terminal window
# 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"

Flagg

FlaggKortBeskrivelse
--commandKommandoen for å kjøre, bruk melding for args
--continue-cFortsett siste økt
--session-sØkt ID for å fortsette
--forkForgren økten ved fortsettelse (bruk med --continue eller --session)
--shareDel økten
--model-mModell å bruke i form av leverandør/modell
--agentAgent å bruke
--file-fFil(er) som skal legges ved melding
--formatFormat: standard (formatert) eller json (rå JSON hendelser)
--titleTittel for økten (bruker avkortet ledetekst hvis ingen verdi er oppgitt)
--attachKoble til en kjørende OpenCode-server (f.eks. http://localhost:4096)
--portPort for den lokale serveren (standard til tilfeldig port)

serve

Start en hodeløs OpenCode-server for API-tilgang. Sjekk ut server-dokumentene for hele HTTP-grensesnittet.

Terminal window
opencode serve

Dette starter en HTTP-server som gir API tilgang til OpenCode-funksjonalitet uten TUI-grensesnittet. Sett OPENCODE_SERVER_PASSWORD for å aktivere HTTP grunnleggende autentisering (brukernavn er standard til opencode).

Flagg

FlaggBeskrivelse
--portPort å lytte på
--hostnameVertsnavn å lytte på
--mdnsAktiver mDNS-oppdagelse
--corsYtterligere nettleseropprinnelse for å tillate CORS

session

Administrer OpenCode-økter.

Terminal window
opencode session [command]

list

List opp alle OpenCode-økter.

Terminal window
opencode session list
Flagg
FlaggKortBeskrivelse
--max-count-nBegrens til N siste økter
--formatUtdataformat: tabell eller json (tabell)

stats

Vis tokenbruk og kostnadsstatistikk for OpenCode-øktene dine.

Terminal window
opencode stats

Flagg

FlaggBeskrivelse
--daysVis statistikk for de siste N dagene (hele tiden)
--toolsAntall verktøy som skal vises (alle)
--modelsVis oversikt over modellbruk (skjult som standard). Gi et tall for å vise topp N
--projectFiltrer etter prosjekt (alle prosjekter, tom streng: gjeldende prosjekt)

export

Eksporter øktdata som JSON.

Terminal window
opencode export [sessionID]

Hvis du ikke gir en økt ID, blir du bedt om å velge fra tilgjengelige økter.


import

Importer øktdata fra en JSON-fil eller en OpenCode share-URL.

Terminal window
opencode import <file>

Du kan importere fra en lokal fil eller en OpenCode share-URL.

Terminal window
opencode import session.json
opencode import https://opncd.ai/s/abc123

web

Start en hodeløs OpenCode-server med et webgrensesnitt.

Terminal window
opencode web

Dette starter en HTTP-server og åpner en nettleser for å få tilgang til OpenCode via et nettgrensesnitt. Sett OPENCODE_SERVER_PASSWORD for å aktivere HTTP grunnleggende autentisering (brukernavn er standard til opencode).

Flagg

FlaggBeskrivelse
--portPort å lytte på
--hostnameVertsnavn å lytte på
--mdnsAktiver mDNS-oppdagelse
--corsYtterligere nettleseropprinnelse for å tillate CORS

acp

Start en ACP (Agent Client Protocol) server.

Terminal window
opencode acp

Denne kommandoen starter en ACP-server som kommuniserer via stdin/stdout ved å bruke nd-JSON.

Flagg

FlaggBeskrivelse
--cwdArbeidskatalog
--portPort å lytte på
--hostnameVertsnavn å lytte på

uninstall

Avinstaller OpenCode og fjern alle relaterte filer.

Terminal window
opencode uninstall

Flagg

FlaggKortBeskrivelse
--keep-config-cBehold konfigurasjonsfiler
--keep-data-dBehold øktdata og øyeblikksbilder
--dry-runVis hva som ville blitt fjernet uten å fjerne
--force-fHopp over bekreftelsesforespørsler

upgrade

Oppdaterer OpenCode til siste versjon eller en spesifikk versjon.

Terminal window
opencode upgrade [target]

For å oppgradere til siste versjon.

Terminal window
opencode upgrade

For å oppgradere til en bestemt versjon.

Terminal window
opencode upgrade v0.1.48

Flagg

FlaggKortBeskrivelse
--method-mInstallasjonsmetoden som ble brukt: curl, npm, pnpm, bun, brew

Globale flagg

OpenCode CLI bruker følgende globale flagg.

FlaggKortBeskrivelse
--help-hVis hjelp
--version-vSkriv ut versjonsnummer
--print-logsSkriv ut logger til stderr
--log-levelLoggnivå (DEBUG, INFO, WARN, ERROR)

Miljøvariabler

OpenCode kan konfigureres ved hjelp av miljøvariabler.

VariabelTypeBeskrivelse
OPENCODE_AUTO_SHAREboolskDel økter automatisk
OPENCODE_GIT_BASH_PATHstrengBane til Git Bash-kjørbar på Windows
OPENCODE_CONFIGstrengBane til konfigurasjonsfil
OPENCODE_CONFIG_DIRstrengBane til konfigurasjonskatalog
OPENCODE_CONFIG_CONTENTstrengInnebygd json-konfigurasjonsinnhold
OPENCODE_DISABLE_AUTOUPDATEboolskDeaktiver automatiske oppdateringskontroller
OPENCODE_DISABLE_PRUNEboolskDeaktiver beskjæring av gamle data
OPENCODE_DISABLE_TERMINAL_TITLEboolskDeaktiver automatiske terminaltitteloppdateringer
OPENCODE_PERMISSIONstrengInnebygd json-tillatelseskonfigurasjon
OPENCODE_DISABLE_DEFAULT_PLUGINSboolskDeaktiver standard plugins
OPENCODE_DISABLE_LSP_DOWNLOADboolskDeaktiver automatiske LSP servernedlastinger
OPENCODE_ENABLE_EXPERIMENTAL_MODELSboolskAktiver eksperimentelle modeller
OPENCODE_DISABLE_AUTOCOMPACTboolskDeaktiver automatisk kontekstkomprimering
OPENCODE_DISABLE_CLAUDE_CODEboolskDeaktiver lesing fra .claude (spørsmål + ferdigheter)
OPENCODE_DISABLE_CLAUDE_CODE_PROMPTboolskDeaktiver lesing ~/.claude/CLAUDE.md
OPENCODE_DISABLE_CLAUDE_CODE_SKILLSboolskDeaktiver innlasting av .claude/skills
OPENCODE_DISABLE_MODELS_FETCHboolskDeaktiver henting av modeller fra eksterne kilder
OPENCODE_FAKE_VCSstrengFalsk VCS-leverandør for testformål
OPENCODE_DISABLE_FILETIME_CHECKboolskDeaktiver filtidskontroll for optimalisering
OPENCODE_CLIENTstrengKlientidentifikator (standard til cli)
OPENCODE_ENABLE_EXAboolskAktiver Exa-nettsøkeverktøy
OPENCODE_SERVER_PASSWORDstrengAktiver grunnleggende autentisering for serve/web
OPENCODE_SERVER_USERNAMEstrengOverstyr grunnleggende autentiseringsbrukernavn (standard opencode)
OPENCODE_MODELS_URLstrengEgendefinert URL for henting av modellkonfigurasjon

Eksperimentell

Disse miljøvariablene muliggjør eksperimentelle funksjoner som kan endres eller fjernes.

VariabelTypeBeskrivelse
OPENCODE_EXPERIMENTALboolskAktiver alle eksperimentelle funksjoner
OPENCODE_EXPERIMENTAL_ICON_DISCOVERYboolskAktiver ikonoppdagelse
OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECTboolskDeaktiver kopi ved valg i TUI
OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MSnummerStandard tidsavbrudd for bash-kommandoer i ms
OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAXnummerMaks Output Tokens for LLM-svar
OPENCODE_EXPERIMENTAL_FILEWATCHERboolskAktiver filovervåker for hele dir
OPENCODE_EXPERIMENTAL_OXFMTboolskAktiver oxfmt formatter
OPENCODE_EXPERIMENTAL_LSP_TOOLboolskAktiver eksperimentelt LSP-verktøy
OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHERboolskDeaktiver filovervåking
OPENCODE_EXPERIMENTAL_EXAboolskAktiver eksperimentelle Exa-funksjoner
OPENCODE_EXPERIMENTAL_LSP_TYboolskAktiver eksperimentell LSP-typekontroll
OPENCODE_EXPERIMENTAL_MARKDOWNboolskAktiver eksperimentelle Markdown-funksjoner
OPENCODE_EXPERIMENTAL_PLAN_MODEboolskAktiver planmodus