close

安装 GitHub Copilot CLI

了解如何安装 Copilot CLI ，以便直接从命令行使用 Copilot 。

谁可以使用此功能？

GitHub Copilot 命令行界面 (CLI) 适用于所有 Copilot 计划。 如果从组织收到 Copilot，必须在组织的设置中启用 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 ，则您无法使用 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。