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

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

AI-Public рекомендует 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.

Используйте там endpoint Coderen и допустимые модели:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ai-public-coderen": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI-Public Coderen",
      "options": {
        "baseURL": "https://europe-west1-ai-public-pro.cloudfunctions.net/coderenOpenAiCompatibleApi/v1",
        "apiKey": "{env:AI_PUBLIC_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-public-coderen/gpt-5.4-mini",
  "small_model": "ai-public-coderen/gpt-5.4-mini"
}

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

macOS и Linux

export AI_PUBLIC_CODEREN_API_KEY="aip.ваш-api-ключ"

Windows

setx AI_PUBLIC_CODEREN_API_KEY "aip.ваш-api-ключ"

Откройте затем новую терминальную сессию.

Запуск OpenCode

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

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

Запустите OpenCode:

opencode

Используйте в OpenCode выбор модели, чтобы выбрать модель AI-Public Coderen, если это еще не сделано автоматически.

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

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

Рекомендуемый способ работы:

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

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

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

AI_PUBLIC_CODEREN_API_KEY=aip.ваш-api-ключ

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

$env:AI_PUBLIC_CODEREN_API_KEY="aip.ваш-api-ключ"

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