GitHub Copilot CLI 教程:把 Copilot 智能体搬进终端(2026)
GitHub Copilot CLI 是 GitHub 官方推出的终端 AI 编程工具:把 Copilot 背后的编程智能体(coding agent)直接搬进命令行,你用自然语言下需求,它读代码库、跨文件改代码、执行命令、跑测试,改动前逐项征求你的批准,还能顺手帮你建 PR、开 issue。它和 Claude Code、Codex CLI、Gemini CLI 同属「住在终端里的 agentic 编程工具」,最大优势是背靠 GitHub 生态——一个 GitHub 账号就能用,连免费版 Copilot 都包含这个功能。这篇 GitHub Copilot CLI 教程带你从安装、登录到计划模式、模型切换一次跑通。
GitHub Copilot CLI 是什么
很多人对 Copilot 的印象还停留在「IDE 里的灰色补全」,Copilot CLI 是完全不同的东西。它 2025 年 9 月开启公开预览、2026 年初正式发布(GA),定位是终端原生的自主智能体:不是补全你正在敲的那一行,而是接下一个完整任务——「给这个项目加上 JWT 认证」「找出测试为什么挂了并修好」——然后自己规划步骤、读文件、写代码、跑命令,一步步执行给你看。它与 IDE 版 Copilot 共享订阅:Free、Pro、Pro+、Business、Enterprise 所有档位都能用 CLI,不需要单独付费。对已经在用 GitHub 的开发者来说,这是上手成本最低的终端 AI 编程入口。
一句话定位
GitHub Copilot CLI = GitHub 官方的终端编程智能体。一个 GitHub 账号即可用(含免费版),能建项目、跨文件改代码、修 bug、建 PR,改文件前必须经你批准。
安装:npm / Homebrew / WinGet / 一键脚本
官方给了四种安装方式,覆盖三大平台。npm 方式要求 Node.js 22 或更高版本;Windows 下还要求 PowerShell v6+。任选其一:
# 方式一:npm(全平台,需 Node.js 22+)
npm install -g @github/copilot
# 方式二:Homebrew(macOS / Linux)
brew install --cask copilot-cli
# 方式三:WinGet(Windows)
winget install GitHub.Copilot
# 方式四:一键安装脚本(macOS / Linux)
curl -fsSL https://gh.io/copilot-install | bash登录认证与第一次对话
装好后进入你的项目目录,运行 copilot 启动交互会话。首次使用输入 /login,按屏幕提示用 GitHub 账号完成设备码认证即可——不需要单独申请 API Key,这是它比多数同类工具省事的地方。如果要在 CI 或脚本里无人值守运行,可以改用个人访问令牌(PAT,需勾选 Copilot Requests 权限),设置到 COPILOT_GITHUB_TOKEN 环境变量:
# 进入项目目录,启动交互会话
cd /path/to/your/project
copilot
# 会话内首次登录
/login
# 非交互模式:一问一答,拿到回复就退出(适合脚本)
copilot -p "用 git 怎么把另一个分支的某次提交应用到当前分支?"
# 静默模式:只输出回复正文,方便管道处理
copilot -sp "解释这个仓库的目录结构"
# CI / 无人值守:用 PAT 认证
export COPILOT_GITHUB_TOKEN="你的 GitHub PAT"基本用法:自然语言 + @ 文件 + 斜杠命令
会话里直接用自然语言描述任务即可。三个高频操作:输入 @ 可以把指定文件拉进上下文(比如「@src/auth.js 这个文件里的 token 校验有什么问题」);输入 / 呼出斜杠命令菜单;输入 ? 查看帮助。安全机制是它的一大卖点:Copilot CLI 不会在未经你明确批准的情况下修改任何文件——每次写文件、执行有副作用的命令前都会停下来征求确认,你可以单次允许、本会话内允许或拒绝。日常它能干的事包括:
- 从零搭项目脚手架:描述技术栈(如 Node.js + Express + PostgreSQL),自动生成目录结构、依赖和样板代码
- 跨文件改代码、加功能、重构,改动前逐项给你过目
- 解释陌生代码库:目录结构、调用关系、某段逻辑为什么这么写
- 跑命令、看报错、修 bug 的完整循环
- GitHub 操作:建 issue、发 PR、查 CI 状态,不用离开终端
计划模式与模型切换
复杂任务别让它上来就动手——按 Shift+Tab 切换到计划模式(plan mode),Copilot 会先分析需求、提出澄清问题、列出结构化的实施计划,你确认后再开始写代码,返工率低很多。这个「先审方案再动工」的习惯在所有 agentic 工具里都值得养成。模型方面,用 /model 命令可以在多个模型间切换:写作时默认是 Claude 系列模型,另有 OpenAI 的 Codex 系模型、Google Gemini 系模型可选,具体清单随时间更新。Copilot CLI 也支持 MCP(Model Context Protocol):内置 GitHub MCP 服务器,还可以自己加 MCP 服务器扩展能力,比如接内部文档、数据库等。
免费额度与计费:2026 年 6 月起改按 AI Credits
Copilot CLI 包含在所有 Copilot 订阅档位里,免费版(Copilot Free)也能直接用,无需绑信用卡。需要注意计费口径正在换轨:旧模式下 CLI 的每条提示词消耗 1 个高级请求(premium request),Free 档每月约 50 个高级请求额度,Pro($10/月)及以上档额度更多;2026 年 6 月 1 日起,GitHub 把高级请求制替换为 AI Credits——按每次调用实际消耗的 token 量(输入 + 输出 + 缓存)和所选模型的费率扣积分。对轻量用户影响不大,但重度终端用户要留意:选贵模型、跑长上下文任务的消耗会比旧的按次计费更「诚实」。各档位的确切额度以 GitHub 官方定价页实时为准。
免费档省额度的用法
Free 档额度有限,建议把 Copilot CLI 用在刀刃上:让它干「一次对话解决一个明确任务」的活,杂事(查语法、写单行命令)用 -p 一问一答解决;长时间大改造类任务更适合升级付费档或换按套餐计费的工具。
和 Claude Code、Codex CLI、Gemini CLI 怎么比
| 工具 | 出品方 | 特点 |
|---|---|---|
| Copilot CLI | GitHub | GitHub 账号即用、免费档可上手,多模型可切换,GitHub 生态(PR/issue/CI)整合最深 |
| Claude Code | Anthropic | agentic 能力和生态最成熟,subagents/skills/hooks 玩法多,国内多接第三方网关或国产套餐 |
| Codex CLI | OpenAI | 开源,配 ChatGPT 订阅使用,工程任务表现强 |
| Gemini CLI | 开源起家、免费额度大方,现已向 Antigravity 体系迁移 |
选择建议:已经在深度用 GitHub(PR 流程、Actions、issue 管理)的团队,Copilot CLI 的生态整合是独一份的;想要最强 agentic 能力和可定制性,Claude Code 仍是标杆;预算敏感的个人开发者可以先用 Copilot Free 档 + 国产模型套餐组合。国内使用 Copilot CLI 主要门槛是网络——需要能稳定访问 github.com 及其 API,登录用的设备码认证对网络质量也有要求。这几个工具彼此不冲突,站内有 Claude Code、Codex CLI、Gemini CLI 的对应教程,可以都装上按任务混用。
Copilot CLI 把终端 AI 编程的上手门槛压到了最低:一个 GitHub 账号、一条 npm 命令就能开始。但工具只是入口,真正决定产出的是你会不会把需求拆成智能体能稳定完成的任务、会不会用计划模式把方案审清楚再动工。想系统掌握用 AI 编程工具做出能交付产品的完整方法,欢迎来 IMAI 看看我们的体系化实战课程。
想系统学会用 AI 编程,从入门到做出真实产品?
查看系统课程