跳到正文
FunCoding

搜索

搜索文档、Skill 和 MCP

安装、升级与预发布版本

选择 npm、WinGet、Homebrew、安装脚本或独立可执行文件,并管理更新渠道。

通过 GitHub 使用 Copilot CLI 需要有效的 Copilot 订阅;组织或企业提供的访问权限还受管理员的 CLI 策略限制。Windows 需要 PowerShell 6 或更高版本。使用自己提供的模型 API Key 时,GitHub 认证规则另见认证与配置。

选择安装方式

环境安装命令前提
跨平台 npmnpm install -g @github/copilotNode.js 22+
Windows WinGetwinget install GitHub.CopilotPowerShell 6+
macOS / Linux Homebrewbrew install --cask copilot-cli已安装 Homebrew

若 ~/.npmrc 设置了 ignore-scripts=true,安装时需要允许包的安装脚本:

npm_config_ignore_scripts=false npm install -g @github/copilot

也可以从官方 copilot-cli Releases 下载适合平台的可执行文件,解压后运行。不要把 npm 所需的 Node.js 版本当作所有分发方式共同的安装步骤。

安装脚本

macOS 和 Linux 可以运行官方脚本:

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

没有 curl 时,官方也提供 wget -qO- https://gh.io/copilot-install | bash。以 root 运行可将管道结尾换为 | sudo bash,安装到 /usr/local/bin。

脚本支持两个环境变量:PREFIX 指定安装前缀,root 默认 /usr/local,普通用户默认 $HOME/.local;VERSION 指定版本,默认最新版本。固定版本时使用 Releases 中存在的版本号,不能把官网示例中的历史版本当作当前最新版。

预发布渠道

需要验证尚未进入稳定版的功能时,按安装方式选择对应渠道:

npm install -g @github/copilot@prerelease
brew install --cask copilot-cli@prerelease
winget install GitHub.Copilot.Prerelease

这些是替代安装选项,无需全部执行。预发布功能的实际可用性以当前版本、账号和管理策略为准。

检查与更新

copilot version 显示版本并检查更新;copilot update 下载和安装最新版本。交互会话中的 /version 和 /update 分别提供对应入口,/upgrade 是更新命令的别名。

自动更新偏好可在设置编辑器中管理。安装后进入项目目录运行 copilot,按快速上手完成登录、目录信任和第一个任务。