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

Всё делается мышкой: скачать приложение, создать один файл настроек opencode.json с API-ключом и выбрать модель из раздела «Ареал Дев». Командная строка не нужна.

Инструкция написана в первую очередь для Windows. Отличия для macOS — в конце, в разделе «Если у вас macOS».

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

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

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

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

Файл настроек — это файл opencode.json в папке .config\opencode в домашней папке пользователя. В нём хранятся адрес прокси, API-ключ и список моделей.

«Ареал Дев» — так называется раздел с нашими моделями в списке моделей OpenCode.

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

Шаги

1. Откройте страницу opencode.ai/download.

2. В блоке OpenCode Desktop скачайте установщик для Windows.

3. Запустите скачанный файл и пройдите установку с настройками по умолчанию.

4. Откройте OpenCode из меню «Пуск», чтобы убедиться, что приложение запускается, и закройте его.

Если Windows показывает предупреждение «Система Windows защитила ваш компьютер», нажмите Подробнее → Выполнить в любом случае.

2. Создать файл настроек opencode.json

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

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

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

Вместо <Имя пользователя> подставьте своё имя пользователя в Windows. Его видно в Проводнике в папке C:\Users.

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

1. Откройте Проводник.

2. В адресную строку вверху вставьте %USERPROFILE% и нажмите Enter. Откроется ваша домашняя папка C:\Users\<Имя пользователя>.

3. Если в ней уже есть папка .config, откройте её. Если нет — нажмите правой кнопкой мыши на пустом месте → Создать → Папку и назовите её .config (с точкой в начале).

4. Внутри .config таким же способом создайте папку opencode и откройте её.

Если Windows не даёт назвать папку .config, введите имя с точкой и в конце: .config. — Windows сама уберёт последнюю точку.

Шаг 2. Создать файл

1. Откройте Блокнот (меню «Пуск» → Блокнот).

2. Скопируйте текст настроек из шага 3 и вставьте его в Блокнот.

3. Замените оба вхождения текста ваш-API-ключ на выданный вам ключ.

4. Откройте меню Файл → Сохранить как…

5. Перейдите в папку C:\Users\<Имя пользователя>\.config\opencode, созданную на шаге 1.

6. В поле Тип файла выберите Все файлы (*.*).

7. В поле Имя файла введите opencode.json.

8. В поле Кодировка оставьте UTF-8.

9. Нажмите Сохранить.

Вместо Блокнота можно использовать любой редактор кода, например Visual Studio Code: он подсвечивает ошибки в файле.

Шаг 3. Текст настроек

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "areal": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ареал Дев",
      "options": {
        "baseURL": "https://litellm.geotech.user.events/v1",
        "apiKey": "ваш-API-ключ"
      },
      "models": {
        "geotech/zai/glm-5.3-flash": {
          "name": "GLM 5.3 Flash",
          "options": { "drop_params": true }
        },
        "geotech/gemini/gemini-3.7-flash": { "name": "Gemini 3.7 Flash" },
        "geotech/gemini/gemini-3.5-flash": { "name": "Gemini 3.5 Flash" },
        "gti-local/Qwen3.8": { "name": "Qwen 3.8 (для конфиденциальных данных)" }
      }
    },
    "areal-gpt": {
      "npm": "@ai-sdk/openai",
      "name": "Ареал Дев · GPT",
      "options": {
        "baseURL": "https://litellm.geotech.user.events/v1",
        "apiKey": "ваш-API-ключ"
      },
      "models": {
        "geotech/openai/gpt-5.6-luna": { "name": "GPT 5.6 Luna" }
      }
    }
  },
  "model": "areal/geotech/zai/glm-5.3-flash",
  "small_model": "areal/geotech/gemini/gemini-3.5-flash",
  "permission": {
    "edit": "ask",
    "bash": "ask"
  }
}

Обязательно замените оба текста ваш-API-ключ на выданный вам ключ. Остальное можно оставить как есть.

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

Почему GPT в отдельном разделе: модели GPT 5.6 не умеют одновременно рассуждать и пользоваться инструментами (чтение и правка файлов) в обычном формате запросов. Подключение @ai-sdk/openai использует для них другой формат, в котором это работает.

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

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

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

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

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

• API-ключ вставляйте полностью, без пробелов и переносов строк, кавычки вокруг ключа не удаляйте;

• после изменений обязательно сохраните файл и перезапустите OpenCode: приложение читает настройки при запуске.

3. Открыть проект

1. Запустите OpenCode.

2. Нажмите Open Project и выберите папку, в которой будете работать с кодом. Это может быть новая пустая папка.

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

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

1. Внизу, под полем ввода сообщения, нажмите на название текущей модели.

2. В открывшемся списке найдите разделы Ареал Дев и Ареал Дев · GPT.

3. Выберите нужную модель.

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

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

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

2. Отправьте запрос.

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

Проверьте так же хотя бы одну модель из раздела «Ареал Дев · GPT»: у неё отдельное подключение.

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

Модели «Ареал Дев» нет в списке

• лежит ли файл точно по пути C:\Users\<Имя пользователя>\.config\opencode\opencode.json;

• не называется ли файл opencode.json.txt (см. предупреждение в шаге 2);

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

• перезапущен ли OpenCode после сохранения файла.

Запрос долго висит со статусом «Working»

Чаще всего так бывает, когда включён VPN: прокси geotech не принимает соединения через него. Выключите VPN или добавьте адрес litellm.geotech.user.events в исключения VPN, затем повторите запрос.

Ошибка от прокси в ответе

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

Если у вас macOS

Всё делается так же, кроме нескольких шагов:

• на странице opencode.ai/download скачайте версию для macOS (Apple Silicon — для Mac на процессорах M1 и новее), откройте файл .dmg и перетащите OpenCode в папку «Программы»;

• путь к файлу настроек: /Users/<Имя пользователя>/.config/opencode/opencode.json;

• чтобы открыть скрытую папку, в Finder нажмите Cmd+Shift+G и вставьте ~/.config. Если папки нет, создайте её в домашней папке: в Finder скрытые папки показываются по Cmd+Shift+.;

• создавайте файл в редакторе кода, например в Visual Studio Code. Приложение TextEdit по умолчанию сохраняет файлы в формате RTF, и OpenCode такой файл не прочитает.

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

API-ключ действует на сотрудника, которому он был выдан. Не передавайте ключ никому и не публикуйте его в чатах, документах или скриншотах. Ключ хранится в файле opencode.json в открытом виде, поэтому не пересылайте этот файл и не кладите его в репозиторий.

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