Перейти до основного змісту

Встановлення та використання 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.jouw-api-sleutel"

Windows

setx AI_PUBLIC_CODEREN_API_KEY "aip.jouw-api-sleutel"

Після цього відкрийте нову термінальну сесію.

Запуск OpenCode

Перейдіть до каталогу проекту:

cd pad/naar/je/project

Запустіть 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.jouw-api-sleutel

Переконайтесь, що OpenCode дійсно завантажує цю змінну середовища. У PowerShell змінну також можна тимчасово задати для поточної сесії:

$env:AI_PUBLIC_CODEREN_API_KEY="aip.jouw-api-sleutel"

Якщо ви бачите Authorization header met Bearer token is verplicht (розділ зобов’язує), то інструмент не надсилає ключ як Authorization: Bearer .... Якщо ви бачите Unknown parameter, видаліть параметри провайдера, які не підтримує Coderen endpoint від AI-Public.