Перейти к основному содержимому

Установка и использование 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.

Используйте в нем конечную точку 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 токеном обязателен.

macOS и Linux​

export AI_SCHOOL_CODEREN_API_KEY="ais.ваш-api-ключ"

Windows​

setx AI_SCHOOL_CODEREN_API_KEY "ais.ваш-api-ключ"

Затем откройте новый терминал.

Запуск OpenCode​

Перейдите в каталог проекта:

cd путь/к/вашему/проекту

Запустите OpenCode:

opencode

В OpenCode выберите модель, чтобы выбрать модель AI-School Coderen, если это ещё не произошло автоматически.

Решение проблем​

Заголовок Authorization с Bearer токеном обязателен​

Это сообщение обычно означает, что 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. Сверяйте diffs перед использованием кода.
  4. Протестируйте приложение после изменений.
  5. Коммитьте только те изменения, которые понимаете.

Для учеников с небольшим опытом разумно сначала продемонстрировать OpenCode под надзором преподавателя.

WhatsApp