Zainstaluj i używaj OpenCode

OpenCode to narzędzie do kodowania o charakterze agentowym. Narzędzie dostępne jest jako aplikacja terminalowa, aplikacja desktopowa i rozszerzenie IDE.

AI-School zaleca OpenCode primarily dla nauczycieli, administratorów i uczniów z dużym doświadczeniem w programowaniu. OpenCode może działać niezależnieji niż Aider i dzięki temu wykonywać wiele zmian szybciej.

Więcej informacji znajdziesz na stronie OpenCode: OpenCode-website 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 nauki programowania z podręcznikiem dla początkujących zwykle lepiej pasuje Aider.

Instalacja

Najprostsza instalacja zgodnie z dokumentacją OpenCode to:

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

Możesz też zainstalować OpenCode za pomocą Node.js:

npm install -g opencode-ai

Lub za pomocą Homebrew na macOS i Linux:

brew install anomalyco/tap/opencode

Łączenie z Coderen

OpenCode obsługuje niestandardowe providery kompatybilne z OpenAI. Utwórz w katalogu projektu plik opencode.json.

Użyj w nim punktu końcowego Coderen i dozwolonych modeli:

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

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

Możesz także użyć pliku .env w katalogu projektu:

AI_SCHOOL_CODEREN_API_KEY=ais.twoj-klucz-api

Sprawdź po otwarciu nowego terminala, czy OpenCode może odczytać tę zmienną. Jeśli OpenCode nie wyśle klucza, AI-School zwróci błąd, że nagłówek Authorization z tokenem Bearer jest wymagany.

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 AI-School Coderen, jeśli to jeszcze nie zostało zrobione automatycznie.

Rozwiązywanie problemów

Nagłówek Authorization z tokenem Bearer jest wymagany

Ta informacja zazwyczaj oznacza, że OpenCode nie wysyła klucza API. Sprawdź:

• czy AI_SCHOOL_CODEREN_API_KEY nosi dokładnie taką nazwę
• czy wartość zaczyna się od ais.
• czy po setx otworzyłeś nowe okno terminala
• czy plik .env znajduje się w katalogu projektu, z którego uruchamiasz OpenCode

Unknown parameter

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

Bezpieczna praca z OpenCode

Ponieważ OpenCode działa w sposób agencyjny, ważne jest, aby weryfikować zmiany.

Zalecane praktyki:

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

Dla uczniów o małym doświadczeniu warto używać OpenCode najpierw demonstracyjnie pod opieką nauczyciela.