🚀 快速开始
⚠️ 安装前准备
在安装 Copilot CLI 之前,请确保您的系统已满足以下要求:
- 已安装 Node.js 16+ 或 GitHub CLI
- 拥有有效的 GitHub Copilot 订阅
- 具备基本的命令行操作能力
✅ 一键安装命令
如果您已满足上述要求,可以直接使用以下命令安装:
# 使用 npm 安装(推荐)
npm install -g @githubnext/github-copilot-cli
# 或使用 GitHub CLI 扩展
gh extension install github/gh-copilot
📋 详细安装步骤
1
安装 GitHub CLI
Windows 系统需要先安装 GitHub CLI:
# 使用 Chocolatey 安装
choco install gh
# 或使用 Scoop 安装
scoop install gh
# 或从官网下载安装包
# https://cli.github.com/manual/installation
验证安装:
gh --version
2
安装 Copilot CLI
# 方法一:使用 npm 安装
npm install -g @githubnext/github-copilot-cli
# 方法二:使用 GitHub CLI 扩展
gh extension install github/gh-copilot
权限问题
如果遇到权限错误,请以管理员身份运行命令提示符。
3
认证 GitHub Copilot
# 登录 GitHub
gh auth login
# 认证 Copilot
gh copilot auth
1
安装 GitHub CLI
macOS 用户可以使用 Homebrew 安装:
# 使用 Homebrew 安装
brew install gh
验证安装:
gh --version
2
安装 Copilot CLI
# 方法一:使用 npm 安装
npm install -g @githubnext/github-copilot-cli
# 方法二:使用 GitHub CLI 扩展
gh extension install github/gh-copilot
如果遇到权限问题,使用 sudo:
sudo npm install -g @githubnext/github-copilot-cli
3
认证 GitHub Copilot
# 登录 GitHub
gh auth login
# 认证 Copilot
gh copilot auth
1
安装 GitHub CLI
使用包管理器安装 GitHub CLI:
# Ubuntu/Debian
sudo apt install gh
# CentOS/RHEL
sudo dnf install gh
# Arch Linux
sudo pacman -S github-cli
2
安装 Copilot CLI
# 方法一:使用 npm 安装
npm install -g @githubnext/github-copilot-cli
# 方法二:使用 GitHub CLI 扩展
gh extension install github/gh-copilot
3
认证 GitHub Copilot
# 登录 GitHub
gh auth login
# 认证 Copilot
gh copilot auth
✅ 验证安装
测试 Copilot CLI
运行以下命令验证安装是否成功:
# 检查 Copilot 状态
gh copilot status
# 测试代码生成
gh copilot suggest "创建一个简单的 Python Hello World 程序"
成功标志
如果您看到 Copilot 的代码建议或状态信息,说明安装配置成功!
❓ 常见问题解答
如何获取 GitHub Copilot 订阅?
+
安装时出现权限错误怎么办?
+
Windows:以管理员身份运行命令提示符
macOS/Linux:使用 sudo 命令或配置用户环境
# 配置 npm 用户安装
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
Copilot CLI 有哪些常用命令?
+
# 检查状态
gh copilot status
# 生成代码建议
gh copilot suggest "你的需求描述"
# 解释代码
gh copilot explain "代码内容"
# 重构代码
gh copilot refactor "文件路径"
如何更新 Copilot CLI?
+
# 更新 npm 版本
npm update -g @githubnext/github-copilot-cli
# 更新 GitHub CLI 扩展
gh extension upgrade github/gh-copilot
Copilot CLI 与 VS Code Copilot 有什么区别?
+
Copilot CLI:
- 命令行界面,适合终端用户
- 可以集成到脚本和自动化流程
- 支持批量处理和管道操作
VS Code Copilot:
- 图形界面,集成在编辑器中
- 实时代码补全和建议
- 更适合日常编码工作