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

Выполните 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): подойдёт и только что созданное пустое
- В [панели управления](https://qcode.cc/ru/dashboard) уже скопирован API-ключ QCode, начинающийся с `cr_`. Ещё нет учётной записи? Сначала [зарегистрируйте QCode](https://qcode.cc/ru/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-obsidian-copilot-before), на [странице тарифов](https://qcode.cc/ru/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-obsidian-copilot-before) выберите тариф, а затем создайте ключ в [панели управления](https://qcode.cc/ru/dashboard).
- Компьютер открывает `api.qcode.cc` и `probe.qcode.cc`


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

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

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

**Европа / Япония**

- Откройте [obsidian.md/download](https://obsidian.md/download) и скачайте версию для Windows либо сразу возьмите свежий `Obsidian-1.15.1.exe` из [GitHub Releases](https://github.com/obsidianmd/obsidian-releases/releases).
- Скачивайте только `.exe`; `.dmg` в списке — это macOS, `.apk` — Android, установить их смысла нет.
- Если хочется проще, выполните в «Терминале Windows» команду `winget install Obsidian.Obsidian`.


**Материковый Китай**

- Откройте [obsidian.md/download](https://obsidian.md/download) и нажмите «Download for Windows» — вы получите `Obsidian-1.15.1.exe`.
- На самом деле установщик Obsidian размещён на GitHub, поэтому при медленном или обрывающемся соединении поставьте ту же версию из командной строки: `winget install Obsidian.Obsidian`.
- Установщик ставит программу для текущего пользователя и обычно не вызывает «Контроль учётных записей пользователей»; после установки Obsidian найдётся в меню «Пуск».


**Северная Америка**

- Официальный сайт и GitHub обычно открываются напрямую: проще всего зайти на [obsidian.md/download](https://obsidian.md/download) и нажать кнопку для Windows.
- Если версия на странице не совпадает с нужной, найдите на [GitHub Releases](https://github.com/obsidianmd/obsidian-releases/releases) выпуск `v1.15.1` и скачайте `.exe` с тем же именем.
- Если при установке появится «Windows защитила ваш компьютер», нажмите «Подробнее» → «Выполнить в любом случае».


**Другие регионы**

- В первую очередь официальный сайт [obsidian.md/download](https://obsidian.md/download); если он не открывается, используйте `winget install Obsidian.Obsidian`.
- Можно скачать и с [GitHub Releases](https://github.com/obsidianmd/obsidian-releases/releases): имя файла всегда по шаблону `Obsidian-<версия>.exe`.
- После установки сначала откройте программу один раз и убедитесь, что дошли до экрана «新建仓库» (новое хранилище), и только потом продолжайте.


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

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



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

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

![Официальная страница загрузки Obsidian: страница сама определила систему Windows, чуть ниже середины фиолетовая кнопка Download for Windows](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/01-obsidian-download.webp)


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


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

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




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

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

![Главный экран первого запуска Obsidian: показана версия 1.15.1, три строки вариантов — новое хранилище, открыть локальное хранилище и синхронизировать удалённое хранилище, справа от нового хранилища фиолетовая кнопка создать](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/02-obsidian-welcome.webp)


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




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

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

![Форма создания локального хранилища: в поле названия введено QCodeDemo, ниже расположение хранилища и кнопка обзора, в самом низу фиолетовая кнопка создать, имя пользователя в пути замазано](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/03-create-vault.webp)


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


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

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




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

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

![Окно настроек Obsidian: в списке слева выбран пункт сторонние плагины, справа пояснение о безопасности плагинов и фиолетовая кнопка выхода из ограниченного режима](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/04-community-plugins-unlock.webp)


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


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

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




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

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

![Каталог плагинов сообщества: в поле поиска введено Copilot, первый результат — Copilot 4.1.0 от Logan Yang, справа на странице плагина внизу кнопка установки](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/05-browse-copilot.webp)


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




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

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

![Страница плагина Copilot: установлена версия 4.1.0, слева внизу фиолетовая кнопка включить](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/06-enable-copilot.webp)


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


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

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




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

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

![Страница Copilot в настройках Obsidian: сверху вкладка переключена на BYOK, заголовок Bring your own key, справа вверху фиолетовая кнопка + Add a provider, ниже сообщение, что провайдеров пока нет](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/07-copilot-byok-entry.webp)


Если всё сделано правильно, вы увидите: открылось окно «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](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/08-byok-add-provider.webp)


Если всё сделано правильно, вы увидите: открылась форма «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](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/09-byok-qcode-openai-fill.webp)


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


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

Если учётной записи QCode ещё нет, сначала [зарегистрируйте QCode](https://qcode.cc/ru/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-obsidian-copilot-key). Если хотите платить по факту использования, сначала купите [разовый пакет](https://qcode.cc/ru/pay-as-you-go?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-obsidian-copilot-key), а затем создайте ключ в [панели управления](https://qcode.cc/ru/dashboard). Скопируйте всю строку, начинающуюся с `cr_`, и вставьте её в API key. Оплатить можно банковской картой (Visa / Mastercard); подробнее — в разделе [Способы оплаты](/docs/reference/payment-methods).


**Застряли? 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](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/10-byok-qcode-openai-verified.webp)


Если всё сделано правильно, вы увидите: окно закрылось, а в списке 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](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/11-byok-qcode-anthropic.webp)


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


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

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




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

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

![Список BYOK: две строки провайдеров QCode и QCode Claude, справа у каждой зелёный значок Verified, справа вверху кнопка + Add a provider](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/12-byok-saved-list.webp)


Если всё сделано правильно, вы увидите: обе строки с зелёной надписью «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](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/13-quick-chat-models.webp)


Если всё сделано правильно, вы увидите: оба переключателя включены и подсвечены фиолетовым, а в строке 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](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/14-command-palette-quick-chat.webp)


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


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

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




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

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

![Панель Quick Chat справа: отправленный вопрос и полученное краткое изложение из трёх предложений, внизу в выборе модели — gpt-6.2-sol, над полем ввода показана приложенная заметка «добро пожаловать»](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/15-quick-chat-gpt-reply.webp)


Если всё сделано правильно, вы увидите: ответ связный и на китайском, по содержанию — действительно про заметку «欢迎», а внизу указана модель `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](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/16-quick-chat-claude-reply.webp)


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




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

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

![Список запросов на probe.qcode.cc: время и статус последних строк, у самой свежей строки статус 200, видны время соединения, время до первого токена и размер ответа](https://docs.qcode.cc/static/images/tut/obsidian-copilot/202611/zh/17-probe-requests.webp)


Если всё сделано правильно, вы увидите: в столбце статуса `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](https://probe.qcode.cc/) введите тот же ключ и найдите этот запрос со статусом `200`.


### Готово

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

- [Точки подключения и формат API](/docs/getting-started/endpoints-and-api-paths)
- [Китайские модели](/docs/usage/cn-models)
- [Как считается оплата](/docs/reference/billing)
- Далее: сравните тарифы на [странице тарифов](https://qcode.cc/ru/pricing?utm_source=docs.qcode.cc&utm_medium=tut_done&utm_campaign=knowledge_base&src=docs-ide-obsidian-copilot-done)
- Вернитесь в [панель управления](https://qcode.cc/ru/dashboard), чтобы посмотреть расход и баланс


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

| Текст ошибки | Причина | Что делать |
|---|---|---|
| `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 не пройдёт. Полный список моделей — в разделе [Китайские модели](/docs/usage/cn-models).

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

| Пункт | Описание |
|---|---|
| Плагин | 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](https://obsidian.md/download) · [Репозиторий плагина Copilot](https://github.com/logancyang/obsidian-copilot) |

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

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

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

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

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

- [Точки подключения и формат API](/docs/getting-started/endpoints-and-api-paths) — адреса и семейства моделей для каждого протокола
- [Китайские модели](/docs/usage/cn-models) — ID китайских моделей, доступных на совместимой с OpenAI точке
- [Как считается оплата](/docs/reference/billing) — как рассчитывается расход
- [Устранение неполадок](/docs/reference/troubleshooting) — частые проблемы с подключением и аутентификацией