Плагин Obsidian Copilot и QCode: наглядная инструкция для Windows 11, шаг за шагом

17 шагов и 17 скриншотов: ставим Obsidian 1.15.1 и Copilot 4.1.0 на Windows 11, через BYOK вписываем адрес и ключ QCode и общаемся в Quick Chat с gpt-6.2-sol и claude-opus-5-5.

Обновлено 2026-11-23

Нужен API-ключ? Зарегистрироваться →Эндпоинты и Base URL →

Содержание

Выполните 17 шагов ниже — и на Windows 11 у вас будет Obsidian с плагином Copilot, который через QCode работает с gpt-6.2-sol и claude-opus-5-5: откройте справа Quick Chat прямо в заметке и через пару секунд получите объяснение, краткое изложение или переписанный текст.

Короткий ответ: в настройках Obsidian откройте «第三方插件 → Copilot → BYOK» (сторонние плагины → Copilot → BYOK), нажмите «+ Add a provider», выберите «Add a custom provider», укажите Base URL https://api.qcode.cc/openai/v1, вставьте ключ cr_, включите Enable CORS, дождитесь у Test надписи Verified и отметьте gpt-6.2-sol, затем сохраните.

Пункт Значение
Адрес подключения (GPT, китайские модели) https://api.qcode.cc/openai/v1
Адрес подключения (Claude) https://api.qcode.cc/api
Модель по умолчанию (GPT) gpt-6.2-sol
Модель по умолчанию (Claude) claude-opus-5-5
Формат ключа cr_xxxxxxxx

Проверено 2026-11-22 · Obsidian 1.15.1 + Copilot 4.1.0 · Windows 11

  • Поддерживаемые системы: Windows 10 / 11 (64-бит)
  • Версия программы: Obsidian 1.15.1 + Copilot 4.1.0
  • Скриншоты обновлены: 2026-11
  • Сколько времени займёт: 20 минут
  • Что понадобится: API-ключ QCode, начинающийся с cr_; хранилище Obsidian (vault), в которое можно ставить сторонние плагины
  • Компьютер с Windows 10 / 11 (64-бит), в браузере открывается obsidian.md
  • Obsidian 1.15.1 уже установлен; если ещё нет — не страшно, раздел «Скачивание и установка» ниже поможет его поставить
  • Есть хранилище Obsidian (vault): подойдёт и только что созданное пустое
  • В панели управления уже скопирован API-ключ QCode, начинающийся с cr_. Ещё нет учётной записи? Сначала зарегистрируйте QCode, на странице тарифов выберите тариф, а затем создайте ключ в панели управления.
  • Компьютер открывает api.qcode.cc и probe.qcode.cc

Скачивание и установка

У Obsidian для Windows установщик один — файл .exe, его достаточно скачать с официального сайта. Плагина Copilot в этом установщике нет: его ставят уже после установки Obsidian, из каталога плагинов внутри самого Obsidian.

Сначала выберите свой регион:

  • Откройте obsidian.md/download и скачайте версию для Windows либо сразу возьмите свежий Obsidian-1.15.1.exe из GitHub Releases.
  • Скачивайте только .exe; .dmg в списке — это macOS, .apk — Android, установить их смысла нет.
  • Если хочется проще, выполните в «Терминале Windows» команду winget install Obsidian.Obsidian.
  • Откройте obsidian.md/download и нажмите «Download for Windows» — вы получите Obsidian-1.15.1.exe.
  • На самом деле установщик Obsidian размещён на GitHub, поэтому при медленном или обрывающемся соединении поставьте ту же версию из командной строки: winget install Obsidian.Obsidian.
  • Установщик ставит программу для текущего пользователя и обычно не вызывает «Контроль учётных записей пользователей»; после установки Obsidian найдётся в меню «Пуск».
  • Официальный сайт и GitHub обычно открываются напрямую: проще всего зайти на obsidian.md/download и нажать кнопку для Windows.
  • Если версия на странице не совпадает с нужной, найдите на GitHub Releases выпуск v1.15.1 и скачайте .exe с тем же именем.
  • Если при установке появится «Windows защитила ваш компьютер», нажмите «Подробнее» → «Выполнить в любом случае».
  • В первую очередь официальный сайт obsidian.md/download; если он не открывается, используйте winget install Obsidian.Obsidian.
  • Можно скачать и с GitHub Releases: имя файла всегда по шаблону Obsidian-<версия>.exe.
  • После установки сначала откройте программу один раз и убедитесь, что дошли до экрана «新建仓库» (новое хранилище), и только потом продолжайте.

