Встановлення та використання 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 mini"
        },
        "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.