要在安装之前了解 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 或更高版本。
npm install -g @github/copilot
npm install -g @github/copilot
注意
如果在 ~/.npmrc 文件中设置了 ignore-scripts=true,则必须使用以下命令
npm_config_ignore_scripts=false npm install -g @github/copilot
npm_config_ignore_scripts=false npm install -g @github/copilot
安装预发行版本
npm install -g @github/copilot@prerelease
npm install -g @github/copilot@prerelease
使用 WinGet 安装(Windows)
winget install GitHub.Copilot
winget install GitHub.Copilot
安装预发行版本
winget install GitHub.Copilot.Prerelease
winget install GitHub.Copilot.Prerelease
使用 Homebrew 安装(macOS 和 Linux)
brew install copilot-cli
brew install copilot-cli
安装预发行版本
brew install copilot-cli@prerelease
brew install copilot-cli@prerelease
使用安装脚本安装(macOS 和 Linux)
curl -fsSL https://gh.io/copilot-install | bash
curl -fsSL https://gh.io/copilot-install | bash
或
wget -qO- https://gh.io/copilot-install | bash
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 安装到自定义目录
curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.369" PREFIX="$HOME/custom" bash
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”权限的细粒度个人访问令牌进行身份验证。
- 访问 细粒度个人访问令牌。
- 在“权限”下,点击 添加权限 并选择 Copilot Requests。
- 点击 生成令牌。
- 在终端或环境配置中导出令牌。使用
COPILOT_GITHUB_TOKEN、GH_TOKEN或GITHUB_TOKEN环境变量(按优先级顺序)。
后续步骤
现在可以在命令行中使用 Copilot。请参阅 使用 GitHub Copilot CLI。