如何安装并使用 GitHub Copilot CLI:安装、登录与第一个仓库任务

从官方安装通道到 /login,再到仓库里第一个可审查的 diff。需要有效 Copilot 订阅。

第一次用 GitHub Copilot CLI,卡住的通常不是提示词,而是装到哪个包、怎么登录,以及仓库里第一件能审查的事。按官方文档装 copilot,用 GitHub 账号登录,再改一行你自己能回滚的代码。

检索词是 如何安装并使用 GitHub Copilot CLI。下文跟官方安装页与认证页:docs.github.com/en/copilot/how-tos/copilot-cli。这是独立终端代理(命令是 copilot),不是已弃用的 gh copilot 扩展。要约短会对齐 diff,用 wbmeet 建房即可,步骤见 如何创建与加入房间

安装登录仓库里的第一件事

先核对能不能用

官方前提:有效的 GitHub Copilot 订阅。Windows 上需要 PowerShell v6 或更高。若 Copilot 来自组织或企业,管理员可在策略里关闭 Copilot CLI,关掉后个人也无法用。npm 安装还需要 Node.js 22+

22+
npm 路径的 Node
PS 6
Windows 官方最低
1
/login 设备码

第一次:安装、登录、改一行能审查的代码

  1. 1

    用官方通道安装

    全平台 npm:npm install -g @github/copilot(需 Node 22+)。若 ~/.npmrc 写了 ignore-scripts=true,改用 npm_config_ignore_scripts=false npm install -g @github/copilot。macOS/Linux 脚本:curl -fsSL https://gh.io/copilot-install | bash。Homebrew:brew install --cask copilot-cli。Windows WinGet:winget install GitHub.Copilot

  2. 2

    核对命令再进仓库

    新开终端,跑 copilot --version 或直接 copilot。出现 command not found 时先查 PATH(脚本默认非 root 装到 $HOME/.local/bin)。不要去跑旧的 gh copilot

  3. 3

    用 /login 完成认证

    cd 到你拥有的仓库,执行 copilot。未登录时按提示输入 /login,走浏览器设备码。自动化环境可设细粒度 PAT(账号权限里的 Copilot Requests,资源所有者必须是个人账号),再导出 COPILOT_GITHUB_TOKENGH_TOKENGITHUB_TOKEN(优先级从左到右)。已登录的 gh 可作为最低优先级回退。会话里 /user 可核对账号。

  4. 4

    做一个能审查的第一任务

    官方入门会建议 /init 生成面向本仓库的 Copilot 说明。然后先问「这个项目做什么、入口在哪」,再下一条:「给一个没测试的辅助函数补单测,或给一个对外函数加输入校验。先出示 diff,等我同意再改。」不要把密钥写进提示。

# Official install · as of 2026-09
# any platform with Node.js 22+
npm install -g @github/copilot
# or macOS / Linux
# curl -fsSL https://gh.io/copilot-install | bash
copilot --version
cd /path/to/your/project
copilot
# /login   then /init
# first task: add a unit test for one helper; show the diff first

安装通道、认证、常见坑

路径官方怎么写第一次注意
npm @github/copilot全平台;Node 22+ignore-scripts 会挡安装
install 脚本macOS/Linux;可设 PREFIX / VERSION新开终端再跑 copilot
Homebrew caskcopilot-cli不要装成旧 gh 扩展
WinGetGitHub.CopilotPowerShell 6+
组织策略关闭 CLI管理员可禁用先问管理员,再查订阅
01

装完找不到 copilot

多半是 PATH。脚本非 root 默认 $HOME/.local/bin。关掉旧窗口,新开终端。确认装的是 @github/copilot,不是别的同名包。

02

登录循环或 403

/login 走设备码。组织禁用 CLI 时个人订阅也过不去。PAT 必须挂在个人账号上并勾选 Copilot Requests,不要选组织作为资源所有者。

03

第一任务停在闲聊

/init 和「这个仓库做什么」只是热身。要有一条可审查的改动:单测、校验或你点名的小 bug,并看 diff。

官方 Installing GitHub Copilot CLI 与 Authenticating GitHub Copilot CLI:先装独立 CLI,再用 /login 或令牌。命令与策略以 docs.github.com 为准。

独立 CLI ≠ gh copilot 扩展
旧的 GitHub CLI 扩展已弃用。本页只写 copilot 这条独立命令。
环境变量优先级
官方顺序:COPILOT_GITHUB_TOKENGH_TOKENGITHUB_TOKEN → 钥匙串里的 OAuth → gh auth token
教程页不是会议说明书
只讲 Copilot CLI 第一次。短会白板见 wbmeet,以及何时不必再开沉重会议 App 的 对照笔记

还想核对的问题

没有 Copilot 订阅能用 CLI 吗?

官方安装页把有效 Copilot 订阅列为前提。组织或企业若关闭 Copilot CLI,即便个人有席位也不能用。

该用 npm、Homebrew 还是安装脚本?

都能装到同一条 copilot 命令。已有 Node 22+ 用 npm 最直接。macOS/Linux 也可用 gh.io/copilot-installbrew install --cask copilot-cli。Windows 用 WinGet,并确认 PowerShell 6+。

CI 里怎么登录?

不要走交互式 /login。用带 Copilot Requests 的细粒度 PAT,导出到 COPILOT_GITHUB_TOKEN(或 GH_TOKEN / GITHUB_TOKEN)。不要把令牌写进仓库或提示词。

第一个任务必须改生产代码吗?

不必。先 /init 或问项目做什么,再做一件可回滚的小事(单测或校验),并先看 diff。

免费开始开会