GitHub Copilot CLI 是 Copilot 的命令行版本，支持通过自然语言完成代码开发任务。本页提供 Windows（WinGet/npm）、macOS（Homebrew/脚本）和 Linux（脚本/npm）的安装命令，以及完成安装后的初始认证流程。

安装 GitHub Copilot CLI：npm、Homebrew、WinGet 四种方式

前置要求

• GitHub Copilot 订阅：Pro、Pro+、Business 或 Enterprise 套餐
• Windows 用户：需要 PowerShell v6 或更高版本
• npm 安装方式：需要 Node.js 22+
• 组织/企业用户：需要管理员在策略中启用 Copilot CLI

安装方式

Windows：WinGet（推荐）

winget install GitHub.Copilot

安装预发布版（体验最新功能）：

winget install GitHub.Copilot.Prerelease

macOS：Homebrew

brew install copilot-cli

安装预发布版：

brew install copilot-cli@prerelease

macOS / Linux：一键安装脚本

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

或使用 wget：

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

安装到 /usr/local/bin（需要 root 权限）：

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

指定版本或安装目录：

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

所有平台：npm

需要 Node.js 22+：

npm install -g @github/copilot

安装预发布版：

npm install -g @github/copilot@prerelease

如果 ~/.npmrc 中设置了 ignore-scripts=true，改用：

npm_config_ignore_scripts=false npm install -g @github/copilot

验证安装

安装完成后，运行 copilot 命令，如果显示帮助信息则安装成功：

copilot --version

初次认证

安装后首次运行 copilot 时会自动提示登录。也可以手动运行：

copilot login

或在 CLI 内使用 /login 命令。

企业 GitHub（GHE.com）认证

copilot login --host <SUBDOMAIN>.ghe.com

将 <SUBDOMAIN> 替换为你的企业子域名。

常见问题

Q: Windows 上安装后，找不到 copilot 命令怎么办？

A: 确认 Node.js/npm 的全局 bin 目录或 WinGet 安装路径已添加到系统 PATH。在 PowerShell 中运行 $env:PATH 查看当前路径，必要时重启终端或系统。

Q: 安装预发布版有什么风险？

A: 预发布版包含最新功能，但可能有 bug。如果遇到问题，用对应命令安装稳定版即可（去掉 @prerelease 后缀）。

Q: 需要每台机器都单独安装吗，还是可以共享？

A: 每台机器都需要单独安装。认证信息存储在本地 OS 密钥链或配置文件中，不能跨机器共享（除了 CI/CD 环境用 Token 的方式）。