Пошагово по скриншотам: Windows

Ниже 17 шагов, на каждом — только одно действие. Скриншоты сняты на Windows 11 с китайским интерфейсом, оранжевые номера на рисунках соответствуют номерам ①②③ в тексте.

Откройте официальную страницу загрузки Obsidian

Откройте в браузере obsidian.md/download. Страница сама определит вашу систему: фиолетовая кнопка «Download for Windows» в позиции ① — это и есть установщик для Windows.

Официальная страница загрузки Obsidian: страница сама определила систему Windows, чуть ниже середины фиолетовая кнопка Download for Windows

Если всё сделано правильно, вы увидите: браузер начал скачивать файл с именем Obsidian-1.15.1.exe, а не .dmg или .apk.

Застряли? Кнопка не реагирует или загрузка стоит на 0%

Установщик размещён на GitHub, и при плохой сети он легко застревает. Попробуйте вариант для своего региона из раздела «Скачивание и установка» или выполните в «Терминале Windows» команду winget install Obsidian.Obsidian — версия будет та же.

Первый запуск: нажмите «创建» (создать) и создайте хранилище

Дважды щёлкните скачанный установщик и установите по подсказкам (в установщике одна кнопка, после установки программа откроется сама), затем запустите Obsidian из меню «Пуск». При первом запуске интерфейс сразу будет на упрощённом китайском: на главном экране три строки вариантов, нажмите фиолетовую кнопку «创建» (создать) справа от ① «新建仓库» (новое хранилище).

Главный экран первого запуска Obsidian: показана версия 1.15.1, три строки вариантов — новое хранилище, открыть локальное хранилище и синхронизировать удалённое хранилище, справа от нового хранилища фиолетовая кнопка создать

Если всё сделано правильно, вы увидите: открылась форма «创建本地仓库» (создать локальное хранилище), слева вверху «返回» (назад), справа вверху «版本 1.15.1» (версия).

Укажите название хранилища и папку для него

В поле «仓库名称» (название хранилища) впишите запоминающееся имя, например QCodeDemo (①); нажмите ② «浏览» (обзор) и выберите папку для хранилища (имя пользователя на скриншоте замазано); в конце нажмите ③ «创建» (создать).

Форма создания локального хранилища: в поле названия введено QCodeDemo, ниже расположение хранилища и кнопка обзора, в самом низу фиолетовая кнопка создать, имя пользователя в пути замазано

Если всё сделано правильно, вы увидите: открылось главное окно Obsidian, в заголовке окна QCodeDemo - Obsidian, в центре заметка «欢迎» (добро пожаловать).

Застряли? Пишет, что в этой папке уже есть хранилище

Значит в выбранной папке уже лежит хранилище Obsidian. Возьмите пустую папку или создайте подпапку в поле «仓库位置» (расположение хранилища) и снова нажмите «创建» (создать).

Откройте в настройках «第三方插件» (сторонние плагины)

В окне Obsidian нажмите Ctrl + ,, чтобы открыть настройки. В списке слева выберите ① «第三方插件» (сторонние плагины); справа в этот момент ещё действует ограниченный режим, поэтому нажмите ② «退出受限模式» (выйти из ограниченного режима).

Окно настроек Obsidian: в списке слева выбран пункт сторонние плагины, справа пояснение о безопасности плагинов и фиолетовая кнопка выхода из ограниченного режима

Если всё сделано правильно, вы увидите: предупреждение об ограниченном режиме исчезло, на странице появились кнопка «浏览» (обзор) и список установленных плагинов.

Застряли? Слева нет пункта «第三方插件»

Значит версия Obsidian слишком старая. Вернитесь в «Скачивание и установка» и поставьте 1.15.1 либо выполните в «Терминале Windows» команду winget upgrade Obsidian.Obsidian, после установки откройте настройки заново.

Найдите Copilot и установите его

