Gå till huvudinnehållet

Installera och använda OpenCode

OpenCode är ett agentiskt kodningsverktyg. Verktyget finns som terminalapplikation, skrivbordsmotor och IDE-tillägg.

AI-School rekommenderar OpenCode främst för lärare, administratörer och elever med mycket programmeringserfarenhet. OpenCode kan arbeta mer självständigt än Aider och kan därför snabbare utföra många ändringar.

Mer information finns på OpenCode-webbplatsen och i den officiella OpenCode-dokumentationen.

När väljer du OpenCode?​

Välj OpenCode om användaren:

  • har erfarenhet av terminal, kodredigerare och git
  • förstår hur lokala filer ändras
  • kan kontrollera ändringar innan de används
  • vill arbeta med mer komplexa programmeringsuppgifter

För klassrumsbaserad programmering med nybörjare är Aider oftast mer lämplig.

Installera​

Den enklaste installationen enligt OpenCode-dokumentationen är:

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

Du kan också installera OpenCode med Node.js:

npm install -g opencode-ai

Eller med Homebrew på macOS och Linux:

brew install anomalyco/tap/opencode

Ansluta till Kodning​

OpenCode stöder anpassade OpenAI-kompatibla leverantörer. Skapa i projektmappen en fil opencode.json.

Använd där Coderen-endpointen och de tillåtna modellerna:

{
  "$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"
}

Kopiera API-nyckeln sedan som en miljövariabel.

Du kan också använda en .env-fil i projektmappen:

AI_SCHOOL_CODEREN_API_KEY=ais.din-api-nyckel

Kontrollera efter öppning av en ny terminal om OpenCode kan läsa denna variabel. Om OpenCode inte skickar någon nyckel, visar AI-School felmeddelandet att enAuthorization header med Bearer-token är obligatorisk.

macOS och Linux​

export AI_SCHOOL_CODEREN_API_KEY="ais.din-api-nyckel"

Windows​

setx AI_SCHOOL_CODEREN_API_KEY "ais.din-api-nyckel"

Öppna sedan en ny terminal.

Starta OpenCode​

Gå till projektmappen:

cd sökväg/till/ditt/projekt

Starta OpenCode:

opencode

Använd i OpenCode modellvalet för att välja AI-School Coderen-modellen om det inte görs automatiskt.

Felsökning​

Authorization header med Bearer-token är obligatorisk​

Denna felmeddelande innebär oftast att OpenCode inte skickar API-nyckel. Kontrollera:

  • att AI_SCHOOL_CODEREN_API_KEY heter exakt så
  • att värdet börjar med ais.
  • att du öppnat ett nytt terminalfönster efter setx
  • att .env-filen finns i projektmappen där du startar OpenCode

Unknown parameter​

Vissa verktyg skickar extra leverantörsspecifika parametrar. Om du får ett meddelande som Unknown parameter, ta bort den inställningen ur OpenCode-konfigurationen eller använd en enklare leverantörskonfiguration. Coderen-endpoint förväntar OpenAI-kompatibla chatförfrågningar med modell, meddelanden och de vanliga grundinställningarna.

Säkert arbete med OpenCode​

Eftersom OpenCode arbetar agentiskt är det viktigt att granska ändringar.

Rekommenderad arbetsmetod:

  1. Arbeta i ett git-repository.
  2. Börja med små uppgifter.
  3. Kontrollera diffs innan du använder koden.
  4. Testa applikationen efter ändringar.
  5. Commita endast ändringar som du förstår.

För elever med lite erfarenhet är det klokt att först demonstrera OpenCode under vägledning av en lärare.