Gå til hovedindhold

Installér og brug OpenCode

OpenCode er et agentisk kodningsværktøj. Værktøjet er tilgængeligt som terminalapplikation, desktopapplikation og IDE-tilføjelse.

AI-School anbefaler OpenCode især til undervisere, administratorer og elever med stor programmeringserfaring. OpenCode kan arbejde mere selvstændigt end Aider og kan derfor hurtigere udføre mange ændringer.

Flere oplysninger findes på OpenCode-webstedet og i den officielle OpenCode-dokumentation.

Hvornår vælger du OpenCode?​

Vælg OpenCode hvis brugeren:

  • har erfaring med terminal, kode-editors og git
  • forstår hvor lokale filer ændres
  • kan kontrollere ændringer før de bruges
  • ønsker at udarbejde mere komplekse programmeringsopgaver

Til klassisk programmering for begyndere er Aider normalt mere passende.

Installér​

Den nemmeste installation ifølge OpenCode-dokumentationen er:

curl -fsSL https://opencode.ai/install | bash

Du kan også installere OpenCode med Node.js:

npm install -g opencode-ai

Eller med Homebrew på macOS og Linux:

brew install anomalyco/tap/opencode

Tilslut med Kodning​

OpenCode understøtter tilpassede OpenAI-kompatible udbydere. Opret en fil opencode.json i projektmappen.

Brug i den fil Coderen-endepunktet og de tilladte modeller:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-school-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-School Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-school-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_SCHOOL_CODEREN_API_KEY}"
      },
      "models": {
        "gpt-5.4-mini": {
          "name": "GPT-5.4 mini"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  },
  "model": "ai-school-coderen/gpt-5.4-mini",
  "small_model": "ai-school-coderen/gpt-5.4-mini"
}

Sæt API-nøglen herefter som en miljøvariabel.

Du kan også bruge en .env-fil i projektmappen:

AI_SCHOOL_CODEREN_API_KEY=ais.dit-api-nøgle

Kontrollér efter åbning af en ny terminal, om OpenCode kan læse denne variabel. Hvis OpenCode ikke sender en nøgle, giver AI-School fejlen, at en Authorization-header med Bearer-token er påkrævet.

macOS og Linux​

export AI_SCHOOL_CODEREN_API_KEY="ais.dit-api-nøgle"

Windows​

setx AI_SCHOOL_CODEREN_API_KEY "ais.dit-api-nøgle"

Åbn derefter en ny terminal.

Start OpenCode​

Gå til projektmappen:

cd sti/til/dit/projekt

Start OpenCode:

opencode

Brug i OpenCode modelvalget til at vælge AI-School Coderen-modellen, hvis det ikke sker automatisk.

Fejlfinding​

Authorization header with Bearer token is required​

Denne fejlmeddelelse betyder normalt, at OpenCode ikke sender en API-nøgle. Kontroller:

  • om AI_SCHOOL_CODEREN_API_KEY hedder præcis sådan
  • om værdien begynder med ais.
  • om du har åbnet en ny terminal efter setx
  • om .env-filen ligger i projektmappen, hvor du starter OpenCode

Unknown parameter​

Nogle værktøjer sender ekstra udbyder-specifikke parametre. Hvis du får en fejl som Unknown parameter, fjern denne indstilling fra OpenCode-konfigurationen eller brug en enklere udbyderkonfiguration. Coderen-endepunktet forventer OpenAI-kompatible chat-forespørgsler med model, beskeder og de sædvanlige basisindstillinger.

Sikkert arbejde med OpenCode​

Da OpenCode er agentisk, er det vigtigt at kontrollere ændringer.

Anbefalet arbejdsgang:

  1. Arbejd i et git-repository.
  2. Start med små opgaver.
  3. Kontroller diffs, før du bruger koden.
  4. Test applikationen efter ændringer.
  5. Commiter kun ændringer, du forstår.

For elever med lidt erfaring er det klogt først at bruge OpenCode demonstrativt under vejledning af en lærer.