{"meta":{"title":"GitHub Copilot 应用入门","intro":"登录GitHub Copilot app，连接存储库或本地文件夹，并创建你的第一个代理会话以进行代码更改。","product":"GitHub Copilot","breadcrumbs":[{"href":"/zh/copilot","title":"GitHub Copilot"},{"href":"/zh/copilot/get-started","title":"开始"},{"href":"/zh/copilot/get-started/quickstart-copilot-app","title":"Copilot 应用快速入门"}],"documentType":"article"},"body":"# GitHub Copilot 应用入门\n\n登录GitHub Copilot app，连接存储库或本地文件夹，并创建你的第一个代理会话以进行代码更改。\n\n有关 GitHub Copilot app 的概念性概述，请参阅 [GitHub Copilot 应用](/zh/copilot/concepts/copilot-surfaces/github-copilot-app)。\n\n在本快速入门中，您将：\n\n1. 安装并登录到GitHub Copilot app。\n2. 连接存储库或本地文件夹。\n3. 在代理会话中更改代码。\n\n## 先决条件\n\n* GitHub 帐户。\n* 一个 Copilot 计划，或者你也可以配置自己的模型提供方。\n  * 如果您使用自己的模型提供商，则需要提供商凭据，例如 API 密钥。 有关设置步骤，请参阅 [将 LLM 模型添加到 GitHub Copilot 应用](/zh/copilot/how-tos/github-copilot-app/use-byok-models)。\n* 你的电脑上已安装 [Git](https://github.com/git-guides/install-git)。\n\n> [!NOTE]\n> 对于 Copilot Business 用户和 Copilot Enterprise 用户，策略 GitHub Copilot app 必须保持启用状态。 此策略默认处于启用状态，独立于 Copilot CLI 策略。 请参阅“[管理组织中GitHub Copilot的策略和功能](/zh/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies)”或“[管理企业中 GitHub Copilot 的策略和功能](/zh/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies)”。\n\n## 安装 GitHub Copilot app\n\n下载并安装适用于您的操作系统的 GitHub Copilot app。 有关其他操作系统和体系结构，请参阅 [下载页](https://github.com/features/ai/github-app)。\n\n<a href=\"https://github.com/features/ai/github-app\" target=\"_blank\" class=\"btn btn-primary mt-3 mr-3 no-underline js-os-download\" data-os-download-mac=\"https://gh.io/copilot-app-mac\" data-os-download-mac-intel=\"https://gh.io/copilot-app-mac-intel\" data-os-download-windows=\"https://gh.io/copilot-app-win64\" data-os-download-windows-arm=\"https://gh.io/copilot-app-win-arm\" data-os-download-linux=\"https://gh.io/copilot-app-linux\">\n<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-desktop-download\" aria-label=\"desktop download icon\" role=\"img\"><path d=\"m4.927 5.427 2.896 2.896a.25.25 0 0 0 .354 0l2.896-2.896A.25.25 0 0 0 10.896 5H8.75V.75a.75.75 0 1 0-1.5 0V5H5.104a.25.25 0 0 0-.177.427Z\"></path><path d=\"M1.573 2.573a.25.25 0 0 0-.073.177v7.5a.25.25 0 0 0 .25.25h12.5a.25.25 0 0 0 .25-.25v-7.5a.25.25 0 0 0-.25-.25h-3a.75.75 0 1 1 0-1.5h3A1.75 1.75 0 0 1 16 2.75v7.5A1.75 1.75 0 0 1 14.25 12h-3.727c.099 1.041.52 1.872 1.292 2.757A.75.75 0 0 1 11.25 16h-6.5a.75.75 0 0 1-.565-1.243c.772-.885 1.192-1.716 1.292-2.757H1.75A1.75 1.75 0 0 1 0 10.25v-7.5A1.75 1.75 0 0 1 1.75 1h3a.75.75 0 0 1 0 1.5h-3a.25.25 0 0 0-.177.073ZM6.982 12a5.72 5.72 0 0 1-.765 2.5h3.566a5.72 5.72 0 0 1-.765-2.5H6.982Z\"></path></svg>\n<span class=\"js-os-download-label\">下载 GitHub Copilot app</span></a>\n\n## 首次打开 GitHub Copilot app\n\n1. 打开GitHub Copilot app。\n2. 单击“**登录到 GitHub**”，然后按照提示进行身份验证。\n\n   如果您将 GitHub Enterprise Cloud 与数据驻留功能结合使用，请选择 **使用 GitHub Enterprise**，并在系统提示时输入您的 `*.ghe.com` 主机名。\n   GitHub Enterprise Server不受GitHub Copilot app支持。\n3. 如果你尚未开通 Copilot 计划，请选择是注册该计划，还是继续使用自己的模型提供商。\n   * 如果选择使用自己的模型提供程序，请选择提供程序，输入任何必需的凭据，然后单击“ **保存并继续**”。\n4. 出现提示时，根据最近的 GitHub 活动选择一个或多个存储库。 还可以添加本地文件夹或存储库，或者跳过此步骤，并在以后添加存储库。\n5. 选择主题，然后完成载入以打开应用。\n\n## 连接存储库或文件夹\n\n若要处理代码，至少需要一个连接到应用的存储库或本地文件夹。 可以连接计算机上已有的文件夹，包括已在本地克隆的存储库，或者连接从 GitHub 或其他远程 Git 主机克隆的存储库，例如 Azure DevOps。 连接存储库或文件夹可解锁核心应用工作流：读取代码、进行编辑和在代理会话中打开拉取请求。 如果在初始引导期间跳过了存储库设置，或者想要在以后添加更多存储库或文件夹：\n\n1. 在边栏中的 **“会话”** 旁边，单击 <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-plus\" aria-label=\"New\" role=\"img\"><path d=\"M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z\"></path></svg>。\n2. 从以下位置选择要添加存储库或文件夹的位置：\n\n* **打开本地文件夹** — 选择计算机上已有的文件夹，包括包含你已在本地克隆的仓库的文件夹。\n* **添加 GitHub 存储库** - 从 GitHub中浏览和克隆存储库。\n* **克隆存储库** — 从 Git URL 克隆托管在 GitHub 之外的存储库（例如 Azure DevOps 上的存储库）或应用无权访问的私有存储库。\n\n## 首次修改代码\n\n1. 在边栏中，紧挨着**会话**，单击<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-plus\" aria-label=\"New\" role=\"img\"><path d=\"M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z\"></path></svg>，然后选择“开始会话位置”下的已连接存储库或文件夹。\n\n2. 从提示字段下方的下拉列表中选择会话模式，例如 **交互式** 模式，以便与代理协作工作。\n\n3. 在提示框中，粘贴此提示：\n\n   ```copilot copy\n   Suggest a small low-risk code change in this repository, implement it, and explain the diff.\n   ```\n\n4. 响应来自代理的任何输入请求。 代理进行更改后，单击提示框上方的 **“更改** ”以查看差异。\n\n5. 继续在同一会话中迭代，直到你对结果满意为止。\n\n6. 如果要保留更改，请单击“ **创建 PR** ”以打开拉取请求以供审阅。\n\n7. 如果创建拉取请求，请单击提示框上方的 **PR** ，直接在应用中查看它。\n\n**选：** 如果已有要在存储库中完成的任务，可以从 **[“我的工作](https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fmywork)**”中的问题启动会话。 有关详细信息，请参阅“[使用 GitHub Copilot 应用管理问题和拉取请求](/zh/copilot/how-tos/github-copilot-app/managing-issues-and-pull-requests)”。\n\n## 确定方位\n\n边栏允许你访问应用的主要区域：\n\n* **新建** - 启动新的代理会话。\n* **[我的工作](https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fmywork)** — 浏览和筛选你的存储库中的议题和拉取请求，检查 CI 状态，并留下评审意见。\n* **[自动化](https://github.com/copilot/app/launch?open=ghapp%3A%2F%2Fautomations)** — 已保存的按计划或按需运行的代理任务。\n* **自定义** - 发现和管理插件、技能、MCP 服务器和画布。\n* **搜索** - 直接从应用搜索存储库。\n* **会话** - 查看连接的存储库、本地文件夹及其活动代理会话，或启动存储库或文件夹的新会话。\n* **聊天** - 不需要专用分支或工作区的常规对话。\n\n## 后续步骤\n\n详细了解如何使用GitHub Copilot app：\n\n* [在 GitHub Copilot 应用中使用代理会话](/zh/copilot/how-tos/github-copilot-app/agent-sessions)\n* [在 GitHub Copilot 应用中使用画布扩展](/zh/copilot/how-tos/github-copilot-app/working-with-canvas-extensions)\n* [使用 GitHub Copilot 应用管理问题和拉取请求](/zh/copilot/how-tos/github-copilot-app/managing-issues-and-pull-requests)\n* [在 GitHub Copilot 应用中使用自动化](/zh/copilot/how-tos/github-copilot-app/using-automations)\n* [GitHub Copilot 应用程序的斜杠命令](/zh/copilot/reference/github-copilot-app-reference/slash-commands)\n* [GitHub Copilot 应用的内置技能](/zh/copilot/reference/github-copilot-app-reference/built-in-skills)"}