从安装到实战，带你上手 GitHub Copilot CLI，在终端里用自然语言写代码、改 bug、理解项目。
GitHub Copilot CLI 是 GitHub 官方出品的终端 AI 编程工具。它把 Copilot 编程代理的能力直接搬到了命令行里，你可以在终端里用自然语言和 AI 对话，让它帮你构建、调试、理解代码。这篇教程从安装开始，带你一步步上手。
这个工具适合两类人：一是日常工作离不开终端的开发者，二是在不切换窗口的情况下获得 AI 辅助的人。它和 GitHub 账号深度绑定，可以直接访问你的仓库、issue 和 pull request。
Copilot CLI 有几个特点：
终端原生。不用在浏览器和终端之间来回切换，直接在命令行里和 AI 协作。
GitHub 集成开箱即用。用现有 GitHub 账号登录后，就能用自然语言操作仓库、issue、PR。
代理式能力。AI 不只是回答问题，还能规划并执行复杂的编码任务，比如重构、调试。
MCP 可扩展。内置 GitHub 的 MCP 服务器，也支持自定义 MCP 服务器来扩展能力。
完全可控。每一步操作都会先预览，没有你的明确批准，什么都不会执行。
Linux、macOS、Windows 都支持。Windows 上需要 PowerShell v6 或更高版本。
需要一个有效的 Copilot 订阅。如果你是通过组织或企业获得 Copilot 权限的，需要确认组织管理员没有在组织设置里禁用 Copilot CLI。
macOS 和 Linux 可以用官方安装脚本：
curl -fsSL https://gh.io/copilot-install | bash或者用 wget：
wget -qO- https://gh.io/copilot-install | bash脚本默认行为：
以 root 身份运行（加 sudo）时，安装到 /usr/local/bin
以普通用户运行时，安装到 $HOME/.local/bin
可以通过 PREFIX 环境变量指定安装目录
可以通过 VERSION 环境变量指定安装版本
例如，安装 v0.0.369 到自定义目录：
curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.369" PREFIX="$HOME/custom" bashmacOS 用户也可以用 Homebrew：
brew install copilot-cli想提前体验预发布版本：
brew install copilot-cli@prereleaseWindows 用户用 WinGet：
winget install GitHub.Copilot预发布版本：
winget install GitHub.Copilot.Prerelease三个平台都支持 npm 安装：
npm install -g @github/copilot安装完成后，在项目目录里运行：
copilot第一次启动会看到动画横幅。如果还没登录 GitHub，会提示你使用 /login 命令，按屏幕提示完成认证即可。之后想重新看横幅，可以用 --banner 参数启动。
除了交互式登录，也支持用个人访问令牌（PAT）认证：
打开 https://github.com/settings/personal-access-tokens/new
在 Permissions 区域点击 "add permissions"，选择 "Copilot Requests"
生成令牌
把令牌设置到环境变量 GH_TOKEN 或 GITHUB_TOKEN，前者优先级更高
假设你有一个 Python 项目，想快速验证 Copilot CLI 能不能用。
进入项目目录，启动：
cd ~/my-python-project
copilot启动后，在交互界面里输入一个简单的请求：
帮我看看这个项目的入口文件在哪里，主要模块是怎么组织的Copilot CLI 会结合本地代码和 GitHub 上下文来回答。因为所有操作都需要你确认，第一次使用可以放心尝试，它不会擅自改动任何文件。
再试一个带实际操作的任务：
把 utils.py 里的日期解析函数重构一下，拆成两个更小的函数它会先展示计划，列出将要修改的文件和具体改动，等你确认后才执行。这个「先预览、后执行」的机制是 Copilot CLI 的核心设计，用起来比较安心。
Copilot CLI 默认使用 Claude Sonnet 4.5。在交互界面输入 /model，可以切换到其他可用模型，包括 Claude Sonnet 4 和 GPT-5。
输入 /lsp 可以查看已配置的 LSP 服务器运行状态。
输入 /feedback 可以提交匿名反馈，帮助官方改进工具。
copilot --banner实验模式可以提前体验还在开发中的新功能。两种开启方式：
copilot --experimental或者在 CLI 里输入 /experimental。开启后设置会持久化到配置文件，之后启动不需要再加参数。
Autopilot 是实验模式下的一个新模式，按 Shift+Tab 可以循环切换模式。它和普通模式的区别在于，Autopilot 会持续工作直到任务完成，适合把一个大任务交给它自己推进，你只需要在关键节点确认操作。
LSP（Language Server Protocol）是语言服务器协议，能提供跳转定义、悬停信息、诊断等代码智能功能。Copilot CLI 不自带 LSP 服务器，需要自己安装。
以 TypeScript 为例，先安装语言服务器：
npm install -g typescript-language-server然后在配置文件里声明。用户级配置对所有项目生效，编辑 ~/.copilot/lsp-config.json。仓库级配置只对当前项目生效，在仓库根目录创建 .github/lsp.json。
配置示例：
{
"lspServers": {
"typescript": {
"command": "typescript-language-server",
"args": ["--stdio"],
"fileExtensions": {
".ts": "typescript",
".tsx": "typescript"
}
}
}
}其他语言按同样的模式安装对应的 LSP 服务器并配置即可。
每次向 Copilot CLI 提交提示词，都会消耗一次 premium requests 月度配额。配额的具体计算方式见官方文档「About premium requests」。
接手一个不熟悉的 Node.js 仓库，第一件事是搞清楚项目结构。进入项目目录启动 copilot，直接问：
这个项目的入口文件是哪个？路由是怎么组织的？数据库用的是什么？Copilot CLI 会结合本地代码和 GitHub 上下文给出回答。相比自己翻代码，这种方式能省不少时间。
假设线上反馈「用户登录后跳转到了错误页面」。在项目目录里启动 copilot，描述问题：
用户登录成功后应该跳转到 /dashboard，但实际跳到了 /home，帮我查一下原因它会分析相关代码，定位可能的问题点，给出修改建议。确认后执行修改，改完可以继续追问：
这个改动会不会影响其他调用方？开启实验模式后，切到 Autopilot 模式，给它一个明确的任务：
把 src/ 目录下所有回调风格的异步代码改成 async/awaitAutopilot 会持续工作，逐个文件处理，直到任务完成。你只需要在它请求确认时审核操作。
现象：运行 /login 完成认证后，使用时报错说没有 Copilot 权限。
解决：确认你的 GitHub 账号有有效的 Copilot 订阅。如果是组织提供的权限，联系组织管理员确认没有在组织或企业设置里禁用 Copilot CLI。
现象：PowerShell 运行 copilot 报错，或者提示版本不支持。
解决：确认 PowerShell 版本是 v6 或更高。可以在 PowerShell 里运行 $PSVersionTable.PSVersion 查看版本号。
现象：提交提示词后，返回配额不足的错误。
解决：查看官方文档「About premium requests」了解配额计算方式。配额按月重置，也可以考虑升级订阅计划。
现象：按文档配置了 lsp-config.json，但代码智能功能没有出现。
解决：先确认 LSP 服务器本身安装成功，比如 typescript-language-server --version 能正常输出。再检查配置文件路径是否正确，用户级配置是 ~/.copilot/lsp-config.json，仓库级配置是 .github/lsp.json。最后在 CLI 里输入 /lsp 查看服务器状态。
现象：官方文档提到的功能在自己机器上找不到。
解决：Copilot CLI 迭代很快，建议保持客户端更新。用安装时的方式重新安装一次，或者用 npm update -g @github/copilot（如果用的是 npm 安装）。
Copilot CLI 把 AI 编程助手直接放进了终端，和 GitHub 工作流深度集成。安装方式覆盖了主流平台，登录认证也支持交互式和 PAT 两种方式。日常使用中，/model 切换模型、实验模式、LSP 配置这几个功能值得花时间熟悉。
下一步建议：找一个你手头的小项目，进入目录运行 copilot，先让它解释项目结构，再让它完成一个小重构。跑通一次完整流程后，再开启实验模式试试 Autopilot。
评论 (0)
暂无评论，来发表第一条评论吧