Instalarea și utilizarea OpenCode

OpenCode este un instrument de codare cu rol de agent. Instrumentul este disponibil ca aplicație în terminal, aplicație desktop și extensie IDE.

AI-School recomandă OpenCode în special educatorilor, administratorilor și elevilor cu multă experiență în programare. OpenCode poate funcționa mai independent decât Aider și poate efectua mai rapid multe modificări.

Mai multe informații găsiți pe site-ul OpenCode și în documentația oficială OpenCode.

Când alegi OpenCode?

Alege OpenCode dacă utilizatorul:

• are experiență cu terminalul, editoare de cod și git
• înțelege cum sunt modificate fișierele locale
• poate verifica modificările înainte de a fi utilizate
• dorește să elaboreze sarcini de programare mai complexe

Pentru învățarea în clasă cu începători, Aider este de obicei mai potrivit.

Instalare

Cea mai simplă instalare conform documentației OpenCode este:

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

Poți instala OpenCode și cu Node.js:

npm install -g opencode-ai

Sau cu Homebrew pe macOS și Linux:

brew install anomalyco/tap/opencode

Conectarea cu Codarea

OpenCode susține providers personali compatibili cu OpenAI. Creează în directorul proiectului un fișier opencode.json.

Folosește în acesta endpoint-ul Coderen și modelele permise:

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

Apoi setează cheia API ca variabilă de mediu.

Poți folosi și un fișier .env în directorul proiectului:

AI_SCHOOL_CODEREN_API_KEY=ais. cheia-ta-api

Verifică după deschiderea unei noi sesiuni de terminal dacă OpenCode poate citi această variabilă. Dacă OpenCode nu trimite nicio cheie, AI-School va returna eroarea că antetul Authorization cu token Bearer este obligatoriu.

macOS și Linux

export AI_SCHOOL_CODEREN_API_KEY="ais. cheia-ta-api"

Windows

setx AI_SCHOOL_CODEREN_API_KEY "ais. cheia-ta-api"

Apoi deschide din nou un terminal.

Pornirea OpenCode

Mergi în directorul proiectului:

cd calea/către/proiectul/tău

Pornește OpenCode:

opencode

În OpenCode folosește alegerea modelului pentru a selecta modelul AI-School Coderen dacă nu se face automat.

Tratamentează problemele

Antetul Authorization cu token Bearer este obligatoriu

Acest mesaj înseamnă de obicei că OpenCode nu trimite o cheie API. Verifică:

• dacă AI_SCHOOL_CODEREN_API_KEY este exact așa cum trebuie
• dacă valoarea începe cu ais.
• dacă ai deschis o nouă sesiune terminal după setx
• dacă fișierul .env este în directorul proiectului de unde pornești OpenCode

Unknown parameter

Unele unelte trimit parametri suplimentari specifici furnizorului. Dacă primești un mesaj precum „Unknown parameter”, șterge acea setare din configurația OpenCode sau utilizează o configurație de furnizor mai simplă. Endpoint-ul Coderen așteaptă solicitări de tip OpenAI-compatible pentru chat cu model, mesaje și setările de bază obișnuite.

Lucru în siguranță cu OpenCode

Fiind agentic, OpenCode necesită verificarea modificărilor.

Procedură recomandată:

1. Lucrează într-un depozit git.
2. Începe cu sarcini mici.
3. Verifică dif-urile înainte de a folosi codul. 4.Testează aplicația după modificări.
4. Commită doar modificările pe care le înțelegi.

Pentru elevii cu puțină experiență, este indicat să folosești mai întâi OpenCode în mod demonstrativ, sub îndrumarea unui profesor.