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

Установка и использование 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-compatible. В каталоге проекта создайте файл 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.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 выберите модель AI-School Coderen, если это ещё не сделано автоматически.

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

Требуется заголовок Authorization с Bearer-токеном​

Это сообщение обычно означает, что OpenCode не отправляет API-ключ. Проверьте:

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

Unknown parameter​

Некоторые инструменты отправляют дополнительные параметры, специфичные для провайдера. Если вы получаете сообщение типа Unknown parameter, удалите эту настройку из конфигурации OpenCode или используйте более простую конфигурацию провайдера. Конечная точка Coderen ожидает OpenAI-подобные чат-запросы с моделью, сообщениями и обычными базовыми настройками.

Безопасная работа с OpenCode​

Поскольку OpenCode работает агентно, важно проверять изменения.

Рекомендуемая практика:

  1. Работайте в Git-репозитории.
  2. Начинайте с небольших задач.
  3. Проверяйте диффы перед использованием кода.
  4. Протестируйте приложение после изменений.
  5. Коммитьте только те изменения, которые понимаете.

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