Перейти до основного змісту

Встановлення та використання OpenCode

OpenCode — це інструмент кодування з агентною архітектурою. Інструмент доступний як термінальна програма, настільна програма та розширення IDE.

AI-School радить використовувати OpenCode переважно для вчителів, адміністраторів та учнів із великим досвідом програмування. OpenCode може працювати автономніше, ніж Aider, і тому швидше виконувати багато змін.

Більше інформації дивіться на сайті OpenCode та в офіційній документації OpenCode.

Коли обирати OpenCode?​

Обирайте OpenCode, якщо користувач:

  • має досвід роботи з терміналом, редакторами коду та git
  • розуміє, як локальні файли редагуються
  • може перевіряти зміни перед їх використанням
  • хоче розробляти більш складні завдання з програмування

Для класного навчання програмуванню з початковими знаннями зазвичай більш підходить Aider.

Встановлення​

Найпростіша установка відповідно до документації OpenCode така:

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

OpenCode також можна встановити за допомогою Node.js:

npm install -g opencode-ai

Або за допомогою Homebrew на macOS та Linux:

brew install anomalyco/tap/opencode

Підключення до Coderen​

OpenCode підтримує налаштовані провайдери, сумісні з OpenAI. Створіть у директорії проекту файл opencode.json.

Використовуйте у ньому endpoint Coderen та дозволені моделі:

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

Після цього встановіть API-ключ як змінну середовища.

Для цього також можна використати файл .env у папці проекту:

AI_SCHOOL_CODEREN_API_KEY=ais.твій-api-ключ

Перевірте після відкриття нової термінальної сесії, чи OpenCode може прочитати цю змінну. Якщо OpenCode не надсилає ключ, AI-School видає помилку, що заголовок Authorization з токеном Bearer обов’язковий.

macOS та Linux​

export AI_SCHOOL_CODEREN_API_KEY="ais.твій-api-ключ"

Windows​

setx AI_SCHOOL_CODEREN_API_KEY "ais.твій-api-ключ"

Після цього відкрийте нову термінальну сесію.

Ініціювання OpenCode​

Перейдіть у директорію проекту:

cd шлях/до/твого/проекту

Запустіть OpenCode:

opencode

У OpenCode виберіть модель, щоб обрати модель Coderen від AI-School, якщо це ще не сталося автоматично.

Вирішення проблем​

Обов’язковий заголовок Authorization з Bearer токеном​

Це повідомлення зазвичай означає, що OpenCode не надсилає API-ключ. Перевірте:

  • чи точно називається AI_SCHOOL_CODEREN_API_KEY
  • чи починається значення з ais.
  • чи після setx ви відкрили нову термінальну сесію
  • чи знаходиться файл .env у папці проекту, де ви запускаєте OpenCode

Unknown parameter​

Деякі інструменти надсилають додаткові параметри, специфічні для провайдера. Якщо отримуєте повідомлення на кшталт Unknown parameter, видаліть цю настройку з конфігурації OpenCode або використайте простішу конфігурацію провайдера. Endpoint Coderen очікує запити до OpenAI-сумісного чату з моделлю, повідомленнями та стандартними базовими параметрами.

Безпека роботи з OpenCode​

Оскільки OpenCode працює із агентною системою, важливо перевіряти зміни.

Рекомендований підхід:

  1. Працюйте у git-репозиторії.
  2. Починайте з дрібних завдань.
  3. Перевіряйте дифи перед використанням коду.
  4. Тестуйте застосунок після змін.
  5. Комітіть тільки ті зміни, які ви розумієте.

Для учнів із невеликим досвідом рекомендується спочатку демонструвати використання OpenCode під наглядом вчителя.