> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmeasy.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Настройка кастомной модели OpenCode через LLMEasy

> Подключите LLMEasy к OpenCode с ID моделей группы GPT.

OpenCode можно подключить к LLMEasy так: сначала добавьте credentials через `/connect`, затем объявите LLMEasy как OpenAI-compatible provider в конфиге и выберите ID модели из группы **GPT**.

## Требования

* API Key LLMEasy (<a href={"https://www.llmeasy.ru/register"}>зарегистрироваться</a>)

## Установка OpenCode

<Tabs>
  <Tab title="curl">
    ```bash theme={null}
    curl -fsSL https://opencode.ai/install | bash
    ```
  </Tab>

  <Tab title="npm">
    ```bash theme={null}
    npm install -g opencode-ai
    ```
  </Tab>
</Tabs>

## Настройка

<Tabs>
  <Tab title="Автоматическая настройка">
    Можно запустить автоматический скрипт LLMEasy. Он записывает только provider-конфигурацию LLMEasy и не заменяет предварительные требования выше. Скрипту нужен `Node.js`. Если API Key или модель не переданы явно, скрипт запросит их интерактивно, когда это поддерживается.

    Выберите шаг для своей ОС. Нужен только один вариант.

    <Steps>
      <Step title="macOS / Linux">
        ```bash theme={null}
        curl -fsSL https://www.llmeasy.ru/install-opencode-provider.sh | bash
        ```
      </Step>

      <Step title="Windows">
        ```powershell theme={null}
        iwr https://www.llmeasy.ru/install-opencode-provider.ps1 -OutFile "$env:TEMP\install-opencode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-opencode-provider.ps1"
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="Настройка через CC Switch">
    Этот путь описан в [инструкции CC Switch](/ai-tools/cc-switch#opencode).

    Перейдите сразу к [вкладке OpenCode в инструкции CC Switch](/ai-tools/cc-switch#opencode).

    После настройки в CC Switch вернитесь на эту страницу, чтобы проверить запуск и остальные примечания.
  </Tab>

  <Tab title="Ручная настройка">
    <Steps>
      <Step title="Очистите конфликтующие переменные окружения">
        ```bash theme={null}
        unset OPENAI_API_KEY
        unset OPENAI_BASE_URL
        ```
      </Step>

      <Step title="Сначала добавьте credential LLMEasy через /connect">
        Запустите OpenCode и выполните:

        ```bash theme={null}
        /connect
        ```

        В мастере выберите **Other**, затем:

        * задайте **provider id** как `llmeasy`
        * вставьте API Key LLMEasy

        OpenCode сохранит credential в `~/.local/share/opencode/auth.json`.
      </Step>

      <Step title="Отредактируйте конфиг OpenCode">
        Можно использовать глобальный конфиг `~/.config/opencode/opencode.json` или создать `opencode.json` в корне проекта. Project config имеет более высокий приоритет.

        ```json theme={null}
        {
          "$schema": "https://opencode.ai/config.json",
          "model": "llmeasy/YOUR_GPT_MODEL_ID",
          "provider": {
            "llmeasy": {
              "npm": "@ai-sdk/openai-compatible",
              "name": "LLMEasy",
              "options": {
                "baseURL": "https://www.llmeasy.ru/v1"
              },
              "models": {
                "YOUR_GPT_MODEL_ID": {
                  "name": "YOUR_GPT_MODEL_ID"
                }
              }
            }
          }
        }
        ```

        Замените `YOUR_GPT_MODEL_ID` на актуальный ID модели группы **GPT** из <a href={"https://www.llmeasy.ru/pricing"}>model plaza</a>.
      </Step>

      <Step title="Если нужно inline API key, используйте fallback-формат">
        ```json theme={null}
        {
          "$schema": "https://opencode.ai/config.json",
          "model": "llmeasy/YOUR_GPT_MODEL_ID",
          "provider": {
            "llmeasy": {
              "npm": "@ai-sdk/openai-compatible",
              "name": "LLMEasy",
              "options": {
                "baseURL": "https://www.llmeasy.ru/v1",
                "apiKey": "YOUR_API_KEY"
              },
              "models": {
                "YOUR_GPT_MODEL_ID": {
                  "name": "YOUR_GPT_MODEL_ID"
                }
              }
            }
          }
        }
        ```

        Это fallback. Предпочтительный путь — `/connect` выше.
      </Step>

      <Step title="Используйте `options.headers` только для provider-specific задач">
        Официальная документация OpenCode поддерживает custom headers через `provider.<id>.options.headers`, но это optional. При подключении LLMEasy обычно не нужен дополнительный `User-Agent`.

        Если вы также используете Helicone, tenant routing, observability или кеширующие сервисы, добавляйте нужные headers по официальной документации этих upstream-сервисов.
      </Step>

      <Step title="Перезапустите OpenCode">
        После обновления конфига завершите текущую сессию OpenCode и запустите ее снова.
      </Step>

      <Step title="Запустите OpenCode">
        ```bash theme={null}
        cd /path/to/your/project
        opencode
        ```
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Связанные FAQ

* [OpenAI-compatible API и Anthropic-compatible API](/faq/concepts/openai-compatible-vs-anthropic-compatible)
* [MCP и API Key / Base URL](/faq/concepts/mcp-vs-api-key-base-url)
* [Что такое model\_provider, base\_url и wire\_api?](/faq/codex/model-provider-base-url-wire-api)
* [Как настроить OpenAI-compatible API в Cline](/faq/cline/openai-compatible-api)

## Примечания

* Используйте ID модели группы **GPT** по умолчанию вместо фиксированных имен Claude-моделей
* Для LLMEasy сейчас следует использовать `@ai-sdk/openai-compatible` как OpenAI-compatible provider adapter
* Если вы используете `/connect`, обычно не нужно хранить API key прямо в конфиге
* Официальная документация OpenCode трактует `options.headers` как optional extended configuration; LLMEasy обычно не требует extra headers