Нажмите «浏览» (обзор), чтобы попасть в каталог плагинов сообщества. В поле поиска введите Copilot (①), в результатах выберите ② Copilot автора Logan Yang — справа на странице плагина указана версия 4.1.0 — и нажмите ③ «安装» (установить).

Каталог плагинов сообщества: в поле поиска введено Copilot, первый результат — Copilot 4.1.0 от Logan Yang, справа на странице плагина внизу кнопка установки

Если всё сделано правильно, вы увидите: кнопка начала крутиться, а через несколько десятков секунд на её месте появится «启用» (включить).

Нажмите «启用» (включить) и запустите плагин

После установки кнопка сама меняется на «启用» (включить) — нажмите ① «启用». Если появится «信任作者并启用插件» (доверять автору и включить плагин), нажмите пункт про доверие.

Страница плагина Copilot: установлена версия 4.1.0, слева внизу фиолетовая кнопка включить

Если всё сделано правильно, вы увидите: вернувшись в настройках в список «第三方插件» (сторонние плагины), вы найдёте Copilot в списке установленных со статусом «включён».

Застряли? Появилось требование доверять автору

Это обычное подтверждение Obsidian для плагинов сообщества. Посмотрите имя автора (Logan Yang) и адрес репозитория и нажмите «信任作者并启用» (доверять автору и включить) — больше спрашивать не будут.

Откройте страницу BYOK в Copilot

Нажмите Ctrl + ,, чтобы вернуться в настройки; в левом списке в группе «第三方插件» (сторонние плагины) выберите ① «Copilot», перейдите на вкладку ② «BYOK» и нажмите ③ «+ Add a provider».

Страница Copilot в настройках Obsidian: сверху вкладка переключена на BYOK, заголовок Bring your own key, справа вверху фиолетовая кнопка + Add a provider, ниже сообщение, что провайдеров пока нет

Если всё сделано правильно, вы увидите: открылось окно «Add a provider» со списком названий провайдеров.

Выберите «Add a custom provider»

В окне провайдеры перечислены по категориям. GPT и китайские модели в QCode работают по протоколу, совместимому с OpenAI, поэтому нажмите ① «+ Add a custom provider» в самом низу; если хотите заодно подключить Claude, нажмите ② «Add Anthropic provider».

Окно Add a provider: сверху список рекомендуемых провайдеров, в самом низу кнопка + Add a custom provider, выше неё пункт Add Anthropic provider

Если всё сделано правильно, вы увидите: открылась форма «Configure Custom OpenAI-compatible», сверху вниз — Display name, API key, Base URL, Enable CORS, Models.

Впишите адрес QCode и ключ

В Display name впишите QCode; в API key вставьте всю строку, начинающуюся с cr_; в Base URL укажите ① https://api.qcode.cc/openai/v1 — ровно до /v1, без косой черты на конце; затем включите переключатель ② «Enable CORS» и нажмите ③ «Test».

Форма Configure Custom OpenAI-compatible: Display name — QCode, API key замазан, Base URL — https://api.qcode.cc/openai/v1, переключатель Enable CORS включён, справа кнопки Test и Save

Если всё сделано правильно, вы увидите: справа от «Test» появится зелёная надпись «Verified», а ниже в области Models начнут появляться названия моделей.

Нужен API-ключ?

Если учётной записи QCode ещё нет, сначала зарегистрируйте QCode. Если хотите платить по факту использования, сначала купите разовый пакет, а затем создайте ключ в панели управления. Скопируйте всю строку, начинающуюся с cr_, и вставьте её в API key. Оплатить можно банковской картой (Visa / Mastercard); подробнее — в разделе Способы оплаты.

Застряли? Test показывает Verified, но при отправке сообщения возникает Failed to fetch

Это не включён «Enable CORS». Панель чата в Obsidian работает через браузерный интерфейс: с выключенным переключателем проверка проходит, а сообщения не отправляются. Вернитесь к этому шагу, включите переключатель ② и нажмите «Test» ещё раз.

Отметьте модель и сохраните

Зелёная надпись «Verified» рядом с ключом в позиции ① означает, что адрес и ключ верны; в списке моделей отметьте ② gpt-6.2-sol и нажмите ③ «Save».

