Feilsøking
For å feilsøke problemer med OpenCode, start med å sjekke loggene og lokale data den lagrer på disken.
Loggfiler skrives til:
- macOS/Linux:
~/.local/share/opencode/log/ - Windows: Trykk
WIN+Rog lim inn%USERPROFILE%\.local\share\opencode\log
Loggfiler navngis med tidsstempler (f.eks. 2025-01-09T123456.log) og de siste 10 loggfilene beholdes.
Du kan angi loggnivået med kommandolinjealternativet --log-level for å få mer detaljert feilsøkingsinformasjon. For eksempel opencode --log-level DEBUG.
OpenCode lagrer øktdata og andre applikasjonsdata på disken på:
- macOS/Linux:
~/.local/share/opencode/ - Windows: Trykk
WIN+Rog lim inn%USERPROFILE%\.local\share\opencode
Denne katalogen inneholder:
auth.json- Autentiseringsdata som API-nøkler, OAuth-tokenslog/- Applikasjonsloggerproject/- Prosjektspesifikke data som økt- og meldingsdata- Hvis prosjektet er innenfor en Git-repo, lagres det i
./<project-slug>/storage/ - Hvis det ikke er en Git-repo, lagres det i
./global/storage/
- Hvis prosjektet er innenfor en Git-repo, lagres det i
OpenCode Desktop kjører en lokal OpenCode-server (opencode-cli sidevognen) i bakgrunnen. De fleste problemene er forårsaket av en plugin som fungerer dårlig, en ødelagt cache eller en dårlig serverinnstilling.
- Avslutt og start appen på nytt.
- Hvis appen viser en feilskjerm, klikker du på Start på nytt og kopierer feildetaljene.
- Bare macOS:
OpenCode-meny -> Last nettvisning på nytt (hjelper hvis UI er tom/frosset).
Hvis skrivebordsappen krasjer ved oppstart, henger eller oppfører seg merkelig, start med å deaktivere plugins.
Sjekk den globale konfigurasjonen
Åpne den globale konfigurasjonsfilen og se etter en plugin-nøkkel.
- macOS/Linux:
~/.config/opencode/opencode.jsonc(eller~/.config/opencode/opencode.json) - macOS/Linux (eldre installasjoner):
~/.local/share/opencode/opencode.jsonc - Windows: Trykk
WIN+Rog lim inn%USERPROFILE%\.config\opencode\opencode.jsonc
Hvis du har konfigurert plugins, deaktiver dem midlertidig ved å fjerne nøkkelen eller sette den til en tom matrise:
{
"$schema": "https://opencode.ai/config.json",
"plugin": [],
}Sjekk plugin-kataloger
OpenCode kan også laste lokale plugins fra disken. Flytt disse midlertidig ut av veien (eller gi nytt navn til mappen) og start skrivebordsappen på nytt:
- Globale plugins
- macOS/Linux:
~/.config/opencode/plugins/ - Windows: Trykk
WIN+Rog lim inn%USERPROFILE%\.config\opencode\plugins
- macOS/Linux:
- Prosjektplugins (bare hvis du bruker konfigurasjon per prosjekt)
<your-project>/.opencode/plugins/
Hvis appen begynner å fungere igjen, aktiverer du plugins én om gangen for å finne ut hvilken som forårsaker problemet.
Hvis deaktivering av plugins ikke hjelper (eller en plugin-installasjon sitter fast), tøm hurtigbufferen slik at OpenCode kan gjenoppbygge den.
- Avslutt OpenCode Desktop helt.
- Slett hurtigbufferkatalogen:
- macOS: Finder ->
Cmd+Shift+G-> lim inn~/.cache/opencode - Linux: slett
~/.cache/opencode(eller kjørrm -rf ~/.cache/opencode) - Windows: Trykk
WIN+Rog lim inn%USERPROFILE%\.cache\opencode
- Start OpenCode Desktop på nytt.
OpenCode Desktop kan enten starte sin egen lokale server (standard) eller koble til en server URL du har konfigurert.
Hvis du ser en “Tilkobling mislyktes”-dialogboks (eller appen kommer aldri forbi splash-skjermen), se etter en tilpasset server URL.
Slett skrivebordsappens standardserver-URL
Fra startskjermen klikker du på servernavnet (med statusprikken) for å åpne servervelgeren. I delen Standardserver klikker du på Slett.
Fjern server.port / server.hostname fra konfigurasjonen din
Hvis opencode.json(c) inneholder en server-del, fjern den midlertidig og start skrivebordsappen på nytt.
Sjekk miljøvariabler
Hvis du har OPENCODE_PORT satt i miljøet ditt, vil skrivebordsappen prøve å bruke den porten for den lokale serveren.
- Deaktiver
OPENCODE_PORT(eller velg en ledig port) og start på nytt.
På Linux kan noen Wayland-oppsett forårsake tomme vinduer eller kompositorfeil.
- Hvis du er på Wayland og appen er tom/krasj, prøv å starte med
OC_ALLOW_WAYLAND=1. - Hvis det gjør ting verre, fjern det og prøv å starte under en X11-økt i stedet.
På Windows krever OpenCode Desktop Microsoft Edge WebView2 Runtime. Hvis appen åpnes i et tomt vindu eller ikke starter, installer/oppdater WebView2 og prøv igjen.
Hvis du opplever treg ytelse, problemer med filtilgang eller terminalproblemer på Windows, kan du prøve å bruke WSL (Windows Subsystem for Linux). WSL gir et Linux-miljø som fungerer mer sømløst med funksjonene til OpenCode.
OpenCode Desktop viser bare systemvarsler når:
- varsler er aktivert for OpenCode i OS-innstillingene dine, og
- appvinduet er ikke fokusert.
Hvis appen ikke starter og du ikke kan slette innstillingene fra UI-et, tilbakestill skrivebordsappens lagrede tilstand.
- Avslutt OpenCode Desktop.
- Finn og slett disse filene (de finnes i OpenCode Desktop-appens datakatalog):
opencode.settings.dat(stasjonær standardserver URL)opencode.global.datogopencode.workspace.*.dat(UI tilstand som nylige servere/prosjekter)
- Sjekk at du har autentisert deg med leverandøren
- Kontroller at modellnavnet i konfigurasjonen er riktig
- Noen modeller kan kreve spesifikk tilgang eller abonnement
Hvis du støter på ProviderModelNotFoundError refererer du mest sannsynlig feil
til en modell et sted.
Modeller skal refereres slik: <providerId>/<modelId>
Hvis du støter på API-anropsfeil, kan dette skyldes utdaterte provider-pakker. OpenCode installerer dynamisk provider-pakker (OpenAI, Anthropic, Google, etc.) etter behov og cacher dem lokalt.
For å løse problemer med leverandørpakke:
-
Tøm leverandørens pakkebuffer:
Terminalrm -rf ~/.cache/opencodePå Windows, trykk
WIN+Rog slett:%USERPROFILE%\.cache\opencode -
Start OpenCode på nytt for å installere de nyeste provider-pakkene på nytt
Dette vil tvinge OpenCode til å laste ned de nyeste versjonene av provider-pakkene, som ofte løser kompatibilitetsproblemer med modellparametere og API-endringer.
Linux-brukere må ha ett av følgende utklippstavle-verktøy installert for at kopier/lim inn-funksjonalitet skal fungere:
For X11-systemer:
apt install -y xclip
# or
apt install -y xselFor Wayland-systemer:
apt install -y wl-clipboardFor headless-miljøer:
apt install -y xvfb
# and run:
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0OpenCode vil oppdage om du bruker Wayland og foretrekker wl-clipboard, ellers vil den prøve å finne utklippstavle-verktøy i rekkefølgen: xclip og xsel.