OpenCode Claude Agent: настройка, лимиты подписки и правила

Чтобы использовать подписку Claude в OpenCode, подключите провайдер Claude Agent к своей локальной установке Claude Code. Установите оба инструмента, выполните claude auth login и выберите Claude Agent в /connect. Если команде нужен документированный способ аутентификации для стороннего продукта, выбирайте API-ключ.

По состоянию на 2026-11-05 у OpenCode есть отдельное руководство по Claude Agent. Провайдер использует текущий способ аутентификации Claude Code, поэтому его выбор сам по себе не переключает оплату на подписку.

Как устроен Claude Agent в OpenCode?

OpenCode предоставляет интерфейс и выполняет инструменты, а Claude Code отправляет запросы модели. Для этого OpenCode вызывает установленный у вас claude через Claude Agent SDK от Anthropic.

Встроенный провайдер появился в OpenCode v2.2.3. В v2.2.4 добавили пошаговую настройку при выборе провайдера в приложении. Отдельный плагин для подписки устанавливать не нужно.

Согласно описанию устройства провайдера, за операции с файлами, команды оболочки и разрешения отвечает OpenCode. Встроенные инструменты Claude Code отключены.

Сжатие контекста (compaction) и запуск субагентов тоже выполняет OpenCode, как поясняет текущее руководство по Claude Agent. Настройки Claude Code, его хуки (обработчики событий), MCP-серверы, навыки (skills) и память не загружаются.

Работу с проектом определяют инструкции и инструменты OpenCode. Проверьте их, прежде чем разрешать изменения файлов и запуск команд. Если ваш процесс зависит от хуков или команд агентов Claude Code, продолжайте работать в нём, пока не настроите подходящую замену.

Этот провайдер полезен, если вы хотите сохранить интерфейс OpenCode и переключаться между моделями в привычной среде. Полный набор возможностей Claude Code через него недоступен.

Как установить и подключить Claude Agent

Установите OpenCode V2 и Claude Code на машину, где работает сервер OpenCode. В удалённых рабочих пространствах OpenCode этот провайдер недоступен.

Для описанного ниже входа по личной подписке нужен действующий план Pro, Max или Ultra.

Перед входом проверьте условия доступа к Claude и список поддерживаемых регионов.

Установите подходящие версии

Для Claude Agent нужен OpenCode V2, начиная с v2.2.3. Для пошаговой настройки в приложении используйте v2.2.4 или новее.

Команды ниже предназначены для Bash в macOS, Linux или WSL. Они взяты из инструкции по установке OpenCode V2 и руководства по установке Claude Code:

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

Откройте новый терминал и проверьте обе версии:

opencode --version
claude --version

Нужен Claude Code 2.1.248 или новее: это требование проверки версии в провайдере. Если использовали установщик Claude Code, обновите программу командой claude update. Для установки через пакетный менеджер используйте его команду обновления.

Если вы уже работаете с V1, сначала прочитайте руководство по переходу на V2. Обе версии используют команду opencode и общие пути к файлам конфигурации.

Установка не включает подписку или оплаченный доступ к API. Если способ оплаты ещё не выбран, прочитайте о подписке, API и установке Claude Code.

Войдите и проверьте учётную запись

Войдите через штатную процедуру Claude Code. Если хотите расходовать лимит подписки, выберите аккаунт с этой подпиской:

claude auth login
claude auth status --text

Проверьте учётную запись и способ аутентификации в выводе команды. В справочнике CLI отдельно описан claude auth login --console: он выбирает оплату через Console API.

Перед проверкой подписки убедитесь, что окружение не содержит лишних учётных данных. Anthropic поясняет, что API-ключи из переменных окружения могут иметь приоритет над подпиской. Если в вашей оболочке случайно остался старый ключ, удалите эту переменную:

unset ANTHROPIC_API_KEY
claude auth status --text

Также проверьте, не заданы ли случайно ANTHROPIC_AUTH_TOKEN, ANTHROPIC_BASE_URL или настройки облачного провайдера. Сопоставьте их с порядком выбора учётных данных. Вход по подписке не отменяет все остальные способы аутентификации.

В конфигурации OpenCode проверьте providers.claude-agent.settings: там могут быть заданы apiKey, authToken или baseURL. Учитывайте и переопределения на уровне модели. Код подключения применяет эти настройки после переменных окружения сервера.

Подключите провайдер и выполните пробный запрос

