Примечание автора: в материковом Китае не получится зайти на официальный сайт Claude, а даже если получится, есть риск блокировки аккаунта. Это касается и граждан материкового Китая, и иностранцев, приехавших сюда туристами. В этой статье покажем, как за 15 минут подключить claude-opus-5-5 к чат-приложению и агенту для написания кода с помощью APIYI. В качестве чат-приложения возьмём Cherry Studio, а агентами будем управлять через Magpie.
Чтобы стабильно пользоваться claude-opus-5-5 в материковом Китае, нужен всего лишь ключ, который можно пополнить через WeChat или Alipay и указать в разных приложениях. APIYI (apiyi.com) — это агрегатор API больших языковых моделей: один API-ключ позволяет вызывать Claude, OpenAI, Gemini и другие популярные модели. Платформа поддерживает совместимый с OpenAI интерфейс и тарификацию по фактическому использованию. В этой статье мы подключим claude-opus-5-5 к чат-приложению (на примере Cherry Studio), а затем — к агенту для написания кода (управлять им будем через Magpie). Всё делается в графическом интерфейсе: от регистрации до первого сообщения — около 15 минут.
Официальный сайт недоступен, а даже если получится зайти — есть риск блокировки аккаунта
Если вы находитесь в материковом Китае, воспользоваться официальным сайтом Claude не получится. Сайт, приложение и официальная подписка — все эти варианты недоступны пользователям из материкового Китая. Дело не в неправильно настроенных параметрах и не в браузере: его замена ничего не решит.
Даже если обойти ограничения, аккаунт всё равно могут заблокировать. Вместе с ним можно потерять остаток средств и историю переписки. Официальная поддержка не восстановит данные, да и подать апелляцию будет некуда. Заплатить, накопить историю диалогов и в итоге остаться ни с чем — сомнительная затея.
Надёжнее подключить Claude через APIYI. Укажите модель claude-opus-5-5. Входить на официальный сайт Claude не нужно: достаточно адреса, токена и названия модели. Заполните этими данными настройки программы — и можно пользоваться.
Сначала получите токен Claude в APIYI
Прежде чем начать, ознакомьтесь с пятью важными моментами. Именно на них чаще всего ошибаются, и каждый из них ещё встретится дальше.
| Важный момент | Что делать | Что будет, если ошибиться |
|---|---|---|
| В названии модели используйте дефисы | Пишите claude-opus-5-5, только через дефисы |
Если написать claude-opus-5.5, система сообщит, что модель не найдена |
| Отключить режим размышлений нельзя | Режим размышлений для этой модели нельзя отключить — не указывайте disabled |
Запрос с disabled вернёт ошибку 400. Если нужно сэкономить время, выберите низкий уровень effort — low |
Проверьте, нужен ли /v1 в адресе |
Для клиентов с протоколом Anthropic укажите корневой домен, а для клиентов, совместимых с OpenAI, добавьте /v1 |
Если добавить лишнюю часть или пропустить нужную, сервер вернёт 404 |
| Выберите правильную группу | Для чата используйте Default, а для Agent, который пишет код, обязательно выберите ClaudeCode | Если выбрать не ту группу, Agent не сможет выполнить вызов или он обойдётся дороже |
| Сначала установите небольшой лимит | Для первого API-ключа задайте совсем небольшой лимит | Если в настройках будет ошибка, лимит ограничит возможные потери |
Для начала вам понадобятся только электронная почта, браузер, в котором открывается сайт APIYI, и привычное приложение для чата. Если планируете писать код, установите ещё и Magpie. Инструкция рассчитана на новичков: на каждом шаге мы расскажем, зачем он нужен, что вы увидите, куда нажать, как понять, что всё получилось, и сколько примерно времени это займёт. Весь процесс займёт около 15 минут:
- Шаг 1. Регистрация аккаунта — около 3 минут.
- Шаг 2. Пополнение через WeChat Pay или Alipay — около 2 минут.
- Шаг 3. Создание двух API-ключей — около 3 минут.
- Шаг 4. Отправка первого сообщения в приложении для чата — около 4 минут.
- Шаг 5. Подключение Agent для написания кода через Magpie — около 3 минут.
Шаг 1. Зарегистрируйте аккаунт (около 3 минут)
Ваша цель — получить аккаунт APIYI, в который можно войти. Откройте в браузере api.apiyi.com, нажмите кнопку регистрации и следуйте инструкциям, чтобы зарегистрироваться и войти с помощью электронной почты. После успешного входа откроется панель управления, где будет показан баланс.
Согласно документации, новым аккаунтам предоставляется небольшой пробный баланс — его примерно хватит на одно-два коротких сообщения. Точная сумма зависит от вашего аккаунта, поэтому не рассчитывайте на то, что пробный баланс обязательно будет. Этот шаг можно считать завершённым, когда откроется панель управления и вы увидите сумму на балансе.
Если после регистрации панель управления не открылась, проверьте, не пришло ли письмо для подтверждения, а затем загляните в папку со спамом. После входа добавьте сайт в закладки браузера: позже сюда нужно будет возвращаться, чтобы создавать API-ключи и смотреть логи.
Шаг 2. Пополните баланс (около 2 минут)
Ваша цель — пополнить счёт на небольшую сумму. Найдите в панели управления раздел пополнения, выберите WeChat Pay или Alipay и оплатите по QR-коду. Для первого раза лучше внести совсем небольшую сумму: сначала проверьте, что всё работает, а затем пополните баланс при необходимости. Так даже в случае ошибки потери будут невелики. После оплаты обновите страницу. Если сумма на балансе увеличилась, значит, шаг выполнен.
Перед пополнением баланса стоит сначала взглянуть на цены. Эти цифры взяты из общей таблицы цен на модели APIYI (docs.apiyi.com/models). На странице указано, что данные обновлены 2026-10-23 в 06:05. Все цены приведены в долларах за миллион токенов при множителе группы Default, равном 1. claude-opus-5 указан только для сравнения — в этой статье мы не будем его подключать.
| Позиция тарификации | claude-opus-5-5 | claude-opus-5-5-thinking | claude-opus-5 (для сравнения) |
|---|---|---|---|
| Входные данные | 4 доллара | 4 доллара | 5 долларов |
| Выходные данные | 20 долларов | 20 долларов | 25 долларов |
| Чтение из кэша | 0,20 доллара | 0,20 доллара | 0,50 доллара |
Сначала разберёмся с тремя столбцами, чтобы правильно читать цены. «Ввод» — это токены, которые вы отправляете модели, «вывод» — токены в ответе модели, а «чтение из кэша» — цена за входные токены, которые попали в кэш промптов. Для claude-opus-5-5 чтение из кэша стоит 5% от цены ввода, а для claude-opus-5 — 10%. Поэтому, если вы снова и снова отправляете один и тот же большой контекст, попадание в кэш заметно снижает расходы. Токены, которые в кэш не попали, по-прежнему оплачиваются по обычной цене. На странице с ценами те же тарифы указаны и для claude-opus-5-5-thinking — у обеих моделей одинаковая стоимость. Модель поддерживает два типа эндпоинтов: chat и messages. В столбце с группами перечислены пять вариантов: ClaudeCode, Claude_Reverse, Claude_Enterprise, Default и SVIP. Пометки о ступенчатых тарифах рядом с названием модели нет, поэтому цена рассчитывается по этим трём строкам независимо от объёма запроса.
Рассмотрим ещё один типичный вызов. Если рассчитать стоимость по указанным выше тарифам — это не фактический счёт, — за 20 000 входных токенов и 2000 выходных токенов в группе Default получится 0,12 доллара. Для той же операции в группе ClaudeCode с коэффициентом 0,95 стоимость составит 0,114 доллара. Точную сумму смотрите в записях журнала консоли.
Стоимость считается так: 20 тысяч входных токенов по 4 доллара за миллион — это 0,08 доллара, а 2 тысячи выходных токенов по 20 долларов за миллион — ещё 0,04 доллара. В сумме получается ровно 0,12 доллара. Если задать в чате один-два вопроса, расход обычно будет намного меньше, поэтому для первого раза достаточно пополнить счёт на небольшую сумму — её хватит на все шаги.
У пополнения счёта тоже есть свои условия — давайте разберём их. APIYI рассчитывается по фиксированному курсу 1:7. Минимальная сумма пополнения — 5 долларов, то есть примерно 35 юаней. При пополнении начисляется бонус: согласно странице с ценами, с его учётом фактическая стоимость может снизиться до 1/1,1 от прайса (примерно 91% от цены). Во время акций она может опуститься до 1/1,2 (примерно 83% от цены). Бонус суммируется со скидкой для группы из таблицы, поэтому за один и тот же вызов модели обычно списывается немного меньше, чем при расчёте по прайсу. Точную сумму списания смотрите в консоли.
Кроме того, по официальным данным Anthropic, claude-opus-5-5 генерирует более чем на 30% быстрее, чем предыдущее поколение Opus 5. Это заявление компании, а не результат измерений в этой статье.
Шаг 3. Создайте два ключа (около 3 минут)
Нужно получить два ключа, начинающихся с sk-: один для приложения чата, другой — для агента, который пишет код. Откройте страницу ключей api.apiyi.com/token и создайте ключи. При заполнении обратите внимание на несколько моментов:
- Название можно выбрать любое. Например, назовите ключи
chatиcode, чтобы сразу различать их. - Группа: для чата выберите Default, а для агента, который пишет код, — ClaudeCode.
- Лимит: для первого ключа установите небольшой лимит, а после успешной проверки увеличьте его. Не выбирайте безлимитный вариант и не задавайте срок действия «навсегда».
- Способ тарификации: выберите оплату по фактическому расходу, а не за каждый вызов.
- Ограничение по моделям: можно разрешить только
claude-opus-5-5, чтобы другие модели не могли расходовать ваш баланс.
После создания скопируйте ключи и сохраните их. Если в списке появились два активных ключа, шаг выполнен. Если вам нужен только чат и в приложении чата выбран тип Anthropic, достаточно создать один ключ в группе ClaudeCode — его тоже можно использовать для общения.
Сразу после создания скопируйте ключи и сохраните их в своём менеджере паролей. Не отправляйте их в групповые чаты и не вставляйте в файлы, которые будут загружены в открытый репозиторий. Если ключ случайно попал не туда, вернитесь на страницу ключей и отключите его, а затем создайте новый. Поскольку лимит изначально установлен небольшим, возможный ущерб будет ограничен.
Как выбрать подходящую группу? В таблице ниже всё объяснено.
| Группа | Коэффициент | Как использовать |
|---|---|---|
| Default | 1 | Для чатов. Если хотите платить столько же, сколько на официальном сайте, выберите эту группу |
| ClaudeCode | 0.95 | Для кодинг-агентов выбирайте эту группу. Она подходит и для чат-приложений |
| Claude_Enterprise | 1.2 | Дороже — не рекомендуем |
| Claude_Reverse | 0.5 | Источник не проверен. Если вам нужно стабильное подключение, не выбирайте эту группу |
В столбце «Группа» на странице цен также указан SVIP. Его коэффициент, как и у Default, равен 1, но в описанном в статье процессе подключения он не понадобится.
Как подключить чат-приложение: пример с Cherry Studio
Cherry Studio здесь — только пример. Если вы пользуетесь другим чат-приложением, главное, чтобы оно поддерживало подключение сервиса типа Anthropic. Тогда заполните те же три поля: базовый URL, токен sk- и название модели claude-opus-5-5. Ниже приведена инструкция для Cherry Studio — в других приложениях найдите аналогичные поля.
Шаг 4. Отправьте первое сообщение из чат-приложения (около 4 минут)
Наша цель — получить ответ от claude-opus-5-5 в окне чата. В качестве примера возьмём Cherry Studio. Сначала скачайте установщик, установите программу и откройте её. Нажмите на значок настроек в левом нижнем углу, перейдите в раздел служб моделей и нажмите «Добавить». Затем заполните поля:
- Тип провайдера: выберите Anthropic.
- Название: например,
APIYI-CLAUDE, чтобы потом легко найти подключение. - Адрес API:
https://api.apiyi.com. Укажите базовый URL — не добавляйте в конце/v1или лишний слеш. - Ключ: вставьте токен
sk-, который получили ранее. Для чатов используйте токен из группы Default. - Модель: выберите ручное добавление модели и укажите ID
claude-opus-5-5— между частями названия стоят дефисы.
Сохраните настройки и вернитесь в окно чата. В верхней части выберите только что добавленную модель и отправьте короткое сообщение, например: «Представься одним предложением». Через несколько секунд появится ответ. Эта модель не позволяет отключить режим размышлений, поэтому первое сообщение обрабатывается медленнее, чем в обычных чат-моделях. Это нормально — не нажимайте «Отправить» повторно.
Проверить результат можно в двух местах. Во-первых, в окне чата должен появиться ответ. Во-вторых, откройте консоль APIYI и перейдите на страницу журналов для этого токена: в самой свежей записи должно быть указано название модели claude-opus-5-5. Если оба условия выполнены, настройка прошла успешно. Если в журнале указано другое название модели, значит, в окне чата выбрана не та модель — вернитесь и выберите нужную.
Чаще всего при настройке ошибаются с типом провайдера и выбирают OpenAI. Разница между типами — в формате адреса: для Anthropic указывайте базовый URL без /v1, а для типа OpenAI-совместимого API добавляйте /v1 к базовому URL. В этой статье мы везде используем тип Anthropic, чтобы адрес совпадал с настройкой Claude Code и не приходилось запоминать различия. Если после сохранения при отправке сообщения появляется ошибка 404, сначала проверьте, нет ли лишнего слеша в конце адреса.
Какие из этих трёх полей чаще всего заполняют неправильно, показано на схеме ниже. В других чат-приложениях нужно заполнить те же поля:
Как подключить агент для написания кода через Magpie
Подключить можно любой агент для программирования: Claude Code, Codex, Pi, Hermes и другие инструменты, которыми вы уже пользуетесь, — все они могут работать с одним и тем же токеном Claude от APIYI. Если нужно подключить несколько агентов, используйте Magpie с открытым исходным кодом: все инструменты можно настроить в одном окне, не меняя параметры каждого по отдельности. Подробная пошаговая инструкция с иллюстрациями уже есть в отдельной статье, поэтому здесь повторяться не будем. Как подключить все агенты к одному ключу: инструкция по Magpie.
Шаг 5. Подключите агента через Magpie (около 3 минут)
Наша цель — настроить агента, которым вы пользуетесь, для вызова claude-opus-5-5 через APIYI. У Magpie графический интерфейс: после установки и запуска сначала настройте поставщика, а затем включите нужного агента.
- Установите и запустите Magpie, откройте раздел «Поставщики», нажмите «Добавить» и выберите APIYI.
- Протокол: выберите Anthropic.
- Адрес: укажите
https://api.apiyi.com— корневой домен, без/v1. - Ключ: вставьте токен из группы ClaudeCode, а не из группы Default.
- Модель: выберите
claude-opus-5-5.
После сохранения откройте вкладку «Агенты», включите нужный инструмент и выберите эту модель. Затем перезапустите инструмент, чтобы он не использовал параметры из старой сессии. Для проверки попросите его сделать что-нибудь простое, например: «Прочитай текущую папку и перечисли файлы». Через несколько секунд он должен ответить.
Проверить настройку нужно в двух местах. Во-первых, убедитесь, что инструмент ответил. Во-вторых, откройте в панели управления APIYI журнал токенов и проверьте, что в последней записи указана модель claude-opus-5-5, а использован токен из группы ClaudeCode. Если всё совпало, настройка завершена. Если инструмент сообщает об ошибке вызова, первым делом проверьте, что токен взят именно из группы ClaudeCode: это самая частая причина проблемы.
Если позже захотите временно переключиться на другого поставщика, сделайте это в Magpie. Удалять APIYI не нужно — при необходимости просто переключитесь обратно. Если вы подключаете только Claude Code и уже пользуетесь CC Switch, можно указать тот же адрес и токен. Но для работы с несколькими агентами Magpie удобнее.
Только Claude Code, без Magpie
Если вы пользуетесь только Claude Code и не хотите устанавливать Magpie, настройте переменные окружения вручную: укажите токен из группы ClaudeCode в ANTHROPIC_AUTH_TOKEN, а корневой домен — в ANTHROPIC_BASE_URL. Эти параметры также можно добавить в раздел env файла .claude/settings.json в домашней директории пользователя. В этом случае вы тоже будете использовать токен APIYI — регистрировать отдельный аккаунт на сайте Claude не нужно. Если вы не знакомы с настройкой конфигурационных файлов, проще воспользоваться Magpie из предыдущего раздела.
Адреса, группы и типичные ошибки
В этом разделе собраны самые полезные таблицы для работы после подключения. Для начала разберёмся, какой из трёх узлов выбрать. Функции у них одинаковые — различаются только маршруты и лимиты времени ожидания.
| Узел | Адрес | Когда использовать |
|---|---|---|
| Узел по умолчанию | api.apiyi.com |
Начните с него — он подходит и для пользователей из Китая, и для пользователей из других стран |
| Резервный узел в Китае | b.apiyi.com |
Функции те же; переключайтесь на него, если основной узел работает с перебоями |
| Узел с cf | Адрес содержит cf (точный адрес смотрите на сайте) |
Лимит времени ожидания — 100 секунд, отключить режим размышления нельзя. Не используйте его для длинных ответов |
Если появилась ошибка, найдите её описание в первом столбце таблицы:
| Симптом | Частая причина | Что делать |
|---|---|---|
| 404 | Anthropic-клиент добавляет лишний /v1, OpenAI-совместимый клиент не добавляет нужный /v1 или в конце адреса стоит лишний слеш |
Для Anthropic-клиента укажите https://api.apiyi.com. /v1 добавляйте только для OpenAI-совместимых клиентов |
| Сообщение о том, что модель не найдена | Указано claude-opus-5.5, claude-opus-5 или устаревший ID модели четвёртого поколения |
Замените на claude-opus-5-5 |
| Не удаётся вызвать Agent | Токен не относится к группе ClaudeCode | Создайте на странице токенов токен для группы ClaudeCode и замените им текущий |
| Ошибка 400 при настройке режима размышления | В запросе передан параметр disabled |
Удалите этот параметр. Чтобы снизить задержку, установите для effort значение low |
| Превышено время ожидания | Закончился баланс или токен отключён | Сначала проверьте баланс и активность токена, затем переключитесь на резервный узел в Китае. Не переходите на узел с лимитом в 100 секунд |
| Слишком высокий счёт | Выбрана корпоративная группа с коэффициентом 1,2 | Переключитесь на Default или ClaudeCode |
| Счёт вдвое ниже | Выбрана группа Reverse | Низкая цена не означает, что это такой же стабильный канал. Для стабильного подключения не выбирайте эту группу |
На схеме ниже собраны три самые частые ошибки:
Когда не стоит использовать этот вариант
В следующих случаях лучше выбрать другой вариант:
- Если официальный сайт доступен вам и его месячная подписка выгоднее, пользуйтесь им напрямую.
- Если вам нужна веб-версия claude.ai: токен отсюда позволяет вызывать API, но не даёт доступ к аккаунту на официальном сайте.
- Если вы хотите платить столько же, сколько на официальном сайте, используйте группу Default. Не выбирайте Reverse ради низкой цены и не переходите на корпоративную группу с коэффициентом 1,2.
- Если вы запускаете длительные задачи, не используйте узел с
cfи лимитом в 100 секунд — соединение может прерваться до завершения ответа.
Частые вопросы
Вопрос: можно ли установить высокий уровень effort в графическом интерфейсе?
Ответ: пока это неизвестно. Наличие переключателя effort и его название зависят от версии программы — ориентируйтесь на интерфейс установленной версии. В этой статье мы не будем придумывать названия кнопок. Если для программирования нужен эффект уровня high, но изменить настройку нельзя, уточните задачу в промпте: укажите, какой файл нужно изменить, какой результат вы ожидаете и что менять не нужно.
Вопрос: Какой лимит задать для токена? Ответ: Для начала установите совсем небольшой лимит. Убедитесь, что в журнале отображается нужное имя модели, а потом увеличьте лимит. Токены оплачиваются по факту использования, поэтому не выбирайте безлимитный вариант ради удобства и не устанавливайте срок действия «навсегда».
Вопрос: Что делать, если имя модели в журнале не совпадает с выбранным? Ответ: Скорее всего, в приложении выбрана не та модель или у того же поставщика остался другой ID модели. Вернитесь к списку моделей, оставьте только claude-opus-5-5 и отправьте короткое сообщение для повторной проверки.
Вопрос: Нужно установить и приложение для чата, и Magpie? Ответ: Нет. Если вам нужен только чат, установите одно приложение для чата; если только написание кода — Magpie. Если нужны оба варианта, установите оба приложения и используйте для токенов группы Default и ClaudeCode соответственно.
В завершение подведём итог: сначала убедитесь, что официальный сайт недоступен, затем зарегистрируйтесь, пополните баланс и создайте два токена. После этого отправьте первое сообщение в приложении для чата, подключите в Magpie агента для написания кода и, если возникнут проблемы, воспользуйтесь таблицей выше. На каждом этапе проверяйте результат по имени модели claude-opus-5-5 в журнале — одного ответа в окне чата недостаточно.
