301 lines
9.4 KiB
Plaintext
301 lines
9.4 KiB
Plaintext
---
|
|
title: Feilsøking
|
|
description: Vanlige problemer og hvordan de kan løses.
|
|
---
|
|
|
|
For å feilsøke problemer med OpenCode, start med å sjekke loggene og lokale data den lagrer på disken.
|
|
|
|
---
|
|
|
|
## Logger
|
|
|
|
Loggfiler skrives til:
|
|
|
|
- **macOS/Linux**: `~/.local/share/opencode/log/`
|
|
- **Windows**: Trykk `WIN+R` og 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`.
|
|
|
|
---
|
|
|
|
## Lagring
|
|
|
|
opencode lagrer øktdata og andre applikasjonsdata på disken på:
|
|
|
|
- **macOS/Linux**: `~/.local/share/opencode/`
|
|
- **Windows**: Trykk `WIN+R` og lim inn `%USERPROFILE%\.local\share\opencode`
|
|
|
|
Denne katalogen inneholder:
|
|
|
|
- `auth.json` - Autentiseringsdata som API-nøkler, OAuth-tokens
|
|
- `log/` - Applikasjonslogger
|
|
- `project/` - 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/`
|
|
|
|
---
|
|
|
|
## Desktop-app
|
|
|
|
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.
|
|
|
|
### Raske sjekker
|
|
|
|
- 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).
|
|
|
|
---
|
|
|
|
### Deaktiver plugins
|
|
|
|
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+R` og 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:
|
|
|
|
```jsonc
|
|
{
|
|
"$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+R` og lim inn `%USERPROFILE%\.config\opencode\plugins`
|
|
- **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.
|
|
|
|
---
|
|
|
|
### Tøm hurtigbufferen
|
|
|
|
Hvis deaktivering av plugins ikke hjelper (eller en plugin-installasjon sitter fast), tøm hurtigbufferen slik at OpenCode kan gjenoppbygge den.
|
|
|
|
1. Avslutt OpenCode Desktop helt.
|
|
2. Slett hurtigbufferkatalogen:
|
|
|
|
- **macOS**: Finder -> `Cmd+Shift+G` -> lim inn `~/.cache/opencode`
|
|
- **Linux**: slett `~/.cache/opencode` (eller kjør `rm -rf ~/.cache/opencode`)
|
|
- **Windows**: Trykk `WIN+R` og lim inn `%USERPROFILE%\.cache\opencode`
|
|
|
|
3. Start OpenCode Desktop på nytt.
|
|
|
|
---
|
|
|
|
### Løs problemer med servertilkobling
|
|
|
|
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 standardserveren for skrivebordet 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.
|
|
|
|
---
|
|
|
|
### Linux: Wayland / X11 problemer
|
|
|
|
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.
|
|
|
|
---
|
|
|
|
### Windows: WebView2 kjøretid
|
|
|
|
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.
|
|
|
|
---
|
|
|
|
### Windows: Generelle ytelsesproblemer
|
|
|
|
Hvis du opplever treg ytelse, problemer med filtilgang eller terminalproblemer på Windows, kan du prøve å bruke [WSL (Windows Subsystem for Linux)](/docs/windows-wsl). WSL gir et Linux-miljø som fungerer mer sømløst med funksjonene til OpenCode.
|
|
|
|
---
|
|
|
|
### Varsler vises ikke
|
|
|
|
OpenCode Desktop viser bare systemvarsler når:
|
|
|
|
- varsler er aktivert for OpenCode i OS-innstillingene dine, og
|
|
- appvinduet er ikke fokusert.
|
|
|
|
---
|
|
|
|
### Tilbakestill skrivebordsapplagring (siste utvei)
|
|
|
|
Hvis appen ikke starter og du ikke kan slette innstillingene fra UI, tilbakestill skrivebordsappens lagrede tilstand.
|
|
|
|
1. Avslutt OpenCode Desktop.
|
|
2. Finn og slett disse filene (de finnes i OpenCode Desktop-appens datakatalog):
|
|
|
|
- `opencode.settings.dat` (stasjonær standardserver URL)
|
|
- `opencode.global.dat` og `opencode.workspace.*.dat` (UI tilstand som nylige servere/prosjekter)
|
|
|
|
Slik finner du katalogen raskt:
|
|
|
|
- **macOS**: Finder -> `Cmd+Shift+G` -> `~/Library/Application Support` (søk deretter etter filnavnene ovenfor)
|
|
- **Linux**: søk under `~/.local/share` etter filnavnene ovenfor
|
|
- **Windows**: Trykk `WIN+R` -> `%APPDATA%` (søk deretter etter filnavnene ovenfor)
|
|
|
|
---
|
|
|
|
## Får hjelp
|
|
|
|
Hvis du opplever problemer med OpenCode:
|
|
|
|
1. **Rapporter problemer på GitHub**
|
|
|
|
Den beste måten å rapportere feil eller be om funksjoner på er gjennom vårt GitHub-lager:
|
|
|
|
[**github.com/anomalyco/opencode/issues**](https://github.com/anomalyco/opencode/issues)
|
|
|
|
Før du oppretter et nytt problem, søk i eksisterende problemer for å se om problemet ditt allerede er rapportert.
|
|
|
|
2. **Bli med i vår Discord**
|
|
|
|
For sanntidshjelp og fellesskapsdiskusjon, bli med i vår Discord-server:
|
|
|
|
[**opencode.ai/discord**](https://opencode.ai/discord)
|
|
|
|
---
|
|
|
|
## Vanlige problemer
|
|
|
|
Her er noen vanlige problemer og hvordan du kan løse dem.
|
|
|
|
---
|
|
|
|
### OpenCode vil ikke starte
|
|
|
|
1. Sjekk loggene for feilmeldinger
|
|
2. Prøv å kjøre med `--print-logs` for å se utdata i terminalen
|
|
3. Sørg for at du har den nyeste versjonen med `opencode upgrade`
|
|
|
|
---
|
|
|
|
### Autentiseringsproblemer
|
|
|
|
1. Prøv å autentisere på nytt med kommandoen `/connect` i TUI
|
|
2. Sjekk at API-nøklene dine er gyldige
|
|
3. Sørg for at nettverket ditt tillater tilkoblinger til leverandørens API
|
|
|
|
---
|
|
|
|
### Modellen er ikke tilgjengelig
|
|
|
|
1. Sjekk at du har autentisert deg med leverandøren
|
|
2. Kontroller at modellnavnet i konfigurasjonen er riktig
|
|
3. Noen modeller kan kreve spesifikk tilgang eller abonnement
|
|
|
|
Hvis du støter på `ProviderModelNotFoundError` er du mest sannsynlig feil
|
|
refererer til en modell et sted.
|
|
Modeller skal refereres slik: `<providerId>/<modelId>`
|
|
|
|
Eksempler:
|
|
|
|
- `openai/gpt-4.1`
|
|
- `openrouter/google/gemini-2.5-flash`
|
|
- `opencode/kimi-k2`
|
|
|
|
For å finne ut hvilke modeller du har tilgang til, kjør `opencode models`
|
|
|
|
---
|
|
|
|
### ProviderInitError
|
|
|
|
Hvis du støter på en ProviderInitError, har du sannsynligvis en ugyldig eller ødelagt konfigurasjon.
|
|
|
|
For å løse dette:
|
|
|
|
1. Kontroller først at leverandøren din er riktig konfigurert ved å følge [leverandørveiledningen](/docs/providers)
|
|
2. Hvis problemet vedvarer, prøv å tømme den lagrede konfigurasjonen:
|
|
|
|
```bash
|
|
rm -rf ~/.local/share/opencode
|
|
```
|
|
|
|
På Windows, trykk `WIN+R` og slett: `%USERPROFILE%\.local\share\opencode`
|
|
|
|
3. Autentiser på nytt med leverandøren din ved å bruke kommandoen `/connect` i TUI.
|
|
|
|
---
|
|
|
|
### AI_APICallError og leverandørpakkeproblemer
|
|
|
|
Hvis du støter på API anropsfeil, kan dette skyldes utdaterte leverandørpakker. opencode installerer dynamisk leverandørpakker (OpenAI, Anthropic, Google, etc.) etter behov og cacher dem lokalt.
|
|
|
|
For å løse problemer med leverandørpakke:
|
|
|
|
1. Tøm leverandørens pakkebuffer:
|
|
|
|
```bash
|
|
rm -rf ~/.cache/opencode
|
|
```
|
|
|
|
På Windows, trykk `WIN+R` og slett: `%USERPROFILE%\.cache\opencode`
|
|
|
|
2. Start opencode på nytt for å installere de nyeste leverandørpakkene på nytt
|
|
|
|
Dette vil tvinge opencode til å laste ned de nyeste versjonene av leverandørpakkene, som ofte løser kompatibilitetsproblemer med modellparametere og API endringer.
|
|
|
|
---
|
|
|
|
### Kopier/lim inn fungerer ikke på Linux
|
|
|
|
Linux-brukere må ha ett av følgende utklippstavleverktøy installert for at kopier/lim inn-funksjonalitet skal fungere:
|
|
|
|
**For X11-systemer:**
|
|
|
|
```bash
|
|
apt install -y xclip
|
|
# or
|
|
apt install -y xsel
|
|
```
|
|
|
|
**For Wayland-systemer:**
|
|
|
|
```bash
|
|
apt install -y wl-clipboard
|
|
```
|
|
|
|
**For hodeløse miljøer:**
|
|
|
|
```bash
|
|
apt install -y xvfb
|
|
# and run:
|
|
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
|
|
export DISPLAY=:99.0
|
|
```
|
|
|
|
opencode vil oppdage om du bruker Wayland og foretrekker `wl-clipboard`, ellers vil den prøve å finne utklippstavleverktøy i rekkefølgen: `xclip` og `xsel`.
|