Для первой проверки откройте терминал в каталоге проекта и запустите отдельный сервер OpenCode:

opencode --standalone

Режим standalone запускает отдельный сервер с окружением текущей оболочки. Вы не зависите от окружения уже работающей общей службы. При этом переопределения из конфигурации продолжают действовать.

В OpenCode выполните /connect и выберите Claude Agent. Затем выполните /models и выберите модель из списка, который вернул Claude Code. Провайдер может использовать псевдонимы вроде claude-agent/opus; они не обязаны совпадать с идентификаторами моделей прямого API.

В приложении пошаговая настройка предлагает установку, вход, проверку подключения и повторную проверку при ошибке. После успешной проверки открывается выбор модели. Эти элементы интерфейса относятся к приложению; для терминала используйте команды выше.

Для проверки выберите репозиторий с файлом README.md и отправьте запрос:

Read README.md and summarize the project in three sentences. Do not modify files or run shell commands.

Запрос просит прочитать файл и описать проект в трёх предложениях, без изменений и команд оболочки. Проверьте, что OpenCode показал вызов инструмента чтения файла и ответ по содержанию проекта. Так вы проверите запрос к модели и возврат результата инструмента.

Одного списка моделей недостаточно: проверка подключения не отправляет запрос к модели.

Укажите OPENCODE_CLAUDE_PATH, если Claude Code не найден

Укажите серверу путь к исполняемому файлу Claude Code, если поиск через PATH не находит нужную установку. Сначала убедитесь, что command -v claude в вашем терминале выводит путь к нужному исполняемому файлу.

Для повторной проверки с отдельным сервером:

export OPENCODE_CLAUDE_PATH="$(command -v claude)"
opencode --standalone

Для общей фоновой службы задайте переменную в её управляемом окружении:

opencode service set env OPENCODE_CLAUDE_PATH "$(command -v claude)"

Изменение окружения останавливает работающую службу. Следующая команда, которой нужен локальный сервер, запустит его с новым значением. Подключите Claude Agent заново и повторите короткий запрос.

Инструкция по окружению сервера объясняет, почему изменение переменной только в терминале клиента может не помочь.

Какие лимиты действуют и кто оплачивает запросы?

Расход зависит от учётных данных, которые сейчас использует Claude Code. При входе по подписке запросы Claude Agent расходуют её существующий лимит.

OpenCode указывает, что такой способ входа использует подписку. Anthropic подтверждает общие лимиты Claude и Claude Code. Из этих двух правил следует, что смена интерфейса не создаёт дополнительный лимит.

Различайте три случая:

Способ аутентификации Claude Code	Как оплачиваются запросы
Подписка Claude	Объём в пределах лимитов подписки; дополнительные платные запросы, если эта опция включена
Аккаунт Anthropic API или поддерживаемого облачного провайдера	По тарифам и лимитам API этого аккаунта
Другой API-шлюз	По правилам оплаты аккаунта на этом шлюзе

Отсутствие оценки стоимости не означает бесплатные запросы. Логика расчёта стоимости провайдера также не показывает оценку для нестандартного базового URL.

Расход и время восстановления лимита проверяйте в Claude Settings > Usage. Встроенный экран /usage из Claude Code внутри OpenCode недоступен. Также проверьте дополнительный платный расход — usage credits: если он включён, после исчерпания объёма подписки возможны отдельные списания.

Выбрать способ оплаты поможет сравнение подписки Claude и API.

Разрешает ли Anthropic такой способ входа?

Разрешение нужно оценивать для конкретной реализации и условий её использования. Сам по себе официальный SDK не даёт любому стороннему приложению права использовать учётные данные подписки.

Три документа описывают разные ситуации:

Официальный источник	Что в нём сказано	Что это означает для подключения
Старая страница провайдеров OpenCode	Anthropic запрещает плагины для доступа через подписки Pro/Max; OpenCode перестал включать их в поставку с 1.3.0.	Это предупреждение о прежних плагинах не описывает устройство нового провайдера V2.
Обзор Anthropic Agent SDK	Сторонним разработчикам нужно предварительное разрешение для входа через Claude и использования его лимитов в своих продуктах.	Использование SDK само по себе не подтверждает разрешение.
Правовые условия Claude Code	Документ ограничивает посредничество с учётными данными, но допускает вход пользователя со своей подпиской в неизменённый исполняемый файл Claude Code.	Используйте штатную процедуру входа; не переносите это разрешение на общие учётные данные или новый коммерческий сервис.

