关于 GitHub Copilot CLI
GitHub Copilot CLI 是一个命令行编码 Agent,能够理解仓库结构和代码上下文。它支持自然语言指令来规划、编辑、运行和审查代码变更。
主要功能
- 01用自然语言指令规划和执行代码变更
- 02访问仓库内容,进行上下文感知的编码建议
- 03运行命令并评审代码修改
适用场景
- 01Agent 需要理解整个仓库结构来执行复杂的编码任务
- 02快速审查和测试代码变更
- 03通过自然语言对话完成多步骤的开发工作流
安装
选择你的系统或包管理器,复制命令到终端运行。
安装完成后运行copilot --version确认安装成功。
命令示例
常用命令按使用顺序排列。
详细介绍
GitHub Copilot CLI
GitHub Copilot 的强大功能,现在可在终端中使用。
GitHub Copilot CLI 将 AI 驱动的编码辅助直接带到命令行,让你通过自然语言对话来构建、调试和理解代码。它由 GitHub Copilot 编码 Agent 使用的同一 Agent 驱动框架提供支持,在提供智能辅助的同时,与你的 GitHub 工作流深度集成。
如需了解更多信息,请参阅我们的官方文档。
🚀 简介与概览
我们将 GitHub Copilot 编码 Agent 的强大功能直接带到你的终端。借助 GitHub Copilot CLI,你可以在本地与 AI Agent 同步协作,该 Agent 能够理解你的代码和 GitHub 上下文。
- 原生终端开发: 在命令行中直接使用 Copilot 编码 Agent,无需切换上下文。
- 开箱即用的 GitHub 集成: 使用自然语言访问你的仓库、议题和拉取请求,所有操作均通过你现有的 GitHub 帐户进行身份验证。
- Agent 能力: 与能够规划并执行复杂任务的 AI 协作者一起构建、编辑、调试和重构代码。
- 由 MCP 驱动的可扩展性: 编码 Agent 默认附带 GitHub 的 MCP 服务,并支持自定义 MCP 服务,可借此扩展功能。
- 完全掌控: 执行前预览每项操作;未经你明确批准,不会执行任何操作。
我们的旅程才刚刚开始,但有了你的反馈,我们正在快速迭代,力求让 GitHub Copilot CLI 成为你在终端中的最佳伙伴。
📦 开始使用
支持的平台
- Linux
- macOS
- Windows
前提条件
- (在 Windows 上)PowerShell v6 或更高版本
- 有效的 Copilot 订阅。请参阅 Copilot 计划。
如果你通过组织或企业使用 GitHub Copilot,那么如果组织所有者或企业管理员已在组织或企业设置中将其禁用,你将无法使用 GitHub Copilot CLI。如需了解更多信息,请参阅管理组织的 GitHub Copilot 策略和功能。
安装
使用安装脚本安装(macOS 和 Linux):
curl -fsSL https://gh.io/copilot-install | bash
或者
wget -qO- https://gh.io/copilot-install | bash
使用 | sudo bash 以 root 身份运行,并安装到 /usr/local/bin。
将 PREFIX 设置为安装到 $PREFIX/bin/ 目录。以 root 身份运行时,默认值为 /usr/local;以非 root 用户身份运行时,默认值为 $HOME/.local。
设置 VERSION 以安装特定版本。默认安装最新版本。
例如,将版本 v0.0.369 安装到自定义目录:
curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.369" PREFIX="$HOME/custom" bash
使用 Homebrew 安装(macOS 和 Linux):
brew install copilot-cli
brew install copilot-cli@prerelease
使用 WinGet 安装(Windows):
winget install GitHub.Copilot
winget install GitHub.Copilot.Prerelease
使用 npm 安装(macOS、Linux 和 Windows):
npm install -g @github/copilot
npm install -g @github/copilot@prerelease
启动 CLI
copilot
首次启动时,你会看到我们可爱的动画横幅!如需再次查看此横幅,请使用 --banner 标志启动 copilot。
如果你当前尚未登录 GitHub,系统会提示你使用 /login 斜杠命令。输入此命令并按照屏幕上的说明完成身份验证。
使用个人访问令牌(PAT)进行身份验证
你也可以使用启用了“Copilot Requests”权限的细粒度 PAT 进行身份验证。
- 访问 https://github.com/settings/personal-access-tokens/new
- 在“Permissions”下,点击“add permissions”,然后选择“Copilot Requests”
- 生成令牌
- 通过环境变量
GH_TOKEN或GITHUB_TOKEN(按优先级顺序)将令牌添加到环境中
使用命令行
在包含你想要处理的代码的文件夹中启动 copilot。
默认情况下,copilot 使用 Claude Sonnet 4.5。运行 /model 斜杠命令,从其他可用模型中进行选择,包括 Claude Sonnet 4 和 GPT-5。
实验模式
实验模式可让你使用仍在开发中的新功能。你可以通过以下方式启用实验模式:
- 使用
--experimental标志启动:copilot --experimental - 在命令行中使用
/experimental斜杠命令
启用后,该设置会保存在配置中,因此后续启动时无需再使用 --experimental 标志。
实验性功能
- Autopilot 模式: Autopilot 是一种新模式(按
Shift+Tab可循环切换模式),可促使 Agent 持续工作,直到完成任务。
每次向 GitHub Copilot CLI 提交提示词时,你的每月高级请求配额都会减少一次。有关高级请求的信息,请参阅关于高级请求。
有关如何使用 GitHub Copilot CLI 的更多信息,请参阅我们的官方文档。
🔧 配置 LSP 服务
GitHub Copilot CLI 支持语言服务器协议(LSP),以增强代码智能。此功能可提供跳转到定义、悬停信息和诊断等智能代码功能。
安装语言服务器
Copilot CLI 不会捆绑 LSP 服务。你需要单独安装。例如,要设置 TypeScript 支持:
npm install -g typescript-language-server
对于其他语言,请安装相应的 LSP 服务,并按照下方所示的相同模式进行配置。
配置 LSP 服务
LSP 服务通过专用的 LSP 配置文件进行配置。你可以在用户级别或仓库级别配置 LSP 服务:
用户级配置(适用于所有项目):
编辑 ~/.copilot/lsp-config.json
仓库级配置(适用于特定项目):
在仓库根目录中创建 .github/lsp.json
配置示例:
{
"lspServers": {
"typescript": {
"command": "typescript-language-server",
"args": ["--stdio"],
"fileExtensions": {
".ts": "typescript",
".tsx": "typescript"
}
}
}
}
查看 LSP 服务状态
在交互式会话中使用 /lsp 命令检查已配置的 LSP 服务,或直接查看配置文件。
更多信息请参阅更新日志。
📢 反馈与参与
我们很高兴你能在 Copilot CLI 发展初期加入我们。
我们正在快速迭代。请期待频繁更新——为获取最新功能和修复,请保持客户端为最新版本!
你的见解至关重要!请在此仓库中提交问题、参与 Discussions,并在命令行中运行 /feedback,提交保密反馈调查!