Кратко: эта инструкция нужна, чтобы каждый смог подготовить рабочее пространство для написания кода с помощью ИИ через OpenCode и персональный API-ключ.

Параметры подключения задаются один раз: адрес прокси и модели — в глобальном файле настроек opencode.json, API-ключ — командой /connect внутри OpenCode.

Также может быть полезна инструкция по настройке Claude Code и официальная документация OpenCode.

0. Обозначения

OpenCode — это ИИ-помощник с открытым кодом, который работает в терминале. Он может писать код, работать с файлами и выполнять команды по задаче в агентском режиме.

Терминал — это окно, в котором команды вводятся текстом. В Windows это PowerShell, в macOS — приложение Терминал.

Провайдер (прокси) — это адрес, на который OpenCode отправляет запросы к модели. В нашем случае это https://litellm.geotech.user.events/v1.

Глобальный файл настроек — это файл opencode.json в папке .config/opencode в домашней директории пользователя. В нём хранятся адрес прокси и список моделей.

1. Установить OpenCode

macOS и Linux

1. Откройте терминал.

2. Выполните команду:

curl -fsSL https://opencode.ai/install | bash

3. Закройте терминал и откройте его заново.

Windows

1. Установите Node.js версии LTS, если его ещё нет.

2. Откройте PowerShell.

3. Выполните команду:

npm install -g opencode-ai

4. Закройте PowerShell и откройте его заново.

Разработчики OpenCode рекомендуют запускать его в Windows через WSL. Если вы уже работаете в WSL, используйте команду для Linux.

Проверка

Выполните команду:

opencode --version

Если в ответ появился номер версии, OpenCode установлен.

2. Заполнить глобальный файл настроек opencode.json

Это главный шаг. В файле задаются адрес прокси и модели.

Какой путь у файла

• Windows: C:\Users\<Имя пользователя>\.config\opencode\opencode.json

• macOS: /Users/<Имя пользователя>/.config/opencode/opencode.json

• Linux: /home/<Имя пользователя>/.config/opencode/opencode.json

Вместо <Имя пользователя> подставьте своё имя пользователя в системе.

Шаг 1. Создать папку

В Windows выполните в PowerShell:

mkdir -Force $HOME\.config\opencode

В macOS и Linux выполните в терминале:

mkdir -p ~/.config/opencode

Шаг 2. Вставить настройки

1. Создайте файл opencode.json по пути выше в любом редакторе кода, например в Visual Studio Code. Если файл уже есть, добавьте в него только блок provider и остальные поля из примера.

2. Скопируйте текст ниже, вставьте его в файл и сохраните:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "litellm": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Geotech",
      "options": {
        "baseURL": "https://litellm.geotech.user.events/v1"
      },
      "models": {
        "geotech/zai/glm-5.3-flash": { "name": "GLM 5.3 Flash" },
        "geotech/gemini/gemini-3.7-flash": { "name": "Gemini 3.7 Flash" },
        "geotech/gemini/gemini-3.5-flash": { "name": "Gemini 3.5 Flash" },
        "geotech/openai/gpt-5.6-luna": { "name": "GPT 5.6 Luna" }
      }
    }
  },
  "model": "litellm/geotech/zai/glm-5.3-flash",
  "small_model": "litellm/geotech/gemini/gemini-3.5-flash",
  "permission": {
    "edit": "ask",
    "bash": "ask"
  }
}

API-ключ в этот файл вписывать не нужно: он добавляется на следующем шаге.

Что означают поля

ID моделей есть в инструкции Список доступных моделей, раздел «Вайб-кодинг».

Чтобы добавить ещё одну модель, впишите её в models. ID должен точно совпадать с названием модели на прокси: опечатка проявится ошибкой при первом запросе.

Важно про формат файла

• файл должен быть строгим JSON: без комментариев (//) и без запятой после последнего элемента;

• кавычки и скобки должны остаться такими же, как в примере;

• после вставки обязательно сохраните файл.

3. Добавить API-ключ

Если у вас нет API-ключа, запросите его у alsu.yarulina@geotech.in.

Шаги

1. В терминале перейдите в папку проекта и запустите OpenCode:

cd путь/к/папке/проекта
opencode

2. Введите команду /connect и нажмите Enter.

3. Пролистайте список провайдеров вниз и выберите Other.

4. Введите ID провайдера: litellm

5. Вставьте персональный API-ключ и нажмите Enter.

6. Закройте OpenCode командой /exit и запустите заново, чтобы настройки применились.

4. Выбрать модель

1. Введите команду /models и нажмите Enter.

2. Выберите нужную модель в разделе Geotech.

Модель можно переключить в любой момент. Как выбрать модель под задачу — в инструкции Какую выбрать модель.

5. Проверить, что всё работает

Шаги

1. Запустите OpenCode в папке проекта.

2. Напишите простой запрос, например: «Напиши код пузырьковой сортировки на 1С». Отправьте запрос.

3. Если OpenCode ответил, настройка завершена.

6. Если возникла ошибка

Проверьте:

• открывается ли OpenCode командой opencode в новом окне терминала;

• лежит ли файл opencode.json именно в папке .config/opencode в домашней директории;

• корректен ли JSON в файле: нет комментариев, нет лишней запятой в конце, все скобки закрыты;

• совпадает ли ID провайдера в /connect с ID в файле: должен быть litellm;

• добавился ли ключ: команда opencode auth list показывает сохранённые ключи;

• вставлен ли ключ полностью, без пробелов;

• указан ли baseURL с /v1 на конце;

• если ошибка возникает только на одной модели — совпадает ли её ID со списком доступных моделей;

• сохранён ли файл и перезапущен ли OpenCode после изменения настроек;

• есть ли подключение к интернету.

Если после проверки ошибка сохраняется, напишите alsu.yarulina@geotech.in.

Важно про API-ключ

API-ключ действует на сотрудника, которому он был выдан. Не передавайте ключ никому и не публикуйте его в чатах, документах или скриншотах. OpenCode хранит ключ на вашем компьютере в файле ~/.local/share/opencode/auth.json — не коммитьте его в репозиторий.

Дата обновления: 30 октября 2026