Установка и использование OpenCode

OpenCode — это инструмент кодирования с агентной функцией. Инструмент доступен как терминальное приложение, настольное приложение и как расширение IDE.

AI-Corporate рекомендует OpenCode для разработчиков, администраторов и других продвинутых пользователей. OpenCode может самостоятельно изменять файлы и разворачивать задачи. Поэтому всегда проверяйте предлагаемые изменения.

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

Установка

Самый простой способ установки согласно документации 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-corporate-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Corporate Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-corporate.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_CORPORATE_CODEREN_API_KEY}"
      },
      "models": {
        "gpt-5.4-mini": {
          "name": "GPT-5.4 мини"
        },
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  },
  "model": "ai-corporate-coderen/gpt-5.4-mini",
  "small_model": "ai-corporate-coderen/gpt-5.4-mini"
}

Задайте API-ключ как переменную окружения.

macOS и Linux

export AI_CORPORATE_CODEREN_API_KEY="aic.ваш-api-ключ"

Windows

setx AI_CORPORATE_CODEREN_API_KEY "aic.ваш-api-ключ"

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

Запуск OpenCode

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

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

Запустите OpenCode:

opencode

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

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

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

Рекомендуемый порядок действий:

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

Переменные окружения и OpenCode

Для OpenCode можно сохранить ключ API Coderen в локальном файле .env в каталоге проекта:

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

Убедитесь, что OpenCode действительно загружает эту переменную окружения. В PowerShell переменную можно временно установить для текущего терминала:

$env:AI_SCHOOL_CODEREN_API_KEY="ais.ваш-api-ключ"

Если вы видите сообщение Authorization header with Bearer token is required, то инструмент не передаёт ключ в заголовке Authorization: Bearer .... Если вы видите Unknown parameter, удалите настройки провайдера, которые не поддерживает конечная точка Coderen от AI-Corporate.