Форма после успешного Test: рядом с API key зелёный значок Verified, под Model ID автоматически найденный список моделей, gpt-6.2-sol отмечен, справа внизу кнопка Save

Если всё сделано правильно, вы увидите: окно закрылось, а в списке BYOK появилась строка QCode с зелёной надписью «Verified» справа.

Добавьте ещё одну точку подключения для Claude (необязательно)

В позиции ① — зелёная надпись «Verified», которая появляется после успешной проверки Test. До проверки нажмите «+ Add a provider» → «Add Anthropic provider», в Display name впишите QCode Claude, вставьте тот же ключ cr_, в Base URL укажите ② https://api.qcode.cc/api, включите «Enable CORS», нажмите «Test» и дождитесь зелёной надписи, затем добавьте в Model ID claude-opus-5-5 и нажмите ③ «Save».

Форма Configure Anthropic: Display name — QCode Claude, Base URL — https://api.qcode.cc/api, Enable CORS включён, значок Verified рядом с ключом, в списке моделей отмечена Claude Opus 5.5

Если всё сделано правильно, вы увидите: после закрытия окна список BYOK — уже не пустой, в нём две строки провайдеров.

Застряли? Нужен только GPT — можно пропустить этот шаг?

Можно. Если достаточно gpt-6.2-sol, пропустите шаг целиком и выполняйте дальше как есть, только всё, что касается Claude, заменяйте на GPT.

Убедитесь, что обе точки подключения прошли проверку

Вернитесь в список «BYOK» и сверьте две строки: ① QCode (совместимый с OpenAI) и ② QCode Claude (Anthropic) — справа у обеих должна быть зелёная надпись «Verified».

Список BYOK: две строки провайдеров QCode и QCode Claude, справа у каждой зелёный значок Verified, справа вверху кнопка + Add a provider

Если всё сделано правильно, вы увидите: обе строки с зелёной надписью «Verified», без красных предупреждений и без «Invalid key».

Включите модели в Quick Chat

Переключитесь на вкладку ① «Quick Chat» (она в том же ряду Basic → Agents). Убедитесь, что ② Default model — это gpt-6.2-sol; в позиции ③ список переключателей моделей, и gpt-6.2-sol у QCode, и Claude Opus 5.5 у QCode Claude должны быть включены.

Вкладка Quick Chat в настройках Copilot: сверху выбрана вкладка Quick Chat, в выпадающем списке Default model — gpt-6.2-sol, ниже отдельно перечислены переключатели моделей групп QCode и QCode Claude

Если всё сделано правильно, вы увидите: оба переключателя включены и подсвечены фиолетовым, а в строке Default model указано gpt-6.2-sol.

Застряли? В списке моделей только GPT, Claude нет

Сначала убедитесь, что на предыдущем шаге у QCode Claude зелёная надпись «Verified». Затем вернитесь на эту страницу и включите переключатель Claude Opus 5.5; если модели всё равно не видно, нажмите вверху настроек «重新加载插件» (перезагрузить плагин) и зайдите снова.

Откройте Quick Chat из панели команд

Закройте настройки и вернитесь в окно с заметкой, нажмите Ctrl + P, чтобы открыть панель команд, введите Quick Chat, выберите ① «Copilot: Open Copilot Quick Chat window» и нажмите Enter.

Панель команд Obsidian: после ввода Quick Chat показаны четыре подходящие команды, вторая из них — Copilot: Open Copilot Quick Chat window

Если всё сделано правильно, вы увидите: справа открылась панель Copilot, внизу поле ввода и название модели, а в центре подсказка, что контекст можно добавить через @.

Застряли? Нажали «Open Copilot Chat», а он просит скачать что-то ещё

Это agent-режим Copilot V4: ему нужно отдельно установить среду выполнения, и с BYOK из этой инструкции он не связан. Выбирайте команду, в названии которой есть «Quick Chat window».

Попросите кратко пересказать текущую заметку

В поле справа введите «用三句话总结当前笔记» (перескажи текущую заметку в трёх предложениях) и нажмите Enter. Панель сама подхватит открытую заметку «欢迎» (добро пожаловать), и через несколько секунд в позиции ① появится краткое изложение, а в позиции ② — название модели gpt-6.2-sol, которая отвечала.

