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

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

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

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

Більше інформації можна знайти на веб-сайті 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.

У ньому використайте кінцеву точку 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.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"
}

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

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

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

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

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 token обов’язковий​

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

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

Unknown parameter​

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

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

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

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

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

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

WhatsApp