Przejdź do głównej treści

Instalacja i użycie OpenCode

OpenCode to narzędzie kodujące z agentycznym podejściem. Narzędzie dostępne jest jako aplikacja terminalowa, aplikacja desktopowa oraz rozszerzenie IDE.

AI-School zaleca OpenCode głównie dla nauczycieli, administratorów i uczniów z dużym doświadczeniem w programowaniu. OpenCode może działać niezależnie od Aider i wykonywać szybciej wiele zmian.

Więcej informacji znajdziesz na stronie OpenCode oraz w oficjalnej dokumentacji OpenCode.

Kiedy wybrać OpenCode?​

Wybierz OpenCode, jeśli użytkownik:

  • ma doświadczenie w terminalu, edytorach kodu i git
  • rozumie, jak modyfikowane są lokalne pliki
  • potrafi zweryfikować zmiany przed ich użyciem
  • chce opracować bardziej złożone zadania programistyczne

Do nauczania programowania na zajęciach z początkującymi zazwyczaj lepiej sprawdza się Aider.

Instalacja​

Najprostsza instalacja zgodnie z dokumentacją OpenCode to:

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

OpenCode można również zainstalować za pomocą Node.js:

npm install -g opencode-ai

Lub za pomocą Homebrew na macOS i Linux:

brew install anomalyco/tap/opencode

Połączenie z Kodowaniem​

OpenCode obsługuje dostosowane dostawcy kompatybilni z OpenAI. Utwórz w folderze projektu plik opencode.json.

Wykorzystaj w nim punkt końcowy Coderen i dozwolone modele:

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

Następnie ustaw klucz API jako zmienną środowiskową.

Możesz również użyć pliku .env w katalogu projektu:

AI_SCHOOL_CODEREN_API_KEY=ais.twoj-klucz-api

Po otwarciu nowego terminala sprawdź, czy OpenCode odczytuje tę zmienną. Jeśli OpenCode nie przekaże klucza, AI-School wyświetli błąd wymagający nagłówka Authorization z Bearer token.

macOS i Linux​

export AI_SCHOOL_CODEREN_API_KEY="ais.twoj-klucz-api"

Windows​

setx AI_SCHOOL_CODEREN_API_KEY "ais.twoj-klucz-api"

Następnie otwórz nowy terminal.

Uruchomienie OpenCode​

Przejdź do katalogu projektu:

cd ścieżka/do/twojego/projektu

Uruchom OpenCode:

opencode

W OpenCode wybierz model, aby wybrać model AI-School Coderen, jeśli nie zrobi się to automatycznie.

Rozwiązywanie problemów​

Authorization header z Bearer tokenem jest wymagany​

Ta wiadomość zwykle oznacza, że OpenCode nie wysyła klucza API. Sprawdź:

  • czy AI_SCHOOL_CODEREN_API_KEY na pewno tak się nazywa
  • czy wartość zaczyna się od ais.
  • czy po setx otworzyłeś nowy terminal
  • czy plik .env znajduje się w katalogu projektu, z którego uruchamiasz OpenCode

Unknown parameter​

Niektóre narzędzia przesyłają dodatkowe parametry specyficzne dla dostawcy. Jeśli otrzymasz komunikat taki jak Unknown parameter, usuń tę ustawienie z konfiguracji OpenCode lub użyj prostszej konfiguracji dostawcy. Punkt końcowy Coderen oczekuje żądań czatowych zgodnych z OpenAI z modelem, wiadomościami i standardowymi ustawieniami.

Bezpieczna praca z OpenCode​

Ponieważ OpenCode działa w sposób agentowy, ważne jest, aby wprowadzone zmiany były sprawdzane.

Zalecany sposób pracy:

  1. Pracuj w repozytorium git.
  2. Zaczynaj od małych zadań.
  3. Sprawdzaj różnice przed użyciem kodu.
  4. Testuj aplikację po wprowadzeniu zmian.
  5. Zatwierdzaj tylko te zmiany, które rozumiesz.

Dla uczniów o niskim doświadczeniu warto najpierw demonstrować OpenCode pod opieką nauczyciela.

WhatsApp