Есть и заявление о конкретной реализации. 2026-10-30 автор PR Tarquinen сообщил о разрешении Anthropic и назвал интеграцию соответствующей условиям использования. Это заявление участника проекта OpenCode. Оно не заменяет документ Anthropic, который определяет границы разрешения.

Для личной работы используйте собственный аккаунт через неизменённую установку Claude Code. Не переносите токены сессии в другой плагин. Для внедрения в компании или интеграции в продукт получите подтверждение для вашего сценария либо выберите документированный способ подключения по API-ключу.

Успешный запрос подтверждает работу подключения. Он не доказывает, что условия Anthropic допускают любой способ развёртывания.

Что проверить при ошибке подключения

Выберите проверку по наблюдаемой ошибке, затем повторите короткий запрос с чтением файла.

Ошибка или симптом	Что проверить и сделать дальше
Claude Code is not installed	Установите Claude Code на машину сервера OpenCode или задайте серверу OPENCODE_CLAUDE_PATH. Подключитесь заново.
Claude Code is not logged in	Выполните claude auth login на этой машине от имени того же пользователя. Проверьте статус и подключитесь заново.
В ошибке указано 2.1.248 or later is required	Обновите Claude Code и проверьте версию исполняемого файла перед повторной попыткой.
Подключение есть, но список моделей пуст или запрос не даёт ответа	Проверьте путь к Claude Code и вход на сервере. Подключитесь заново; обнаружение моделей ещё не подтверждает работу запросов.

В справочнике ошибок подключения разобраны случаи отсутствующей установки и невыполненного входа. Если запрос упирается в лимит плана, откройте страницу расхода аккаунта. Повторное подключение не восстанавливает лимит.

Когда перейти на API-ключ

Выбирайте API-ключ, если нужны отдельная оплата, сервер без локального Claude Code или документированный способ аутентификации для стороннего продукта. У API свои расходы и лимиты, отдельные от подписки Claude.

Прямое подключение к Anthropic API

Для прямого доступа создайте собственный ключ в Claude Console. В OpenCode выберите Anthropic через /connect и укажите способ аутентификации по API-ключу.

Та же команда аутентификации V2 запрашивает секрет интерактивно:

opencode auth login anthropic --method key
opencode run --standalone --model anthropic/claude-sonnet-5-5 "Reply with only: OK"

Проверьте ответ OK и расход в нужном API-аккаунте. Если выбраны другие модель или аккаунт, исправьте выбор через /connect или /models, затем повторите проверку.

Подключение через OpenAI-совместимый API

По состоянию на 2026-11-05 в каталоге BetterToken есть claude-sonnet-5-5 и claude-opus-5-5. Инструкция BetterToken для OpenCode описывает OpenAI-совместимый API с вашим собственным ключом BetterToken. Это отдельно оплачиваемый доступ к API.

К API BetterToken можно подключаться из России без VPN. Сервис также поддерживает пополнение баланса в рублях. Эти условия не распространяются на сторонние сайты, скачивание программ, вход в Claude, подписки и обновления инструментов. Доступные способы оплаты, поддерживаемые карты, минимальную сумму пополнения, курс, комиссии и сроки зачисления проверяйте в консоли при оплате.

Создайте ключ в своей консоли BetterToken. Для новой конфигурации V2 добавьте этот провайдер в проектный файл opencode.jsonc, сохранив остальные настройки:

{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "bettertoken": {
      "name": "BetterToken",
      "env": ["BETTERTOKEN_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://www.bettertoken.ai/v1"
      },
      "models": {
        "claude-sonnet-5-5": {
          "name": "Claude Sonnet 5.5"
        }
      }
    }
  }
}

Пример использует формат собственного провайдера V2: providers, package и settings. Не смешивайте с ними поля V1 внутри одной записи провайдера.

Введите ключ без отображения на экране, затем выполните проверку в том же терминале Bash:

read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY
opencode run --standalone --model bettertoken/claude-sonnet-5-5 "Reply with only: OK"

Ожидаемый результат — обычный ответ с OK. После него проверьте запрос и списание в консоли. Если в OpenCode уже сохранён аккаунт BetterToken, проверьте, какой аккаунт активен: сохранённые учётные данные имеют приоритет над подключением через окружение.

Перед большой задачей посмотрите текущие цены. Этот способ доступа к API не включает подписку Claude и не разрешает другие интеграции, использующие вход по подписке.