Открывайте расширение или CLI по ссылкам выше. Не устанавливайте пакеты и расширения с похожими названиями из поиска: у них может быть другой publisher, другой endpoint или небезопасная сборка.

Проверено на macOS: OpenCode 2.0.20

30 сентября 2026 года GPT-5.5, Grok 4.7, DeepSeek V4 и Gemini 3.1 Pro успешно вызвали read и вернули правильный код из файла. В версии 2.0.20 проверка выполнена с плагином ниже. Также проверен CLI 1.18.33 с заголовком из конфигурации. Windows и Linux отдельно не тестировались.

1. Скачайте конфиг и плагин

Скачать комплект для OpenCode — opencode.json, mashagpt-session-header.js и инструкция. В архиве нет API-ключа. Можно скачать отдельно конфиг и плагин.

2. Укажите ключ и сохраните opencode.json

Создайте ключ в разделе API-ключи и замените YOUR_MASHA_API_KEY в примере своим ключом. Для Desktop это работает и при запуске приложения из Dock или меню «Пуск». Сохраните файл в пользовательскую папку настроек:

macOS / Linux

~/.config/opencode/opencode.json

Windows

%USERPROFILE%\.config\opencode\opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "mashagpt/gpt-5.5",
  "small_model": "mashagpt/gpt-5.5",
  "provider": {
    "mashagpt": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "MashaGPT",
      "options": {
        "baseURL": "https://api.mashagpt.ru/v1",
        "apiKey": "YOUR_MASHA_API_KEY"
      },
      "models": {
        "gpt-5.5": {
          "name": "GPT-5.5 — MashaGPT",
          "tool_call": true,
          "limit": {
            "context": 128000,
            "output": 8192
          },
          "headers": {
            "X-Session-Id": ""
          },
          "options": {
            "reasoningEffort": "none"
          }
        },
        "grok-4.7": {
          "name": "Grok 4.7 — MashaGPT",
          "tool_call": true,
          "limit": {
            "context": 128000,
            "output": 4096
          },
          "headers": {
            "X-Session-Id": ""
          }
        },
        "deepseek-v4": {
          "name": "DeepSeek V4 — MashaGPT",
          "tool_call": true,
          "limit": {
            "context": 128000,
            "output": 4096
          },
          "headers": {
            "X-Session-Id": ""
          }
        },
        "gemini-3.1-pro-preview": {
          "name": "Gemini 3.1 Pro — MashaGPT",
          "tool_call": true,
          "limit": {
            "context": 128000,
            "output": 4096
          },
          "headers": {
            "X-Session-Id": ""
          }
        }
      }
    }
  }
}

Если файл уже есть, объедините настройки, сохранив другие провайдеры. Конфиг проекта opencode.json или opencode.jsonc может переопределять глобальную настройку. Не добавляйте файл с ключом в Git и не пересылайте его.

Ключ отдельно от конфига

Вместо ключа можно указать {file:~/.config/opencode/masha-api.key} и сохранить в masha-api.key только свой ключ. На macOS/Linux ограничьте доступ командой chmod 600 ~/.config/opencode/masha-api.key. Для CLI также подходит {env:MASHA_API_KEY}, если переменная задана в терминале, из которого запускается OpenCode. Приложение, запущенное из Dock или меню «Пуск», может не получить эту переменную.

3. Установите плагин для OpenCode 2.0.20

В этой версии нужен дополнительный файл: одной настройки заголовка в opencode.json недостаточно. OpenCode отправляет X-Session-Id вида ses_…, а MashaGPT API ожидает в этом заголовке UUID и отвечает HTTP 500. Плагин удаляет только этот заголовок у провайдера mashagpt. Адрес API, API-ключ и содержимое запроса он не меняет.

macOS / Linux

~/.config/opencode/plugins/mashagpt-session-header.js

Windows

%USERPROFILE%\.config\opencode\plugins\mashagpt-session-header.js

Создайте папку plugins, если её нет, и сохраните в ней следующий код. Расширение должно быть .js, а не .txt или .mjs. OpenCode загрузит файл автоматически; добавлять путь к этому файлу в поле plugin не нужно.

// OpenCode 2.0.20 compatibility: MashaGPT reserves X-Session-Id for UUIDs.
const mashaSessionHeader = {
  id: "mashagpt-session-header",
  async setup(context) {
    await context.session.hook(
      "http.request",
      (event) => {
        const headers = new Headers(event.request.headers);

        headers.delete("x-session-id");
        event.request = new Request(event.request, { headers });
      },
      { providerID: "mashagpt" },
    );
  },
};

