cli.mdx 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603
  1. ---
  2. title: CLI
  3. description: OpenCode CLI muligheder og kommandoer.
  4. ---
  5. import { Tabs, TabItem } from "@astrojs/starlight/components"
  6. OpenCode CLI starter som standard [TUI](/docs/tui), når den kører uden nogen argumenter.
  7. ```bash
  8. opencode
  9. ```
  10. Men den accepterer også kommandoer som dokumenteret på denne side. Dette giver dig mulighed for at interagere med OpenCode programmatisk.
  11. ```bash
  12. opencode run "Explain how closures work in JavaScript"
  13. ```
  14. ---
  15. ### tui
  16. Start OpenCode terminalbrugergrænsefladen.
  17. ```bash
  18. opencode [project]
  19. ```
  20. #### Flags
  21. | Flag | Kort | Beskrivelse |
  22. | ------------ | ---- | ---------------------------------------------------------------------------- |
  23. | `--continue` | `-c` | Fortsæt sidste session |
  24. | `--session` | `-s` | Sessions-id for at fortsætte |
  25. | `--fork` | | Forgren sessionen ved fortsættelse (brug med `--continue` eller `--session`) |
  26. | `--prompt` | | Spørg om at bruge |
  27. | `--model` | `-m` | Model til brug i form af provider/model |
  28. | `--agent` | | Agent hos bruge |
  29. | `--port` | | Port at lytte på |
  30. | `--hostname` | | Værtsnavn at lytte på |
  31. ---
  32. ## Kommandoer
  33. OpenCode CLI har også følgende kommandoer.
  34. ---
  35. ### agent
  36. Administrer agenter i OpenCode.
  37. ```bash
  38. opencode agent [command]
  39. ```
  40. ---
  41. ### attach
  42. Tilslut en terminal til en allerede kørende OpenCode backend-server startet via `serve` eller `web` kommandoer.
  43. ```bash
  44. opencode attach [url]
  45. ```
  46. Dette gør det muligt at bruge TUI med en ekstern OpenCode backend. For eksempel:
  47. ```bash
  48. # Start the backend server for web/mobile access
  49. opencode web --port 4096 --hostname 0.0.0.0
  50. # In another terminal, attach the TUI to the running backend
  51. opencode attach http://10.20.30.40:4096
  52. ```
  53. #### Flags
  54. | Flag | Kort | Beskrivelse |
  55. | ----------- | ---- | -------------------------------- |
  56. | `--dir` | | Arbejdsmappe til at starte TUI i |
  57. | `--session` | `-s` | Sessions-id for at fortsætte |
  58. ---
  59. #### create
  60. Opret en ny agent med brugerdefineret konfiguration.
  61. ```bash
  62. opencode agent create
  63. ```
  64. Denne kommando vil guide dig gennem oprettelse af en ny agent med en brugerdefineret systemprompt og værktøjskonfiguration.
  65. ---
  66. #### list
  67. Liste over alle tilgængelige agenter.
  68. ```bash
  69. opencode agent list
  70. ```
  71. ---
  72. ### auth
  73. Kommando til at administrere legitimationsoplysninger og login for udbydere.
  74. ```bash
  75. opencode auth [command]
  76. ```
  77. ---
  78. #### login
  79. OpenCode drives af udbyderlisten på [Models.dev](https://models.dev), så du kan bruge `opencode auth login` til at konfigurere API-nøgler for enhver udbyder, du vil bruge. Dette er gemt i `~/.local/share/opencode/auth.json`.
  80. ```bash
  81. opencode auth login
  82. ```
  83. Når OpenCode starter op, indlæser den udbyderne fra legitimationsfilen. Og hvis der er nogen nøgler defineret i dine miljøer eller en `.env` fil i dit projekt.
  84. ---
  85. #### list
  86. Viser alle de godkendte udbydere som gemt i legitimationsfilen.
  87. ```bash
  88. opencode auth list
  89. ```
  90. Eller den korte version.
  91. ```bash
  92. opencode auth ls
  93. ```
  94. ---
  95. #### logout
  96. Logger dig ud af en udbyder ved at rydde den fra legitimationsfilen.
  97. ```bash
  98. opencode auth logout
  99. ```
  100. ---
  101. ### github
  102. Administrator GitHub-agenten til lagerautomatisering.
  103. ```bash
  104. opencode github [command]
  105. ```
  106. ---
  107. #### install
  108. Installatør GitHub-agenten i dit lager.
  109. ```bash
  110. opencode github install
  111. ```
  112. Dette opsætter det nødvendige GitHub Actions workflow og guider dig gennem konfigurationsprocessen. [Learn more](/docs/github).
  113. ---
  114. #### run
  115. Kør GitHub-agenten. Dette bruges typisk i GitHub Actions.
  116. ```bash
  117. opencode github run
  118. ```
  119. ##### Flags
  120. | Flag | Beskrivelse |
  121. | --------- | ---------------------------------------------- |
  122. | `--event` | GitHub mock begivenhed for at køre agenten for |
  123. | `--token` | GitHub personlig adgangstoken |
  124. ---
  125. ### mcp
  126. Administrator Model Context Protocol-servere.
  127. ```bash
  128. opencode mcp [command]
  129. ```
  130. ---
  131. #### add
  132. Tilføj en MCP-server til din konfiguration.
  133. ```bash
  134. opencode mcp add
  135. ```
  136. Denne kommando vil guide dig gennem tilføjelse af enten en lokal eller ekstern MCP-server.
  137. ---
  138. #### list
  139. Liste over alle konfigurerede MCP-servere og deres forbindelsesstatus.
  140. ```bash
  141. opencode mcp list
  142. ```
  143. Eller brug den korte version.
  144. ```bash
  145. opencode mcp ls
  146. ```
  147. ---
  148. #### auth
  149. Godkendt med en OAuth-aktiveret MCP-server.
  150. ```bash
  151. opencode mcp auth [name]
  152. ```
  153. Hvis du ikke angiver et servernavn, bliver du bedt om at vælge blandt tilgængelige OAuth-kompatible servere.
  154. Du kan også angive OAuth-kompatible servere og deres godkendelsesstatus.
  155. ```bash
  156. opencode mcp auth list
  157. ```
  158. Eller brug den korte version.
  159. ```bash
  160. opencode mcp auth ls
  161. ```
  162. ---
  163. #### logout
  164. Fjern OAuth-legitimationsoplysninger for en MCP-server.
  165. ```bash
  166. opencode mcp logout [name]
  167. ```
  168. ---
  169. #### debug
  170. Fejlfinding af OAuth-forbindelsesproblemer for en MCP-server.
  171. ```bash
  172. opencode mcp debug <name>
  173. ```
  174. ---
  175. ### models
  176. Liste over alle tilgængelige modeller fra konfigurerede udbydere.
  177. ```bash
  178. opencode models [provider]
  179. ```
  180. Denne kommando viser alle tilgængelige modeller på tværs af dine konfigurerede udbydere i formatet `provider/model`.
  181. Dette er nyttigt til at finde ud af det nøjagtige modelnavn, der skal bruges i [your config](/docs/config/).
  182. Du kan eventuelt videregive et udbyder-id for at filtrere modeller efter den udbyder.
  183. ```bash
  184. opencode models anthropic
  185. ```
  186. #### Flags
  187. | Flag | Beskrivelse |
  188. | ----------- | ----------------------------------------------------------------------- |
  189. | `--refresh` | Opdater modelcachen fra models.dev |
  190. | `--verbose` | Brug mere detaljeret modeloutput (inkluderer metadata som omkostninger) |
  191. Brug flaget `--refresh` til at opdatere den cachelagrede modelliste. Dette er nyttigt, når nye modeller er blevet tilføjet til en udbyder, og du vil se dem i OpenCode.
  192. ```bash
  193. opencode models --refresh
  194. ```
  195. ---
  196. ### run
  197. Kør opencode i ikke-interaktiv tilstand ved at sende en prompt direkte.
  198. ```bash
  199. opencode run [message..]
  200. ```
  201. Dette er nyttigt til scripting, automatisering, eller når du vil have et hurtigt svar uden at starte hele TUI. F.eks.
  202. ```bash "opencode run"
  203. opencode run Explain the use of context in Go
  204. ```
  205. Du kan også vedhæfte til en kørende `opencode serve`-instans for at undgå MCP serverens kolde opstartstider ved hver kørsel:
  206. ```bash
  207. # Start a headless server in one terminal
  208. opencode serve
  209. # In another terminal, run commands that attach to it
  210. opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"
  211. ```
  212. #### Flags
  213. | Flag | Kort | Beskrivelse |
  214. | ------------ | ---- | ----------------------------------------------------------------------------------- |
  215. | `--command` | | Kommandoen til at køre, brug besked til args |
  216. | `--continue` | `-c` | Fortsæt sidste session |
  217. | `--session` | `-s` | Sessions-id for at fortsætte |
  218. | `--fork` | | Forgren sessionen ved fortsættelse (brug med `--continue` eller `--session`) |
  219. | `--share` | | Del sessionen |
  220. | `--model` | `-m` | Model til brug i form af provider/model |
  221. | `--agent` | | Agent til brug |
  222. | `--file` | `-f` | Fil(er), der skal vedhæftes til meddelelsen |
  223. | `--format` | | Format: standard (formateret) eller json (rå JSON hændelser) |
  224. | `--title` | | Titel for sessionen (bruger trunkeret prompt, hvis der ikke er angivet nogen værdi) |
  225. | `--attach` | | Tilslut til en kørende opencode-server (f.eks. http://localhost:4096) |
  226. | `--port` | | Port til den lokale server (standard til vilkårlig port) |
  227. ---
  228. ### serve
  229. Start en hovedløs OpenCode-server til API-adgang. Tjek [server docs](/docs/server) for den fulde HTTP-grænseflade.
  230. ```bash
  231. opencode serve
  232. ```
  233. Dette starter en HTTP-server, der giver API-adgang til opencode-funktionalitet uden TUI-grænsefladen. Indstil `OPENCODE_SERVER_PASSWORD` for at aktivere HTTP grundlæggende godkendelse (brugernavn er standard til `opencode`).
  234. #### Flags
  235. | Flag | Beskrivelse |
  236. | ------------ | ------------------------------------------------ |
  237. | `--port` | Port at lytte på |
  238. | `--hostname` | Værtsnavn at lytte på |
  239. | `--mdns` | Aktiver mDNS-opdagelse |
  240. | `--cors` | Yderligere browseroprindelse til at tillade CORS |
  241. ---
  242. ### session
  243. Administrator OpenCode sessionsholder.
  244. ```bash
  245. opencode session [command]
  246. ```
  247. ---
  248. #### list
  249. Liste over alle OpenCode sessioner.
  250. ```bash
  251. opencode session list
  252. ```
  253. ##### Flags
  254. | Flag | Kort | Beskrivelse |
  255. | ------------- | ---- | -------------------------------------- |
  256. | `--max-count` | `-n` | Begræns til N seneste sessioner |
  257. | `--format` | | Outputformat: tabel eller json (tabel) |
  258. ---
  259. ### stats
  260. Vis tokenbrug og omkostningsstatistikker for dine OpenCode-sessioner.
  261. ```bash
  262. opencode stats
  263. ```
  264. #### Flags
  265. | Flag | Beskrivelse |
  266. | ----------- | --------------------------------------------------------------------------- |
  267. | `--days` | Vis statistik for de sidste N dage (hele tiden) |
  268. | `--tools` | Antal værktøjer, der skal vises (alle) |
  269. | `--models` | Vis modelbrugsopdeling (skjult som standard). Send et tal for at vise top N |
  270. | `--project` | Filtre efter projekt (alle projekter, tom streng: nuværende projekt) |
  271. ---
  272. ### export
  273. Eksporter sessionsdata som JSON.
  274. ```bash
  275. opencode export [sessionID]
  276. ```
  277. Hvis du ikke angiver et sessions-id, bliver du bedt om at vælge mellem tilgængelige sessioner.
  278. ---
  279. ### import
  280. Importer sessionsdata fra en JSON fil eller OpenCode del URL.
  281. ```bash
  282. opencode import <file>
  283. ```
  284. Du kan importere fra en lokal fil eller en OpenCode share URL.
  285. ```bash
  286. opencode import session.json
  287. opencode import https://opncd.ai/s/abc123
  288. ```
  289. ---
  290. ### web
  291. Start en hovedløs OpenCode-server med en webgrænseflade.
  292. ```bash
  293. opencode web
  294. ```
  295. Dette starter en HTTP-server og åbner en webbrowser for at få adgang til OpenCode via en webgrænseflade. Indstil `OPENCODE_SERVER_PASSWORD` for at aktivere HTTP grundlæggende godkendelse (brugernavn er standard til `opencode`).
  296. #### Flags
  297. | Flag | Beskrivelse |
  298. | ------------ | ------------------------------------------------ |
  299. | `--port` | Port at lytte på |
  300. | `--hostname` | Værtsnavn at lytte på |
  301. | `--mdns` | Aktiver mDNS-opdagelse |
  302. | `--cors` | Yderligere browseroprindelse til at tillade CORS |
  303. ---
  304. ### acp
  305. Start en ACP-server (Agent Client Protocol).
  306. ```bash
  307. opencode acp
  308. ```
  309. Denne kommando starter en ACP-server, der kommunikerer via stdin/stdout ved hjælp af nd-JSON.
  310. #### Flags
  311. | Flag | Beskrivelse |
  312. | ------------ | --------------------- |
  313. | `--cwd` | Arbejdsmappe |
  314. | `--port` | Port at lytte på |
  315. | `--hostname` | Værtsnavn at lytte på |
  316. ---
  317. ### uninstall
  318. Afinstaller OpenCode og fjern alle relaterede filer.
  319. ```bash
  320. opencode uninstall
  321. ```
  322. #### Flags
  323. | Flag | Kort | Beskrivelse |
  324. | --------------- | ---- | ------------------------------------------------ |
  325. | `--keep-config` | `-c` | Se konfigurationsfiler |
  326. | `--keep-data` | `-d` | Gem sessionsdata og snapshots |
  327. | `--dry-run` | | Vis, hvad der ville blive fjernet uden at fjerne |
  328. | `--force` | `-f` | Spring bekræftelsesspørgsmål over |
  329. ---
  330. ### upgrade
  331. Opdaterer OpenCode til den nyeste version eller en specifik version.
  332. ```bash
  333. opencode upgrade [target]
  334. ```
  335. For at opgradere til den nyeste version.
  336. ```bash
  337. opencode upgrade
  338. ```
  339. For at opgradere til en bestemt version.
  340. ```bash
  341. opencode upgrade v0.1.48
  342. ```
  343. #### upgrade
  344. | Flag | Kort | Beskrivelse |
  345. | ---------- | ---- | ---------------------------------------------------------------- |
  346. | `--method` | `-m` | Installationsmetoden, der blev brugt; curl, npm, pnpm, bun, brew |
  347. ---
  348. ## Globalt flag
  349. opencode CLI tager følgende globale flag.
  350. | Flag | Kort | Beskrivelse |
  351. | -------------- | ---- | ------------------------------------ |
  352. | `--help` | `-h` | Vis hjælp |
  353. | `--version` | `-v` | Udskriftsversionsnummer |
  354. | `--print-logs` | | Udskriv logfiler til stderr |
  355. | `--log-level` | | Logniveau (DEBUG, INFO, WARN, ERROR) |
  356. ---
  357. ## Miljøvariabler
  358. OpenCode kan konfigureres ved hjælp af miljøvariabler.
  359. | Variabel | Skriv | Beskrivelse |
  360. | ------------------------------------- | ------- | --------------------------------------------------------------------- |
  361. | `OPENCODE_AUTO_SHARE` | boolean | Del automatisk session |
  362. | `OPENCODE_GIT_BASH_PATH` | string | Sti til Git Bash eksekverbar på Windows |
  363. | `OPENCODE_CONFIG` | string | Sti til konfigurationsfil |
  364. | `OPENCODE_CONFIG_DIR` | string | Sti til konfigurationsmappe |
  365. | `OPENCODE_CONFIG_CONTENT` | string | Indbygget json-konfigurationsindhold |
  366. | `OPENCODE_DISABLE_AUTOUPDATE` | boolean | Deaktiver automatisk opdateringskontrol |
  367. | `OPENCODE_DISABLE_PRUNE` | boolean | Deaktiver beskæring af gamle data |
  368. | `OPENCODE_DISABLE_TERMINAL_TITLE` | boolean | Deaktiver automatisk opdatering af terminaltitel |
  369. | `OPENCODE_PERMISSION` | string | Indbygget json-tilladelseskonfiguration |
  370. | `OPENCODE_DISABLE_DEFAULT_PLUGINS` | boolean | Deaktiver standard plugins |
  371. | `OPENCODE_DISABLE_LSP_DOWNLOAD` | boolean | Deaktiver automatisk LSP-serverdownloads |
  372. | `OPENCODE_ENABLE_EXPERIMENTAL_MODELS` | boolean | Aktive eksperimentelle modeller |
  373. | `OPENCODE_DISABLE_AUTOCOMPACT` | boolean | Deaktiver automatisk kontekstkomprimering |
  374. | `OPENCODE_DISABLE_CLAUDE_CODE` | boolean | Deaktiver læsning fra `.claude` (prompt + færdigheder) |
  375. | `OPENCODE_DISABLE_CLAUDE_CODE_PROMPT` | boolean | Deaktiver læsning `~/.claude/CLAUDE.md` |
  376. | `OPENCODE_DISABLE_CLAUDE_CODE_SKILLS` | boolean | Deaktiver indlæsning af `.claude/skills` |
  377. | `OPENCODE_DISABLE_MODELS_FETCH` | boolean | Deaktivering af modeller fra eksterne kilder |
  378. | `OPENCODE_FAKE_VCS` | string | Falsk VCS-udbyder til testformål |
  379. | `OPENCODE_DISABLE_FILETIME_CHECK` | boolean | Deaktiver filtidskontrol for optimering |
  380. | `OPENCODE_CLIENT` | string | Klient-id (standard til `cli`) |
  381. | `OPENCODE_ENABLE_EXA` | boolean | Aktiver Exa-websøgeværktøjer |
  382. | `OPENCODE_SERVER_PASSWORD` | string | Aktiver grundlæggende godkendelse for `serve`/`web` |
  383. | `OPENCODE_SERVER_USERNAME` | string | Tilsidesæt grundlæggende godkendelsesbrugernavn (standard `opencode`) |
  384. | `OPENCODE_MODELS_URL` | string | Brugerdefineret URL til hentning af modelkonfiguration |
  385. ---
  386. ### Flags
  387. Disse miljøvariabler muliggør eksperimentelle funktioner, der kan ændres eller fjernes.
  388. | Variabel | Skriv | Beskrivelse |
  389. | ----------------------------------------------- | ------- | ------------------------------------------ |
  390. | `OPENCODE_EXPERIMENTAL` | boolean | Aktiver alle eksperimentelle funktioner |
  391. | `OPENCODE_EXPERIMENTAL_ICON_DISCOVERY` | boolean | Aktiver ikonopdagelse |
  392. | `OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT` | boolean | Deaktiver kopi ved valg i TUI |
  393. | `OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS` | nummer | Standard timeout for bash-kommandoer i ms |
  394. | `OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX` | nummer | Maks. output-tokens for LLM-svar |
  395. | `OPENCODE_EXPERIMENTAL_FILEWATCHER` | boolean | Aktiver filovervågning for hele dir |
  396. | `OPENCODE_EXPERIMENTAL_OXFMT` | boolean | Aktiver oxfmt formatter |
  397. | `OPENCODE_EXPERIMENTAL_LSP_TOOL` | boolean | Aktive eksperimenter LSP værktøj |
  398. | `OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER` | boolean | Deaktiver filovervågning |
  399. | `OPENCODE_EXPERIMENTAL_EXA` | boolean | Aktive eksperimenter Exa-funktioner |
  400. | `OPENCODE_EXPERIMENTAL_LSP_TY` | boolean | Aktive forsøg LSP typekontrol |
  401. | `OPENCODE_EXPERIMENTAL_MARKDOWN` | boolean | Aktive eksperimentelle markdown-funktioner |
  402. | `OPENCODE_EXPERIMENTAL_PLAN_MODE` | boolean | Aktiver plantilstand |