安装 GitHub Copilot CLI

了解如何安装 Copilot 命令行界面（CLI），以便能够直接从命令行使用 Copilot。

谁可以使用此功能？

GitHub Copilot 命令行界面 (CLI) 与所有 Copilot 计划兼容。 如果从组织收到 Copilot，则必须在组织的“Settings”中启用 Copilot 命令行界面（CLI） 策略。

在本文中

要在安装 Copilot 命令行界面（CLI） 前了解其相关信息，请参阅“关于 GitHub Copilot CLI”。

先决条件

  •         **有效的 GitHub Copilot 订阅**。 请参阅 [Copilot 计划](https://github.com/features/copilot/plans?ref_product=copilot&ref_type=engagement&ref_style=text)。
  • （在 Windows 上） PowerShell v6 或更高版本

如果你通过所在组织或企业获得了 GitHub Copilot 的使用权限，但如果组织所有者或企业管理员在组织或企业设置中禁用了 Copilot 命令行界面（CLI），你将无法使用该命令行工具。 请参阅 管理组织中GitHub Copilot 的策略和功能。

安装或更新 Copilot 命令行界面（CLI）

你可以使用 WinGet (Windows)、Homebrew（macOS 和 Linux）、npm（所有平台）或安装脚本（macOS 和 Linux）安装 Copilot 命令行界面（CLI）。

使用 npm 安装（所有平台）

先决条件：Node.js 22 或更高版本。

Shell
npm install -g @github/copilot

注意

如果在ignore-scripts=true文件中有~/.npmrc，则必须使用以下命令：

Shell
npm_config_ignore_scripts=false npm install -g @github/copilot

安装预发行版版本：

Shell
npm install -g @github/copilot@prerelease

使用 WinGet 安装 （Windows）

PowerShell
winget install GitHub.Copilot

安装预发行版版本：

PowerShell
winget install GitHub.Copilot.Prerelease

使用 Homebrew 进行安装（macOS 和 Linux）

Shell
brew install copilot-cli

安装预发行版版本：

Shell
brew install copilot-cli@prerelease

使用安装脚本进行安装（macOS 和 Linux）

Shell
curl -fsSL https://gh.io/copilot-install | bash

或者：

Shell
wget -qO- https://gh.io/copilot-install | bash

若要以根身份运行并安装到 /usr/local/bin，请使用 | sudo bash。

若要安装到自定义目录，请设置 PREFIX 环境变量。 运行时，如果以根用户身份运行，默认为 /usr/local；如果以非根用户身份运行，默认为 $HOME/.local。

若要安装特定版本，请设置 VERSION 环境变量。 默认为最新版本。

例如，若要将版本 v0.0.369 安装到自定义目录，

Shell
curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.369" PREFIX="$HOME/custom" bash

从 GitHub.com

下载

可以直接从存储库copilot-cli下载可执行文件。

下载平台的可执行文件，将其解压缩并运行。

使用 Copilot 命令行界面（CLI） 进行身份验证

首次启动时，如果当前未登录到 GitHub，系统会提示你使用 /login 斜杠命令。 输入此命令并按照屏幕说明完成身份验证流程。 有关身份验证过程的详细信息，请参阅 GitHub Copilot CLI 身份验证。

使用 personal access token

进行身份验证

你也可以使用启用了“Copilot 请求”权限的 fine-grained personal access token 进行身份验证。

  1. 访问Fine-grained personal access tokens。
  2. 在“权限”下，单击“ 添加权限 ”，然后选择 Copilot 请求。
  3. 单击“生成令牌”。****
  4. 在终端或环境配置中导出令牌。 使用COPILOT_GITHUB_TOKEN、GH_TOKEN或GITHUB_TOKEN环境变量（按优先级顺序）。

后续步骤

现在你即可从命令行使用 Copilot。 请参阅“使用 GitHub Copilot CLI”。