export default mashaSessionHeader;

Совместимость версий

Этот плагин проверен с API плагинов OpenCode 2.0.20. Для CLI 1.18.33 достаточно X-Session-Id с пустой строкой в headers каждой модели, с точным регистром из примера; плагин для 2.0.20 туда не устанавливайте. В других версиях сначала проверьте ответ и чтение файла.

4. Перезапустите OpenCode и включите модели

Полностью перезапустите OpenCode после сохранения обоих файлов.

В Desktop нажмите на название модели → «Управление моделями» → включите MashaGPT. В CLI откройте /models.

Выберите GPT-5.5, Grok 4.7, DeepSeek V4 или Gemini 3.1 Pro с подписью MashaGPT и отправьте короткий запрос.

Создайте probe.txt с проверочным словом в открытом проекте. Попросите прочитать его инструментом read и вернуть слово. Разрешите чтение, если редактор запросит доступ.

opencode run --model mashagpt/gpt-5.5 "Ответь одним словом: готово"
opencode run --model mashagpt/grok-4.7 "Ответь одним словом: готово"
opencode run --model mashagpt/deepseek-v4 "Ответь одним словом: готово"
opencode run --model mashagpt/gemini-3.1-pro-preview "Ответь одним словом: готово"

model задаёт модель по умолчанию, small_model — модель служебных задач, включая названия сессий. Эти запросы тоже расходуют API-баланс. Чтобы выбрать Gemini по умолчанию, задайте в обоих поляхmashagpt/gemini-3.1-pro-preview.

Сохраните параметры примера

Для GPT-5.5 оставьте "reasoningEffort": "none": работа инструментов через этот API проверена с таким значением. Не выбирайте вариант с другим уровнем reasoning при первом тесте. limit задаёт выбранные рабочие ограничения, а не предельные возможности моделей.

Выбирайте протокол по модели

GPT-5.5, Grok 4.7, DeepSeek V4 и Gemini 3.1 Pro используют /v1/chat/completions. Claude требует /v1/messages. Название модели в чате может отличаться от API ID; сверяйте ID и endpoint с каталогом MashaGPT API. Наличие модели в каталоге само по себе не подтверждает работу конкретного редактора.

Если подключение не работает

HTTP 500 / UUID / ses_…

В OpenCode 2.0.20 проверьте установку плагина: папка plugins, расширение .js, ID провайдера mashagpt. Перезапустите приложение. В 1.18.33 проверьте X-Session-Id в headers каждой модели.

Моделей нет в меню

В Desktop откройте «Управление моделями» и включите MashaGPT. Проверьте, что конфиг проекта не перекрывает пользовательские настройки.

401 / No API key

Замените YOUR_MASHA_API_KEY своим ключом. Если используете переменную окружения, она должна быть доступна именно процессу OpenCode. Для запуска Desktop удобнее ссылка на файл с ключом.

Ошибка reasoning_effort

Для GPT-5.5 оставьте reasoningEffort: none в options модели и не выбирайте другой вариант reasoning.

Файл не прочитан

Положите probe.txt в открытый проект и разрешите запрос read. Отказ в доступе к внешней папке не является ошибкой API.

Claude использует отдельный протокол

Для Claude Code используйте Anthropic Messages API и точный ID из актуального каталога моделей MashaAPI. Модели Claude не входят в список OpenAI-совместимого GET /v1/models. Конфигурация OpenCode на этой странице предназначена для GPT, Grok, DeepSeek и Gemini. Настройка Claude приведена в инструкции Claude Code.

Для диагностики сообщите поддержке версию OpenCode, ID модели, текст ошибки и время запроса. API-ключ присылать не нужно.

Другие IDE-интеграции

Cursor

Возможности и ограничения подключения MashaGPT API к Cursor через пользовательский Base URL.

Claude Code

Настройка Anthropic Messages API и текущий статус доступности Claude через MashaGPT.

VS Code

OpenAI-compatible параметры MashaGPT API для Cline и проверка совместимости других расширений.

Codex

Статус поддержки Codex CLI и требования к публичному Responses API.

MMashaGPT API

API-ключи Загрузка файлов

IDE-интеграции

Cursor Claude Code OpenCode VS Code Codex

TikTokPOST

Hailuo 2.3POST MiniMax Hailuo 03 Text-to-VideoPOST MiniMax Hailuo 03 Image-to-VideoPOST MiniMax Hailuo 03 Reference-to-VideoPOST MiniMax Video 01 DirectorPOST

