# 在 GitHub Desktop 中配置Copilot

选择哪个 AI 模型 Copilot in GitHub Desktop 用于每个功能，或连接自己的 LLM 提供程序。

可以选择用于每个Copilot功能的模型GitHub Desktop，例如提交消息生成和冲突解决。

还可以配置为 Copilot in GitHub Desktop 使用自己的 LLM 提供程序（BYOK），而不是 GitHub托管模型。 这样，便可以连接到与 OpenAI 兼容的终结点、Azure OpenAI 或 Anthropic，包括本地运行的模型（如 Ollama）。

## 先决条件

* 必须登录到有权访问 GitHub 的 Copilot in GitHub Desktop帐户。
* 如果访问权限由组织或企业管理， Copilot in GitHub Desktop 则必须为帐户启用。
* 你拥有受支持 LLM 提供程序的 API 密钥或持有者令牌，或者运行本地模型，例如 Ollama。
* 具有要使用的提供程序的基 URL 和至少一个模型标识符。

> \[!NOTE]
> 自定义 LLM 提供程序 GitHub Desktop 需要访问 Copilot in GitHub Desktop。 若要结合使用自己的 LLM 模型， Copilot CLI请参阅 [在 GitHub Copilot CLI 中使用自己的 LLM 模型](/zh/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models)。

## 支持的提供程序类型

GitHub Desktop 支持三种自定义提供程序类型：

| 供应商类型                 | 兼容的服务                                                   |
| --------------------- | ------------------------------------------------------- |
| **OpenAI /OpenAI 兼容** | OpenAI、Ollama、vLLM、Foundry Local 和与所选 API 格式兼容的任何其他终结点。 |
| **Azure**             | Azure OpenAI 服务。                                        |
| **Anthropic**         | Anthropic Claude模型。                                     |

## 配置服务提供商

通过在设置中添加 GitHub Desktop 自定义提供程序来配置模型提供程序。

<div class="ghd-tool mac">

1. 在菜单栏中，选择“GitHub Desktop”，然后单击“设置”\*\*\*\*\*\*\*\*。

   ![Mac 上的菜单栏的屏幕截图。 在打开的“GitHub Desktop”下拉菜单下，光标悬停在“设置”上，该设置以蓝色突出显示。](/assets/images/help/desktop/mac-choose-settings.png)

2. 在左侧栏中，单击 **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-copilot" aria-label="copilot" role="img"><path d="M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z"></path><path d="M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z"></path></svg>Copilot**。

3. 单击“ **提供程序** ”选项卡。

4. 单击“ **添加提供程序**”。

5. 在 **“名称”** 下，键入 LLM 提供程序的名称。

6. 在 **“类型”** 下，选择提供程序类型。

7. 在**Base URL**下方，输入你的模型提供商 API 端点的基础 URL。

   基 URL 必须是 HTTPS URL，或者是指向本地计算机的 HTTP URL。

8. 如果选择 **了 OpenAI/OpenAI 兼容**，请在 **API 格式**下选择提供程序所需的 API 格式。
   * 对于使用 OpenAI 聊天完成 API 的提供程序，请选择 **“聊天完成”（默认值** ）。
   * 对于使用 OpenAI Responses API 的提供方，请选择**响应（GPT-5 系列）**。

9. 如果选择**Azure**，请在**Azure API 版本**下键入部署的 API 版本。

10. （可选）在 **请求超时（秒）** 下，键入等待提供程序响应的秒 GitHub Desktop 数。

11. 在 **“身份验证**”下，选择身份验证方法。
    * 选择 **API 密钥** 以使用 API 密钥进行身份验证。
    * 选择 **持有者令牌** 以使用持有者令牌进行身份验证。
    * 仅针对不需要凭据的终结点选择 **“无** ”。

12. 如果您选择了 **API 密钥** 或 **Bearer 令牌**，请输入所需的凭据。

13. 向提供程序添加至少一个模型。 有关详细信息，请参阅 [向提供程序添加模型](#adding-models-to-your-provider)。

14. 单击 **添加**。

</div>

<div class="ghd-tool windows">

1. 使用文件”菜单，然后单击“选项” 。

   ![Windows 上的“GitHub Desktop”菜单栏的屏幕截图。 在展开的“文件”下拉菜单中，以橙色框出了“选项”项。](/assets/images/help/desktop/windows-choose-options.png)

2. 在左侧栏中，单击 **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-copilot" aria-label="copilot" role="img"><path d="M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z"></path><path d="M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z"></path></svg>Copilot**。

3. 单击“ **提供程序** ”选项卡。

4. 单击“ **添加提供程序**”。

5. 在 **“名称”** 下，键入 LLM 提供程序的名称。

6. 在 **“类型”** 下，选择提供程序类型。

7. 在**Base URL**下方，输入你的模型提供商 API 端点的基础 URL。

   基 URL 必须是 HTTPS URL，或者是指向本地计算机的 HTTP URL。

8. 如果选择 **了 OpenAI/OpenAI 兼容**，请在 **API 格式**下选择提供程序所需的 API 格式。
   * 对于使用 OpenAI 聊天完成 API 的提供程序，请选择 **“聊天完成”（默认值** ）。
   * 对于使用 OpenAI Responses API 的提供方，请选择**响应（GPT-5 系列）**。

9. 如果选择**Azure**，请在**Azure API 版本**下键入部署的 API 版本。

10. （可选）在 **请求超时（秒）** 下，键入等待提供程序响应的秒 GitHub Desktop 数。

11. 在 **“身份验证**”下，选择身份验证方法。
    * 选择 **API 密钥** 以使用 API 密钥进行身份验证。
    * 选择 **持有者令牌** 以使用持有者令牌进行身份验证。
    * 仅针对不需要凭据的终结点选择 **“无** ”。

12. 如果您选择了 **API 密钥** 或 **Bearer 令牌**，请输入所需的凭据。

13. 向提供程序添加至少一个模型。 有关详细信息，请参阅 [向提供程序添加模型](#adding-models-to-your-provider)。

14. 单击 **添加**。

</div>

## 将模型添加到提供程序

从提供商添加要使用的模型。 添加的每个模型都与 -hosted 模型一起 GitHub显示在模型选取器中。

1. 在 **“添加自定义提供程序** ”或 **“编辑自定义提供程序** ”对话框中的“ **模型**”下，单击“ **添加模型**”。
2. 在 **“显示名称”** 下，键入模型选取器中显示的 Copilot 友好名称。
3. 在 **“模型标识符**”下，键入提供程序所需的确切模型名称。
4. 在 **“推理努力**”下，选择模型的推理级别。

   对于非推理模型，或让提供程序选择，请保留 **“默认”（提供程序的选择）处于选中状态** 。
5. 单击 **添加**。

## 评审提供商职责

使用自己的 LLM 提供程序时， GitHub Desktop 将提示和存储库上下文发送到该提供程序而不是 GitHub该提供程序。 在添加凭据之前，请检查提供程序的数据处理和保留策略。

在提交之前，请始终查看生成的提交消息和冲突解决建议。 有关详细信息，请参阅“[负责任地使用GitHub Copilot功能](/zh/copilot/responsible-use)”。

## 延伸阅读

* [在 GitHub Desktop 中提交并审查对项目的更改](/zh/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop)
* [GitHub Copilot中支持的 AI 模型](/zh/copilot/reference/ai-models/supported-models)
* [在 GitHub Copilot CLI 中使用自己的 LLM 模型](/zh/copilot/how-tos/copilot-cli/customize-copilot/use-byok-models)