安装与快速入门¶

本文你会学到：

• 📦 如何安装和认证 Copilot CLI
• 💻 交互式会话的基本操作（启动、退出、快捷键）
• ✨ @ 和 / 等输入前缀的含义
• ⌨️ 最常用的斜杠命令

如果你已经有使用经验，可以直接跳到需要的部分。

📦 安装¶

1
2
3
4
5

# 安装稳定版
npm install -g @github/copilot

# 安装预发布版本（获取最新功能）
npm install -g @github/copilot@prerelease

1

brew install gh-copilot

1

winget install GitHub.CopilotCLI

1
2
3
4
5

# macOS / Linux
curl -fsSL https://cli.github.com/copilot/install.sh | sh

# Windows（PowerShell）
irm https://cli.github.com/copilot/install.ps1 | iex

安装补充¶

除了上述包管理器，Copilot CLI 还提供以下安装方式：

1
2
3
4
5

# VERSION 指定安装版本，PREFIX 自定义安装目录
curl -fsSL https://gh.io/copilot-install | VERSION="v0.0.369" PREFIX="$HOME/custom" bash

# 以 root 身份安装到 /usr/local/bin
curl -fsSL https://gh.io/copilot-install | sudo bash

1

npm_config_ignore_scripts=false npm install -g @github/copilot

更新¶

1
2
3
4
5

# npm 更新
npm update -g @github/copilot

# 检查当前版本
copilot --version

Shell 补全¶

1.0.37 新增 copilot completion 子命令，可生成静态 Shell 补全脚本，让你在终端中输入 copilot 命令时自动提示子命令和参数：

1
2
3
4
5
6
7
8

# 生成 Bash 补全脚本
copilot completion bash

# 生成 Zsh 补全脚本
copilot completion zsh

# 生成 Fish 补全脚本
copilot completion fish

生成的脚本需要写入 Shell 的补全目录（如 Bash 的 /etc/bash_completion.d/），或通过 source 加载到当前会话中。

🔑 认证¶

首次使用需要通过 GitHub 账号认证。这就像给你的实习生办工牌——没有工牌他进不了办公室。

1
2
3
4
5

# 启动认证流程（会在浏览器中打开 GitHub 授权页面）
copilot auth

# 验证认证状态
copilot auth status

认证方式详解¶

Copilot CLI 支持三种认证方式，按优先级从高到低排列：

OAuth 设备流（默认，推荐交互式使用）

在 CLI 中执行 /login 或在终端执行 copilot login，CLI 生成一次性验证码并自动复制到剪贴板、打开浏览器：

1
2
3

Waiting for authorization...
Enter one-time code: 1234-5678 at https://github.com/login/device
Press any key to copy to clipboard and open browser...

1. 在浏览器中访问 https://github.com/login/device
2. 输入终端显示的一次性验证码
3. 如组织使用 SAML SSO，点击对应组织的 Authorize
4. 审查权限请求后点击 Authorize GitHub Copilot CLI
5. 返回终端，CLI 显示 Signed in successfully as <username>

1

copilot login --host HOSTNAME

环境变量（推荐 CI/CD 和非交互式环境）

通过环境变量传入支持的 Token，CLI 按以下优先级查找：

支持 Fine-grained PAT（github_pat_ 前缀）和 GitHub App user-to-server Token（ghu_ 前缀）。Fine-grained PAT 需要在个人账户下创建（不能选择组织），并开启 Account → Copilot Requests 权限。

GitHub CLI 回退认证

如果已安装并认证了 GitHub CLI（gh），Copilot CLI 在未找到其他凭据时会自动使用 gh auth token 作为回退。这是最低优先级的认证方式。

多账户管理¶

Copilot CLI 支持同时登录多个账户并自由切换：

1
2
3
4
5
6
7
8

# 在 CLI 内查看当前账户
/user

# 列出所有已登录账户
/user list

# 切换到其他账户
/user switch

添加新账户可通过在终端执行 copilot login 或在 CLI 内执行 /login 并使用另一个账户授权。CLI 会记住最后使用的账户，下次启动时自动切换。

Token 存储¶

认证成功后，Token 默认存储在操作系统的安全存储中：

如果系统密钥链不可用（如无 libsecret 的无头 Linux 服务器），CLI 会提示将 Token 存储到明文文件 ~/.copilot/config.json。

注销和撤销：

• /logout：移除本地存储的 Token，但不会在 GitHub 端撤销
• 彻底撤销：前往 GitHub Settings → Applications → Authorized OAuth Apps，找到 Copilot CLI 并点击 Revoke

配置目录¶

Copilot CLI 的配置文件存放在以下目录：

• macOS / Linux：~/.copilot/
• Windows：$HOME\.copilot\

可通过 COPILOT_HOME 环境变量改变配置目录的位置。

未认证使用¶

如果使用自带 LLM API Key（BYOK 模式），GitHub 认证**不是必需的**——Copilot CLI 可以直接连接你配置的 LLM 提供商，无需 GitHub 账号或 Token。

但未认证时以下功能不可用：/delegate（需要 Copilot 云端 Agent）、GitHub MCP 服务器、GitHub Code Search。

你也可以混合使用 BYOK 和 GitHub 认证，同时享受自定义模型和 GitHub 托管功能。

💻 启动与退出¶

安装完成后，只需在终端输入 copilot 即可启动交互式会话——就像打开一个聊天窗口，你和 AI 之间通过自然语言对话来完成任务。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 启动交互式会话
copilot

# 启动并恢复上次会话
copilot --resume

# 非交互式执行单条指令（Programmatic 模式）
copilot -p "解释这段代码的作用"

# 退出会话
/exit

⌨️ 快捷键¶

熟练使用快捷键能大幅提升交互效率。Shift+Tab 是最常用的——它让你在不同模式间快速切换，后面「交互模式」会详细介绍。

✨ 输入前缀¶

在 Copilot CLI 中，输入内容的第一个字符决定了它的含义——这就像命令行的"万能遥控器"，不同按键触发不同功能。

📋 常用斜杠命令速查¶

斜杠命令（以 / 开头）是 Copilot CLI 的内置指令，类似于聊天应用中的"快捷操作按钮"。以下是按使用频率分组的最常用命令。

斜杠命令现在支持参数和子命令的 Tab 补全（1.0.35 新增），输入 / 后按 Tab 可查看可用参数，减少记忆负担。1.0.39 进一步改进了参数选择器的响应速度——当你输入到精确的命令边界时，选择器会立即弹出，不再需要额外输入尾随空格。

通用命令¶

模式与权限¶

开发相关¶

扩展管理¶

✅ 验证安装¶

安装完成后，运行以下命令验证一切正常：

1
2
3
4
5
6
7
8

# 检查版本
copilot --version

# 检查认证状态
copilot auth status

# 启动一次简单对话测试
copilot -p "你好，请用一句话介绍你自己"

如果都能正确输出，说明安装和认证成功。