Veo 3.1POST Veo 3.1 LitePOST Gemini Omni VideoPOST

Grok Imagine Video 1.5 PreviewPOST Grok Imagine Text-to-VideoPOST Grok Imagine Image-to-VideoPOST

Seedance V1.5 ProPOST Seedance 2.0 Text-to-VideoPOST Seedance 2.5 Text-to-VideoPOST Seedance 2.0 MiniPOST

TopazPOST

Gemini 3.1 Flash TTSPOST Gemini 2.5 Pro Preview TTSPOST

Kling 3.0 Motion ControlPOST Kling V1 Avatar ProPOST Kling V1 Avatar StandardPOST

xAIPOST OpenAIPOST

Claude Sonnet 5POST Claude Opus 4.8POST Claude Opus 5.5POST Claude Sonnet 5.5POST

DeepSeekPOST GooglePOST

IDE-интеграции

OpenCode

Подключение GPT, Grok, DeepSeek и Gemini к OpenCode через MashaGPT API: конфигурация, выбор модели и проверка инструментов.

Документация OpenCode Скачать OpenCode

Ставьте только из официального источника

Проверено на macOS: OpenCode 2.0.20

1. Скачайте конфиг и плагин

2. Укажите ключ и сохраните opencode.json

macOS / Linux

~/.config/opencode/opencode.json

Windows

%USERPROFILE%\.config\opencode\opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "mashagpt/gpt-5.5",
  "small_model": "mashagpt/gpt-5.5",
  "provider": {
    "mashagpt": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "MashaGPT",
      "options": {
        "baseURL": "https://api.mashagpt.ru/v1",
        "apiKey": "YOUR_MASHA_API_KEY"
      },
      "models": {
        "gpt-5.5": {
          "name": "GPT-5.5 — MashaGPT",
          "tool_call": true,
          "limit": {
            "context": 128000,
            "output": 8192
          },
          "headers": {
            "X-Session-Id": ""
          },
          "options": {
            "reasoningEffort": "none"
          }
        },
        "grok-4.7": {
          "name": "Grok 4.7 — MashaGPT",
          "tool_call": true,
          "limit": {
            "context": 128000,
            "output": 4096
          },
          "headers": {
            "X-Session-Id": ""
          }
        },
        "deepseek-v4": {
          "name": "DeepSeek V4 — MashaGPT",
          "tool_call": true,
          "limit": {
            "context": 128000,
            "output": 4096
          },
          "headers": {
            "X-Session-Id": ""
          }
        },
        "gemini-3.1-pro-preview": {
          "name": "Gemini 3.1 Pro — MashaGPT",
          "tool_call": true,
          "limit": {
            "context": 128000,
            "output": 4096
          },
          "headers": {
            "X-Session-Id": ""
          }
        }
      }
    }
  }
}

Ключ отдельно от конфига

3. Установите плагин для OpenCode 2.0.20

macOS / Linux

~/.config/opencode/plugins/mashagpt-session-header.js

Windows

%USERPROFILE%\.config\opencode\plugins\mashagpt-session-header.js

// OpenCode 2.0.20 compatibility: MashaGPT reserves X-Session-Id for UUIDs.
const mashaSessionHeader = {
  id: "mashagpt-session-header",
  async setup(context) {
    await context.session.hook(
      "http.request",
      (event) => {
        const headers = new Headers(event.request.headers);

        headers.delete("x-session-id");
        event.request = new Request(event.request, { headers });
      },
      { providerID: "mashagpt" },
    );
  },
};

export default mashaSessionHeader;

Совместимость версий

4. Перезапустите OpenCode и включите модели

Полностью перезапустите OpenCode после сохранения обоих файлов.

В Desktop нажмите на название модели → «Управление моделями» → включите MashaGPT. В CLI откройте /models.

Выберите GPT-5.5, Grok 4.7, DeepSeek V4 или Gemini 3.1 Pro с подписью MashaGPT и отправьте короткий запрос.

opencode run --model mashagpt/gpt-5.5 "Ответь одним словом: готово"
opencode run --model mashagpt/grok-4.7 "Ответь одним словом: готово"
opencode run --model mashagpt/deepseek-v4 "Ответь одним словом: готово"
opencode run --model mashagpt/gemini-3.1-pro-preview "Ответь одним словом: готово"

Сохраните параметры примера

Выбирайте протокол по модели