跳至主要内容

安装 GitHub Copilot CLI

了解如何安装 Copilot CLI,以便直接在命令行中使用 Copilot。

谁可以使用此功能?

GitHub Copilot CLI 在所有 Copilot 计划中均可用。如果您通过组织获取 Copilot,则必须在组织设置中启用 Copilot CLI 策略。

要在安装之前了解 Copilot CLI,请参阅 关于 GitHub Copilot CLI

先决条件

  • 有效的 GitHub Copilot 订阅。参阅 Copilot 计划
  • (在 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

注意

如果在 ~/.npmrc 文件中设置了 ignore-scripts=true,则必须使用以下命令

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

以 root 身份运行并安装到 /usr/local/bin,请使用 | sudo bash

要安装到自定义目录,请设置 PREFIX 环境变量。以 root 身份运行时默认值为 /usr/local,以非 root 用户运行时默认值为 $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

使用个人访问令牌进行身份验证

您也可以使用已启用“Copilot Requests”权限的细粒度个人访问令牌进行身份验证。

  1. 访问 细粒度个人访问令牌
  2. 在“权限”下,点击 添加权限 并选择 Copilot Requests
  3. 点击 生成令牌
  4. 在终端或环境配置中导出令牌。使用 COPILOT_GITHUB_TOKENGH_TOKENGITHUB_TOKEN 环境变量(按优先级顺序)。

后续步骤

现在可以在命令行中使用 Copilot。请参阅 使用 GitHub Copilot CLI

© . This site is unofficial and not affiliated with GitHub, Inc.