Панель Quick Chat справа: отправленный вопрос и полученное краткое изложение из трёх предложений, внизу в выборе модели — gpt-6.2-sol, над полем ввода показана приложенная заметка «добро пожаловать»

Если всё сделано правильно, вы увидите: ответ связный и на китайском, по содержанию — действительно про заметку «欢迎», а внизу указана модель gpt-6.2-sol.

Переключитесь на Claude и спросите ещё раз

В позиции ① — ответ Claude после смены модели. Сначала в выпадающем списке моделей ② замените gpt-6.2-sol на «Claude Opus 5.5», затем введите «你好,用一句话介绍你自己» (привет, представься одним предложением) и нажмите Enter — через несколько секунд ответ появится в позиции ①.

Та же панель Quick Chat: вопрос и ответ Claude, внизу в выборе модели уже не gpt-6.2-sol, а Claude Opus 5.5

Если всё сделано правильно, вы увидите: ответ на китайском, внизу название модели сменилось на «Claude Opus 5.5», а в середине появилась строка «Thought for a while».

Сверьте запрос на probe.qcode.cc

Откройте probe.qcode.cc, вставьте тот же ключ cr_ и нажмите «查询» (запрос): самая верхняя строка списка — только что состоявшийся диалог, время в строке, обведённой в ①, совпадает, статус 200.

Список запросов на probe.qcode.cc: время и статус последних строк, у самой свежей строки статус 200, видны время соединения, время до первого токена и размер ответа

Если всё сделано правильно, вы увидите: в столбце статуса 200, время совпадает с моментом отправки сообщения — значит запрос действительно шёл через QCode.

Проверьте, что всё работает

Если совпали все четыре пункта, значит Copilot в Obsidian полностью подключён к QCode:

  • В настройках → «第三方插件» (сторонние плагины) → «Copilot» → «BYOK» и QCode, и QCode Claude показывают зелёную надпись «Verified»;
  • В «Basic» → Agents → «Quick Chat» модель gpt-6.2-sol стоит как Default model, а переключатель Claude Opus 5.5 тоже включён;
  • В панели команд выполните «Copilot: Open Copilot Quick Chat window» и отправьте «用三句话总结当前笔记» (перескажи текущую заметку в трёх предложениях) — ответ на китайском придёт за несколько секунд;
  • На probe.qcode.cc введите тот же ключ и найдите этот запрос со статусом 200.

Готово

Теперь в Obsidian можно выделить непонятный кусок заметки и через Quick Chat справа попросить gpt-6.2-sol или claude-opus-5-5 объяснить, пересказать или переписать его. Дальше можно:

Частые ошибки

Текст ошибки Причина Что делать
Connection error. more message: Failed to fetch Test проходит, но панель чата не отправляет сообщения: не включён «Enable CORS» Откройте в BYOK строку QCode, включите переключатель «Enable CORS», нажмите «Test» ещё раз, затем откройте Quick Chat заново
{"error":{"message":"Invalid URL (POST /v1/chat/completions/chat/completions)","type":"invalid_request_error"}} В Base URL вписали ещё и /chat/completions, а клиент добавил его сам Укажите в Base URL только https://api.qcode.cc/openai/v1, без косой черты на конце и без /chat/completions, затем впишите заново и нажмите «Test»
401 invalid_api_key Ключ неполный, с пробелами по краям или это ключ другого провайдера Вернитесь в панель управления, скопируйте заново всю строку, начинающуюся с cr_, вставьте её в поле API key без пробелов по краям и нажмите «Test»
Missing API key Поле API key ещё пустое или ключ вставили, но переключили вкладку, не сохранив Вставьте ключ в поле API key, убедитесь, что в нём появилось содержимое, начинающееся с cr_, и по порядку нажмите «Test» и «Save»

Часто задаваемые вопросы

Что делать, когда ключ истекает?

Два случая: ключ личного тарифа после окончания срока продлить нельзя — нужно заново оформить тариф и получить новый ключ; ключ разового пакета после окончания срока снова заработает, если купить ещё один пакет, — это тот же самый ключ.

