Примечание автора: в OpenCode 2.2.3 появился провайдер Claude Agent. Разбираемся, чем он отличается от OAuth-плагина, удалённого в марте, как подключить его за 3 шага и о каких 5 ограничениях стоит знать.
30 октября вышел OpenCode 2.2.3 со встроенным провайдером Claude Agent. Чтобы его подключить, нужно установить Claude Code на свой компьютер, один раз выполнить claude auth login, а затем выбрать Claude Agent в меню /connect OpenCode. После этого можно пользоваться моделями Claude через собственную подписку. К 31 октября официальный анонс @opencode набрал около 510 тысяч просмотров.
Это не тот OAuth-плагин, который удалили в марте. Новое решение использует официальный исполняемый файл Claude Code и Claude Agent SDK. OpenCode не читает и не хранит ваши данные для входа: запросы к модели отправляет локальный процесс claude. Команда OpenCode утверждает, что получила разрешение Anthropic, но сама Anthropic отдельного объявления не публиковала.
Разработчик Чэнь Чэн (@chenchengpro) разобрал реализацию: при запуске задаются tools: [] и settingSources: [], а из инструментов разрешены только mcp__opencode__*. Поскольку обработчик MCP не получает tool_use_id, его приходится записывать через хук PreToolUse — по одному за раз. Поэтому параллельное чтение файлов превращается в последовательное. Системный промпт при этом остаётся встроенным промптом Claude Code. По оценке разработчика, «результат точно будет хуже, чем при прямом использовании Claude Code». В статье — 3 шага для подключения, 5 ограничений и рекомендации для трёх категорий пользователей.
Уточнение: статья подготовлена на основе заметок к релизу OpenCode, документа с описанием архитектуры в PR #58782, официальной документации Claude Code и отзывов сообщества. Сквозное тестирование не проводилось.
Claude по подписке в OpenCode: коротко о главном
Вывод в трёх пунктах: это работает, но старый способ больше не подходит, а у нового есть ограничения.
- Что понадобится: OpenCode V2 версии 2.2.3 или выше; Claude Code на том же компьютере с выполненным входом через
claude auth login. - Как это работает: OpenCode обращается к локальному процессу
claudeчерез Claude Agent SDK. OpenCode не реализует OAuth самостоятельно, не читает и не хранит токены. - Какие ограничения: вызовы инструментов выполняются последовательно; многие функции Claude Code недоступны; работать можно только локально — hosted- и remote-окружения не поддерживаются.
Насчёт «бесплатно» стоит сразу уточнить: бесплатный тариф Claude не включает Claude Code, поэтому этот способ с ним не сработает. Нужен один из тарифов Pro, Max, Ultra, Team, Enterprise или аккаунт Console. Это не бесплатный доступ: использование по-прежнему расходует лимиты вашей подписки за 5 часов и за неделю. Просто в интерфейсе OpenCode будет отображаться $0, поскольку расходы уже покрыты подпиской.
Если подписки нет или команде нужна общая точка доступа, можно использовать API с оплатой по факту. Например, вызывать модели Claude через OpenAI-совместимый интерфейс APIYI на apiyi.com. Этот способ не привязан к конкретному компьютеру и не ограничен квотами подписки.
Почему поддержку подписок Claude в OpenCode убрали в марте, а в октябре вернули
В 2026 году было четыре ключевых события:
- 9 января: Anthropic ужесточила ограничения для сторонних оболочек. В тот же день в OpenCode появился issue #7410 «Broken Claude Max»: пользователи сообщили, что Claude Max внезапно начал выдавать ошибку.
- 20 февраля: зарубежные СМИ сообщили, что Anthropic изменила условия и прямо запретила использовать OAuth-токены в других продуктах, в том числе созданных на базе Agent SDK.
- 19 марта: OpenCode принял PR #18186 «anthropic legal requests», удалил встроенный плагин
opencode-anthropic-authи убрал anthropic из списка провайдеров. - 30 октября: в OpenCode 2.2.3 вернулась поддержка Claude Agent, а вышедшая в тот же день версия 2.2.4 добавила пошаговую настройку.
Поворотный момент — изменение самих условий. В архивной копии страницы Anthropic с юридической информацией от 21 февраля, сохранённой в Wayback Machine, ещё говорилось, что использование OAuth-токенов подписок Free, Pro и Max в любых других продуктах, инструментах или сервисах, включая Agent SDK, нарушает пользовательское соглашение для физических лиц (Consumer ToS). В архивной копии от 30 сентября этой фразы уже не было. Вместо неё появилось исключение: конечные пользователи могут входить со своей подпиской в немодифицированный исполняемый файл Claude Code, в том числе когда Claude Code размещён на платформе. В октябрьской версии страницы это исключение сохранилось.
Claude Agent в OpenCode реализован с учётом этого исключения. В комментариях к PR #58782 один из пользователей спросил, не приведёт ли это к блокировке аккаунта. Автор PR Tarquinen ответил, что получил разрешение Anthropic и решение полностью соответствует условиям использования. Участник OpenCode Daniel Smolsky также написал в X: «We got permission» («Мы получили разрешение»). Однако по состоянию на 31 октября отдельного объявления Anthropic по этому поводу найти не удалось, поэтому пока о получении разрешения заявляет только OpenCode.
| Критерий | OAuth-плагин до марта | Claude Agent в октябре |
|---|---|---|
| Способ входа | OpenCode самостоятельно проходит OAuth-авторизацию через claude.ai и получает токен | Пользователь выполняет claude auth login в локально установленном Claude Code |
| Кто отправляет запросы | OpenCode напрямую вызывает Anthropic API | Локальный процесс claude отправляет запросы через Agent SDK |
| Чтение и хранение токена | Плагин хранит OAuth-токен | Токен не читается и не хранится; /connect лишь запоминает выбранный способ |
| Позиция Anthropic | В феврале условия прямо запретили такой способ, в марте плагин убрали | OpenCode заявляет о получении разрешения; в сентябре в условия добавили исключение, отдельного объявления нет |
| Риски | Риск блокировки аккаунта и удаления плагина | Ниже, чем в марте, но политика может снова измениться |
О рисках стоит сказать прямо. Действующие условия оставляют за Anthropic право применять меры без предварительного уведомления и по-прежнему запрещают сторонним сервисам собирать, хранить или передавать учётные данные Claude. Поэтому при подключении важно помнить о двух вещах: не устанавливайте старые OAuth-плагины, которые гуляют по сети, и не доверяйте свой аккаунт чужим платформам для запуска запросов от вашего имени.
Как работает OpenCode Claude Agent: цепочка и причины последовательного выполнения
Вся цепочка выглядит так: OpenCode → Claude Agent SDK → локальный claude → Anthropic. OpenCode не встаёт между Claude Code и Anthropic и не изменяет запросы. По умолчанию исполняемый файл claude ищется в PATH, но путь к нему можно задать и через переменную окружения OPENCODE_CLAUDE_PATH.
При запуске многие функции Claude Code отключаются или заменяются. Всё это можно свести к трём отключениям, одной замене и последовательному выполнению:
- Отключаются встроенные инструменты: настройка
tools: []исключает все встроенные в Claude Code инструменты чтения, записи и Bash. - Отключаются пользовательские настройки: при
settingSources: []не читаются~/.claudeи.claudeв проекте, а также не загружаются CLAUDE.md, hooks, skills и MCP-серверы. - Разрешаются только инструменты OpenCode: доступны только инструменты с префиксом
mcp__opencode__*. Если Claude вызовет инструмент с другим именем, он получит ответNo such tool available, а OpenCode не выполнит вызов. - Заменяется реализация инструментов: OpenCode предоставляет свои инструменты через MCP-сервер внутри процесса. При их выполнении используются собственные запросы OpenCode на получение разрешений. Системный промпт остаётся встроенным промптом Claude Code с добавлением фразы «запущено в opencode», выбранного вами промпта агента и AGENTS.md.
- Инструменты выполняются последовательно: обработчик инструментов OpenCode не получает
tool_use_idот Claude напрямую. Его сначала сохраняет хукPreToolUse, откуда идентификатор затем извлекается. Хук может сохранить только один ID за раз, поэтому инструменты нельзя пометить как пригодные для параллельного выполнения. Если обычно Claude может одновременно прочитать несколько файлов, то здесь он делает это по очереди.
У такого решения OpenCode есть свои причины. Формат истории сессии остаётся одинаковым независимо от того, какая модель сгенерировала содержимое, поэтому при переключении моделей не возникает путаницы. Кроме того, везде используется единая система разрешений. Плата за это — потеря многих возможностей Claude Code. Чэнь Чэн оценивает это так: «После всех этих изменений результат наверняка будет хуже, чем при прямом использовании Claude Code». Это стоит обдумать до того, как решать, подключать ли интеграцию.
Есть и ещё несколько деталей работы: для каждой сессии запускается долгоживущий процесс claude. После 5 минут бездействия он останавливается и возобновляет работу при следующем сообщении. Неудачные запросы повторяет сам Claude Code — OpenCode дополнительно их не повторяет.
Подключение подписки Claude к OpenCode за 3 шага
Прежде чем начать, убедитесь, что выполнены 5 условий:
- Установлен OpenCode V2 версии 2.2.3 или новее, а не V1.
- Claude Code установлен локально.
- У аккаунта Claude есть платная подписка либо это аккаунт Console.
- OpenCode и Claude Code установлены на одном компьютере.
- Вы используете не hosted opencode и не remote workspace.
Команда для установки V2: curl -fsSL https://opencode.ai/v2/install | bash. Также можно скачать десктопную версию.
Шаг 1: установите Claude Code
Что вы увидите: выполните в терминале команду claude --version. Если появится сообщение, что команда не найдена, значит Claude Code ещё не установлен.
Что делать: в macOS и Linux используйте официальный скрипт install.sh, а в Windows запустите официальный скрипт install.ps1 в PowerShell. Если Claude Code уже установлен, но его версия устарела, выполните claude update.
Как проверить результат: команда claude --version должна вывести номер версии.
Шаг 2: Войдите в аккаунт Claude
Что вы увидите: после выполнения claude auth login в браузере откроется страница входа Anthropic.
Что делать: войдите в свой платный аккаунт Claude, затем выполните claude auth status, чтобы проверить статус.
Как понять, что всё получилось: в качестве способа аутентификации указан вход по подписке, а не api_key или none.
Здесь есть нюанс: если в вашей оболочке задан ANTHROPIC_API_KEY, Claude Code может использовать API-ключ в первую очередь, и тогда плата будет взиматься по фактическому использованию. Перед входом выполните unset ANTHROPIC_API_KEY; если Claude Code спросит, использовать ли этот ключ, откажитесь.
Шаг 3: Подключите Claude Agent в OpenCode
Что вы увидите: введите /connect в OpenCode — появится список провайдеров.
Что делать: выберите Claude Agent, а не «Anthropic». Затем с помощью /models выберите модель Claude. В версиях 2.2.4 и новее есть пошаговая настройка: она поможет скопировать команду для входа, проверить установку и подключение. Когда все проверки будут пройдены, можно будет выбрать модель. Если вам привычнее работать в командной строке, то же самое можно сделать с помощью opencode auth login.
Как понять, что всё получилось: вы можете выбрать модель Claude из списка, получить ответ на тестовый промпт, а при вызове инструментов в OpenCode появляется окно запроса разрешения.
Чек-лист для устранения неполадок
- Claude Agent нет в списке: выполните
opencode --versionи проверьте версию. Если она ниже 2.2.3, обновите OpenCode. Также убедитесь, что установлена V2. - Появляется сообщение, что claude не найден: проверьте
PATHили укажите абсолютный путь кclaudeчерезOPENCODE_CLAUDE_PATH. - Постоянно возвращает на страницу входа: некоторые пользователи ранних версий сообщали, что после одного-двух подключений связь обрывается, а при повторном подключении открывается страница входа. Сообщество работает над исправлением. Пока можно снова выполнить в терминале
claude auth login, а затем вернуться к/connect. - Появляется сообщение о достижении plan limit: вы исчерпали лимит подписки за 5 часов или за неделю. Остаётся только дождаться сброса лимита.
- Не удаётся подключиться в удалённой среде: это не поддерживается по замыслу разработчиков — использовать можно только на локальном компьютере.
Ещё один важный момент: в документации OpenCode V1 по провайдерам до сих пор осталось старое предупреждение «Anthropic запрещает Pro/Max» — оно отражает правила, действовавшие до марта. Не ищите Claude Agent в /connect версии V1: он доступен только в V2.
5 ограничений подписки Claude в OpenCode
| Ограничение | Как проявляется | Кого затрагивает сильнее всего |
|---|---|---|
| Последовательный запуск инструментов | Хук запоминает только один tool_use_id за раз, поэтому файлы читаются по очереди, а не параллельно |
Работа с большими репозиториями, рефакторинг сразу нескольких файлов |
| Системный промпт не от OpenCode | Используется системный промпт Claude Code, а встроенный промпт OpenCode не действует | Те, кто рассчитывает на стандартное поведение агента OpenCode |
| Функции Claude Code недоступны | Нет /usage, auto mode, memory, cloud sessions, agent teams и других функций |
Активные пользователи Claude Code |
| Только на локальной машине | Режимы hosted и remote не поддерживаются, claude должен работать на той же машине |
Облачная разработка, удалённые команды, CI |
| Ограничения параметров и плагинов | Не поддерживаются temperature, top-p, seed, stop и другие параметры; хук http.request не запускается |
Те, кому нужна тонкая настройка параметров или работа через шлюз |
Последовательный запуск инструментов: в небольшом проекте разница почти незаметна. Но если для задачи нужно просмотреть десятки файлов, ждать придётся заметно дольше. Если вы часто занимаетесь масштабным рефакторингом, учитывайте эти дополнительные затраты времени.
Системный промпт не от OpenCode: пользовательские промпты агентов по-прежнему работают, но базовый промпт используется от Claude Code. Если вы привыкли к поведению встроенного агента OpenCode, после перехода стиль модели может показаться немного другим.
Недоступные функции: это ограничение влияет сильнее всего. В проектной документации перечислены функции, которые есть в Claude Code, но недоступны в OpenCode: auto mode, ultracode, auto memory, away summaries, cloud sessions, /teleport, agent teams, /loop, computer use, sandboxed Bash, notebook editing, а также встроенные навыки /simplify, /verify и другие.
Только на локальной машине: процесс Claude останавливается после 5 минут бездействия и возобновляется при следующем сообщении. Использовать его таким образом в CI или на удалённой машине для разработки нельзя.
Ограничения параметров и плагинов: параметры сэмплирования не поддерживаются. Базовый URL и заголовки считываются только из файла конфигурации — плагины не могут менять их для отдельных запросов. Хуки http.request и http.response тоже не запускаются, поскольку запросы отправляет Claude Code.
Есть ещё несколько нюансов с использованием подписки: в OpenCode нельзя посмотреть /usage Claude; при достижении лимита работа автоматически не продолжится; купить дополнительные объёмы здесь тоже нельзя. Команда /usage самого OpenCode показывает использование OpenCode Console и не связана с квотой вашей подписки Claude. Кроме того, встречаются утверждения, что пользователям claude -p и SDK доступно меньше ресурсов подписки, чем при обычной работе с Claude Code. Но в проектной документации прямо указано, что это «не проверено», поэтому пока считать это фактом нельзя.
Если коротко: если вам нужны auto mode, memory, cloud sessions, agent teams, computer use или notebook editing, используйте Claude Code напрямую. Этот вариант стоит рассматривать, только если вам нужна модель Claude с инструментами и системой разрешений OpenCode и вы готовы мириться с последовательным запуском инструментов.
Подписка Claude в OpenCode: кому стоит попробовать, а кому — нет
Условно пользователей можно разделить на три группы:
- Уже используете OpenCode 2.x, у вас есть подписка Claude и вы пишете код только на своём компьютере: стоит попробовать. Вы сможете переключаться между Claude и другими моделями в одной среде, не оплачивая API отдельно.
- Пользуетесь только Claude Code: не усложняйте. Работайте напрямую в Claude Code: там больше функций, инструменты могут выполняться параллельно, а промпт остаётся оригинальным.
- Работаете в команде, используете CI или удалённую разработку либо зависите от auto mode, memory и панели лимитов: этот вариант вам не подойдёт. Решение работает только локально, часть функций отсутствует, а расходы сложно отслеживать. Лучше использовать API-ключ или APIYI apiyi.com с оплатой по факту использования.
| Вариант | Цена (на 27 октября) | Кому подойдёт |
|---|---|---|
| Claude Pro | $20/мес. | Для личного умеренного использования; есть пятичасовые и недельные лимиты |
| Claude Max / Ultra | $100 / $200 в месяц | Для интенсивного личного использования |
| Клиент OpenCode | Бесплатный, с открытым исходным кодом | Всем |
| OpenCode Go (необязательно) | $10/мес. | Тем, кому нужны модели, размещённые в OpenCode; для использования Claude Agent не требуется |
| APIYI Claude Opus 5.5 | Входящие токены — $4 / исходящие — $20 | Для командной работы, CI и прозрачного учёта расходов |
| APIYI Claude Sonnet 5.5 / Haiku 5.5 | $2/$10, $0.1/$0.5 | Для повседневной работы с кодом и пакетных задач |
Цены APIYI в таблице указаны за миллион токенов, чтение из кэша оплачивается отдельно.
💰 Совет по оплате по факту использования: если у вас нет подписки, нужен общий доступ для команды или важно точно учитывать расходы, можно воспользоваться APIYI apiyi.com. Сервис предоставляет эндпоинт
messages(нативный формат Anthropic) и эндпоинтchat(формат, совместимый с OpenAI); в качестве base_url укажитеhttps://api.apiyi.com/v1. Актуальные модели и цены смотрите в списке моделей на платформе.
Часто задаваемые вопросы FAQ
Q1: Могут ли заблокировать аккаунт за использование подписки Claude в OpenCode?
Риск ниже, чем в марте: новая схема использует официальный бинарный файл, OpenCode не считывает токен и соблюдает исключение, добавленное в условия в сентябре. Но о том, что разрешение получено, сообщает сам OpenCode — Anthropic не делала отдельного заявления и оставляет за собой право принимать меры без предварительного уведомления. Не используйте старые плагины OAuth.
Q2: Почему в /connect нет Claude Agent?
Чаще всего дело в версии: она ниже 2.2.3 или вы всё ещё используете V1. Обновитесь до последней версии V2 и найдите в `/connect` пункт «Claude Agent», а не «Anthropic».
Q3: OpenCode показывает расходы $0. Это действительно бесплатно?
Нет. $0 отображается потому, что расходы уже покрыты подпиской. При этом использование всё равно расходует пятичасовой и недельный лимиты подписки. Если вы используете API-ключ, OpenCode покажет стоимость по тарифам с models.dev.
Q4: Можно ли использовать OpenCode на удалённой машине для разработки или в облаке?
Нет. `claude` и OpenCode должны быть установлены на одной машине; размещённые и удалённые рабочие пространства не поддерживаются. Для работы в облаке или CI рекомендуется использовать API-ключ либо оплачивать вызовы по фактическому использованию через APIYI apiyi.com.
Q5: Что выбрать: подключение по подписке или API-ключ?
Подписка подойдёт для личной работы на своём компьютере, если она у вас уже оплачена. API-ключ не привязан к машине, его могут использовать несколько человек, расходы легко отследить, а лимиты подписки на него не распространяются. Если хотите сравнить Claude с другими моделями, в APIYI apiyi.com можно переключаться между ними для тестирования с одним ключом.
Q6: Можно ли использовать бесплатную версию Claude?
Нет. Бесплатная версия не включает Claude Code. Нужен как минимум тариф Pro либо аккаунт Team, Enterprise или Console.
Кратко: подписка Claude в OpenCode в трёх предложениях
Подключить можно: OpenCode версии 2.2.3 и выше вызывает локально установленный claude через официальный Agent SDK; по заявлению OpenCode, Anthropic разрешила такое использование, но политика может измениться. Как подключить: установите Claude Code, выполните claude auth login, затем выберите Claude Agent в /connect. Когда лучше не подключать: если вам нужны параллельная работа с инструментами, все функции Claude Code, удалённая или командная работа, используйте Claude Code напрямую либо вызывайте Claude через APIYI на apiyi.com с оплатой по факту использования.
Автор: техническая команда APIYI
Технические вопросы: по вопросам подключения моделей Claude свяжитесь с нами через главную страницу APIYI на apiyi.com; документация доступна на docs.apiyi.com.
