Instalare și utilizare OpenCode

OpenCode este un instrument de programare cu acțiune agențială. Instrumentul este disponibil ca aplicație în terminal, aplicație desktop și extensie IDE.

AI-School recomandă OpenCode în special pentru profesori, administratori și elevi cu multă experiență în programare. OpenCode poate funcționa mai autonom decât Aider și poate efectua rapid multe modificări.

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

Când alegi OpenCode?

Alegeți OpenCode dacă utilizatorul:

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

Pentru învățarea în clasă a programării cu începători, de regulă este mai potrivit Aider.

Instalare

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

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

De asemenea, poți instala OpenCode cu Node.js:

npm install -g opencode-ai

Sau cu Homebrew pe macOS și Linux:

brew install anomalyco/tap/opencode

Conectare cu Codarea

OpenCode acceptă providers personalizați compatibili OpenAI. Creează în directorul proiectului un fișier opencode.json.

Folosește acolo endpoint-ul de Codare ș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.6-luna": {
          "name": "GPT-5.6 Luna"
        },
        "gpt-5.6-terra": {
          "name": "GPT-5.6 Terra"
        },
        "gpt-5.6-sol": {
          "name": "GPT-5.6 Sol"
        }
      }
    }
  },
  "model": "ai-school-coderen/gpt-5.6-luna",
  "small_model": "ai-school-coderen/gpt-5.6-luna"
}

Apoi setează cheia API ca variabilă de mediu.

Poți utiliza pentru aceasta și un fișier .env în directorul proiectului:

AI_SCHOOL_CODEREN_API_KEY=ais.api-cheie-a-ta

Verifică după deschiderea unei noi sesiuni de terminal dacă OpenCode poate citi această variabilă. Dacă OpenCode nu trimite o cheie, AI-School va afișa eroarea că un antet Authorization cu token Bearer este obligatoriu.

macOS și Linux

export AI_SCHOOL_CODEREN_API_KEY="ais.api-cheie-a-ta"

Windows

setx AI_SCHOOL_CODEREN_API_KEY "ais.api-cheie-a-ta"

Apoi deschide o nouă sesiune de terminal.

Porndere OpenCode

Accesează directorul de proiect:

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

Pornește OpenCode:

opencode

Folosește în OpenCode alegerea modelului pentru a selecta modelul AI-School Coderen dacă nu s-a făcut automat.

A rezolva probleme

Este obligator Antetul Authorization cu Bearer token

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

• dacă AI_SCHOOL_CODEREN_API_KEY se numește exact așa
• dacă valoarea începe cu ais.
• dacă ai deschis o nouă sesiune de terminal după setx
• dacă fișierul .env se află î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, elimină acea setare din configurația OpenCode sau folosește o configurație de furnizor mai simplă. Endpoint-ul Coderen așteaptă cereri de tip OpenAI-compatible cu model, mesaje și setări de bază obișnuite.

Lucru în siguranță cu OpenCode

Pentru că OpenCode operează în mod agentic, este important să verifici modificările.

Mod de lucru recomandat:

1. lucrează într-un depozit git
2. începe cu sarcini mici
3. verifică dif-urile înainte de a utiliza codul
4. testează aplicația după modificări
5. comite doar modificările pe care le înțelegi

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