如何安装并使用 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+。
第一次:安装、登录、改一行能审查的代码
- 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
核对命令再进仓库
新开终端,跑
copilot --version或直接copilot。出现command not found时先查 PATH(脚本默认非 root 装到$HOME/.local/bin)。不要去跑旧的gh copilot。 - 3
用 /login 完成认证
cd到你拥有的仓库,执行copilot。未登录时按提示输入/login,走浏览器设备码。自动化环境可设细粒度 PAT(账号权限里的 Copilot Requests,资源所有者必须是个人账号),再导出COPILOT_GITHUB_TOKEN、GH_TOKEN或GITHUB_TOKEN(优先级从左到右)。已登录的gh可作为最低优先级回退。会话里/user可核对账号。 - 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 cask | copilot-cli | 不要装成旧 gh 扩展 |
| WinGet | GitHub.Copilot | PowerShell 6+ |
| 组织策略关闭 CLI | 管理员可禁用 | 先问管理员,再查订阅 |
装完找不到 copilot
多半是 PATH。脚本非 root 默认 $HOME/.local/bin。关掉旧窗口,新开终端。确认装的是 @github/copilot,不是别的同名包。
登录循环或 403
先 /login 走设备码。组织禁用 CLI 时个人订阅也过不去。PAT 必须挂在个人账号上并勾选 Copilot Requests,不要选组织作为资源所有者。
第一任务停在闲聊
/init 和「这个仓库做什么」只是热身。要有一条可审查的改动:单测、校验或你点名的小 bug,并看 diff。
官方 Installing GitHub Copilot CLI 与 Authenticating GitHub Copilot CLI:先装独立 CLI,再用 /login 或令牌。命令与策略以 docs.github.com 为准。
- 独立 CLI ≠ gh copilot 扩展
- 旧的 GitHub CLI 扩展已弃用。本页只写
copilot这条独立命令。 - 环境变量优先级
- 官方顺序:
COPILOT_GITHUB_TOKEN→GH_TOKEN→GITHUB_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-install 或 brew install --cask copilot-cli。Windows 用 WinGet,并确认 PowerShell 6+。
CI 里怎么登录?
不要走交互式 /login。用带 Copilot Requests 的细粒度 PAT,导出到 COPILOT_GITHUB_TOKEN(或 GH_TOKEN / GITHUB_TOKEN)。不要把令牌写进仓库或提示词。
第一个任务必须改生产代码吗?
不必。先 /init 或问项目做什么,再做一件可回滚的小事(单测或校验),并先看 diff。