
copilot-cli
在终端里用大白话让 Copilot 帮你写命令、查代码、干活
GitHub Copilot CLI 是 GitHub 官方推出的命令行工具,把 Copilot 编码代理的能力直接带进终端。它解决的核心问题是:开发者不必离开命令行、不必切换到网页或编辑器,就能让 AI 帮助理解代码、生成命令、排查报错和完成开发任务。核心能力包括自然语言驱动的命令建议与解释、对本地仓库上下文的理解、与 GitHub 工作流的衔接,以及通过 shell 集成让 AI 参与日常开发操作。项目以 Shell 脚本为主要实现,安装和接入相对轻量,适合习惯终端工作流的工程师。作为官方项目,它与 GitHub 生态和 Copilot 订阅体系绑定紧密,定位是让终端成为 AI 辅助编程的一等入口,而不是只做补全的编辑器插件。
项目数据
使用教程
环境要求
- macOS 或 Linux 系统(使用安装脚本或 Homebrew),Windows 使用 WinGet 或 npm
- 拥有 GitHub 账号并具备 Copilot 订阅,用于 CLI 认证
- 使用 npm 安装时需本地已安装 Node.js/npm 环境
- 使用 brew 需已安装 Homebrew,使用 winget 需已安装 WinGet
安装与启动步骤
-
1脚本安装(macOS/Linux)
官方安装脚本方式,默认非 root 用户装到 $HOME/.local,root 装到 /usr/local。也可用 wget -qO- 替代 curl。
curl -fsSL https://gh.io/copilot-install | bash -
2以 root 安装
希望安装到 /usr/local/bin 时,把管道后的 bash 换成 sudo bash 即可,需具备 sudo 权限。
curl -fsSL https://gh.io/copilot-install | sudo bash -
3指定版本与目录
通过环境变量 VERSION 指定版本、PREFIX 指定安装到 $PREFIX/bin,示例装在 $HOME/custom 下的 v0.0.369。
curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.369" PREFIX="$HOME/custom" bash -
4Homebrew 安装
macOS 和 Linux 均可用 Homebrew 安装稳定版;预发布版用 copilot-cli@prerelease。
brew install copilot-cli -
5WinGet 安装(Windows)
Windows 用户可用 WinGet 安装稳定版;预发布版用包名 GitHub.Copilot.Prerelease。
winget install GitHub.Copilot -
6npm 全局安装
macOS、Linux、Windows 通用,通过 npm 全局安装 @github/copilot,含预发布版通道。
npm install -g @github/copilot -
7安装语言服务器
Copilot CLI 不自带 LSP 服务器,需要按语言单独安装,例如为 TypeScript 安装语言服务器。
npm install -g typescript-language-server
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
VERSION | 否 | 指定要安装的版本,默认安装最新版 | v0.0.369 |
PREFIX | 否 | 指定安装目录,装到 $PREFIX/bin,root 默认 /usr/local,非 root 默认 $HOME/.local | $HOME/custom |
如何确认成功
安装命令执行完成且无报错,终端的 copilot 命令可被调用;首次使用需用 GitHub 账号完成认证。
常见问题
Q:安装脚本默认装到哪个目录?
A:以 root(sudo bash)运行时装到 /usr/local/bin;以普通用户运行时默认装到 $HOME/.local 下的 bin 目录,可用 PREFIX 变量自定义。
Q:怎么安装指定版本?
A:在安装脚本前设置 VERSION 环境变量,例如 VERSION="v0.0.369" 后再接 PREFIX 和 bash 执行;不设置则默认安装最新版本。
Q:如何安装预发布版?
A:Homebrew 用 brew install copilot-cli@prerelease,WinGet 用 winget install GitHub.Copilot.Prerelease,npm 用 npm install -g @github/copilot@prerelease。
Q:Windows 能用安装脚本吗?
A:安装脚本面向 macOS 和 Linux。Windows 请使用 WinGet(winget install GitHub.Copilot)或 npm(npm install -g @github/copilot)。
Q:为什么语言相关能力不完整?
A:Copilot CLI 不内置 LSP 服务器,需要按语言单独安装对应的 language server,并参照官方文档的模式进行配置。
注意事项
- 安装脚本仅支持 macOS 和 Linux,Windows 请走 WinGet 或 npm 通道。
- CLI 使用现有 GitHub 账号认证,与 GitHub 及 Copilot 订阅体系绑定。
- 默认集成 GitHub MCP server 并支持自定义 MCP server 扩展能力。
- 所有操作执行前都会预览,需你显式批准后才会生效;更多信息见官方文档 docs.github.com/copilot/concepts/agents/about-copilot-cli。
核心亮点
- 官方出品,与 GitHub 账号和 Copilot 订阅体系直接打通,接入成本低
- 面向终端场景,命令建议、解释和代码问答都在 shell 内完成,不打断工作流
- 能结合本地仓库上下文理解问题,适合排查报错、读懂陌生代码库
不足之处
- 强依赖 GitHub Copilot 订阅,未订阅用户无法完整体验
- 核心能力依赖云端模型,离线或网络受限场景可用性下降
- 作为较新项目,命令覆盖面和边界场景的稳定性仍待持续打磨
适用场景
- 在终端里忘记某个 git 或系统命令的准确写法,直接用自然语言让 Copilot 给出并解释命令
- 接手陌生仓库时,让 Copilot 结合本地代码回答某模块是做什么的、从哪里改起
- 遇到报错信息,把错误贴进终端让 Copilot 分析原因并给出修复思路
替代项目
aider、open-interpreter、shell-gpt
项目介绍
上一篇:sigil-stitch
下一篇:awesome-copilot
同类项目推荐
bolt.new
开源
想到啥说啥,网页应用当场生成直接能用
Prompt, run, edit, and deploy full-stack web applications. -- bolt.new -- Help Cente···
fuzz4all
开源
用大模型自动生成测试输入,发现各种软件漏洞
️Fuzz4All: Universal Fuzzing with Large Language Models
superpowers-zh
开源
全套 AI 编程神技汉化好了,照着用就行。
AI 编程超能力 · 中文增强版 — superpowers(250k+ ⭐)完整汉化 + 4 个中国原创 skills···
Gitea 代码托管
开源
轻量 Git 代码托管平台
Git with a cup of tea! Painless self-hosted all-in-one software development service,···