После смены ключа вернитесь в BYOK, откройте QCode (и QCode Claude), вставьте ключ заново, нажмите «Test», а после успешной проверки — «Save».

Не вижу в Quick Chat только что добавленную модель?

BYOK только подключает провайдера, а модели включаются отдельно: откройте «Basic» → Agents → «Quick Chat», включите переключатели нужных моделей и выберите модель в Default model. Если страница настроек не обновилась, нажмите вверху «重新加载插件» (перезагрузить плагин) и вернитесь.

Обязательно ли включать «Enable CORS»?

Да, обязательно. Без него Test тоже показывает «Verified», но Quick Chat не сможет отправить сообщение. Этот переключатель нужен и на точке подключения GPT, и на точке Claude.

Можно ли один и тот же ключ указать в двух точках подключения?

Можно. Один ключ cr_ работает и на Anthropic-эндпоинте (https://api.qcode.cc/api), и на совместимом с OpenAI (https://api.qcode.cc/openai/v1), а расход записывается на одну и ту же учётную запись.

Нужна ли лицензия Copilot или вход в учётную запись?

Нет. Здесь используется BYOK: вы подключаетесь к QCode своим ключом, не входите в учётные записи производителей моделей и не привязываете платный аккаунт Copilot.

Другие точки подключения

Три домена подключения дают одинаковые возможности и различаются только сетевым маршрутом, а ключ подходит один и тот же. Если из материкового Китая api.qcode.cc отвечает медленно, замените адрес на азиатский узел и нажмите «Test» ещё раз.

Узел Anthropic (Claude) Совместимый с OpenAI (GPT / китайские модели)
Глобальный https://api.qcode.cc/api https://api.qcode.cc/openai/v1
Азия (основной для материкового Китая) https://asia.qcode.cc/api https://asia.qcode.cc/openai/v1
Северная Америка / Европа https://us.qcode.cc/api https://us.qcode.cc/openai/v1

Доступные модели

Модель Model ID в Copilot Описание
Claude Opus 5.5 claude-opus-5-5 Рекомендуется по умолчанию на Anthropic-точке
Claude Haiku 5.5 claude-haiku-5-5 Лёгкий вариант, отвечает быстрее
GPT 6.2 Sol gpt-6.2-sol Рекомендуется по умолчанию на совместимой с OpenAI точке
GPT 6.2 Astra gpt-6.2-astra Более мощный вариант
GLM 5.3 glm-5.3 Основная китайская модель, идёт через совместимую с OpenAI точку

Модели семейства Claude указываются только в Anthropic-точке QCode Claude, а GPT и китайские модели — в совместимой с OpenAI точке QCode. Перепутаете точки — Test не пройдёт. Полный список моделей — в разделе Китайские модели.

Кратко о подключении

Пункт Описание
Плагин Copilot for Obsidian 4.1.0 (автор Logan Yang, установка из каталога плагинов сообщества)
Протокол и Base URL Anthropic: https://api.qcode.cc/api · совместимый с OpenAI: https://api.qcode.cc/openai/v1
Ключ Ключ cr_ одной учётной записи QCode, работает в обеих точках подключения
Обязательный переключатель «Enable CORS» (включать в обеих точках подключения)
Вход в чат «Copilot: Open Copilot Quick Chat window» в панели команд
Официальная документация Страница загрузки Obsidian · Репозиторий плагина Copilot

Чем отличается от Copilot Chat

В Copilot V4 два независимых пути:

  • Quick Chat (эта инструкция): вопросы по текущей заметке в правой панели, модели — от провайдера, подключённого в BYOK; достаточно вписать адрес и ключ.
  • Copilot Chat (agent-режим): вызывает среды выполнения вроде OpenCode, Claude Code, Codex, требует отдельной установки или входа в соответствующие учётные записи, настраивается заметно тяжелее.

Если нужно только, чтобы ИИ читал заметки, отвечал на вопросы и правил текст, хватит Quick Chat; когда нужно, чтобы ИИ сам менял несколько файлов и запускал команды, стоит разбираться с agent-режимом.

Связанная документация

Начните с QCode

Один API-ключ для Claude Code, Codex и других инструментов; тарификация по токенам, цены каждой модели — на qcode.cc/models

Для бизнеса →