# Obsidian Copilot 插件接入 QCode：Windows 11 图文教程

照着下面 17 步做完，你会在 Windows 11 上给 Obsidian 装好 Copilot 插件，并让它通过 QCode 用上 `gpt-6.2-sol` 与 `claude-opus-5-5`：在笔记里点开右侧 Quick Chat，几秒就能拿到中文的解释、总结和改写。


**一句话答案**：在 Obsidian 设置的「第三方插件 → 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 分钟
- **需要准备**：一个 `cr_` 开头的 QCode API Key；一个能装第三方插件的 Obsidian 仓库



- 电脑是 Windows 10 / 11（64 位），能打开浏览器访问 `obsidian.md`
- 已经装好 Obsidian 1.15.1；还没装也没关系，下面「下载与安装」会带着装
- 有一个 Obsidian 仓库（vault）：刚新建的空仓库也可以
- 已经在[控制台](https://qcode.cc/dashboard)复制好 `cr_` 开头的 QCode API Key。还没有账号？先[注册 QCode](https://qcode.cc/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/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-obsidian-copilot-before)选一个方案，再到[控制台](https://qcode.cc/dashboard)创建密钥。
- 电脑能访问 `api.qcode.cc` 和 `probe.qcode.cc`


## 下载与安装

Obsidian 的 Windows 安装包只有一个 `.exe` 文件，从官网下载即可；Copilot 插件不在这个安装包里，它要装完 Obsidian 之后在 Obsidian 内部的插件市场装。

先选你所在的地区：

**中国大陆**

- 打开 [obsidian.md/download](https://obsidian.md/download)，点「Download for Windows」，得到 `Obsidian-1.15.1.exe`。
- Obsidian 的安装包实际托管在 GitHub，直连慢或断流时，改用命令行安装同样版本：`winget install Obsidian.Obsidian`。
- 安装包按当前用户安装，通常不会弹「用户账户控制」；装完在开始菜单里就能找到 Obsidian。


**欧洲 / 日本**

- 打开 [obsidian.md/download](https://obsidian.md/download) 下载 Windows 版，或直接去 [GitHub Releases](https://github.com/obsidianmd/obsidian-releases/releases) 拿最新一版的 `Obsidian-1.15.1.exe`。
- 只下 `.exe`；列表里的 `.dmg` 是 macOS、`.apk` 是安卓，装了也用不了。
- 想省事也可以在「Windows 终端」里运行 `winget install 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`（①），在结果里选中 ② 作者是 Logan Yang 的 Copilot，右侧详情页显示版本 4.1.0，点 ③ 的「安装」。

![社区插件市场：搜索框里输入了 Copilot，结果第一项是 Logan Yang 开发的 Copilot 4.1.0，右侧详情页底部有安装按钮](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）和仓库地址，点「信任作者并启用」即可，之后不会再问。




### 打开 Copilot 的 BYOK 页

按 `Ctrl` + `,` 回到设置，左侧「第三方插件」分组下面点 ① 的「Copilot」，切到 ② 的「BYOK」标签页，再点 ③ 的「+ Add a provider」。

![Obsidian 设置的 Copilot 页：顶部标签切到 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」

弹窗里按类别列出常见服务商。接 QCode 的 GPT 和国产模型走 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 Key？**

还没有 QCode 账号的话，先[注册 QCode](https://qcode.cc/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/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/dashboard)创建密钥。复制 `cr_` 开头那一整串，粘到 API key 里就行。


**卡住了？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 接入点（可选）

① 处是 Test 通过后会出现的绿色「Verified」。测试之前，先点「+ 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`；③ 的位置是模型开关列表，`QCode` 的 `gpt-6.2-sol` 和 `QCode Claude` 的 `Claude Opus 5.5` 都要拨开。

![Copilot 设置的 Quick Chat 标签：顶部标签选中 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」并回车。

![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」却让你下载别的东西**

那是 Copilot V4 的 agent 模式，要另外装运行环境，和本篇的 BYOK 不是一条路。请认准命令名里带「Quick Chat window」的那一条。




### 让它总结当前笔记

在右侧输入框里输入「用三句话总结当前笔记」并回车。面板会自动把当前这篇「欢迎」笔记一起带上，几秒后 ① 处出现中文总结，② 处显示这次用的是 `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」，再输入「你好，用一句话介绍你自己」并回车，几秒后回复就出现在 ① 处。

![同一个 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。




## 验证成功

下面四件事都对上，就说明 Obsidian 里的 Copilot 已经完整接通 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/pricing?utm_source=docs.qcode.cc&utm_medium=tut_done&utm_campaign=knowledge_base&src=docs-ide-obsidian-copilot-done)比较各个方案
- 回到[控制台](https://qcode.cc/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` | 密钥不完整、前后带空格，或用的是别的厂商的 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` |

## 可用模型

| 模型 | 在 Copilot 里填的 Model ID | 说明 |
|---|---|---|
| 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 系的模型只能填在 `QCode Claude` 这个 Anthropic 接入点里，GPT 和国产模型填在 `QCode` 这个 OpenAI 兼容接入点里。填错接入点，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` |
| 密钥 | 同一个 QCode 账号的 `cr_` 密钥，两个接入点都能用 |
| 必开开关 | 「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 这类运行环境，需要单独安装或登录对应账号，配置重得多。

只是想让 AI 读笔记、答问题、改文字，用 Quick Chat 就够了；需要 AI 自己动手改多个文件、跑命令时，再去了解 agent 模式。

## 相关文档

- [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths) — 各协议对应的地址与模型家族
- [国产模型接入](/docs/usage/cn-models) — OpenAI 兼容接入点可用的国产模型 ID
- [计费说明](/docs/reference/billing) — 用量怎么计算
- [故障排查](/docs/reference/troubleshooting) — 常见的连接与鉴权问题