Copilot CLI 认证失败时别慌——先看错误信息，对应下面的场景逐步排查：未登录、Token 过期、用了 Classic Token（不支持）、组织策略限制，还是 Linux 上缺 libsecret？每种情况都有明确的修复步骤。

GitHub Copilot CLI 认证排查：常见登录错误与修复方法

快速诊断

遇到认证错误，先检查：

# 1. 检查 GitHub CLI 认证状态
gh auth status

# 2. 检查是否设置了环境变量
echo $COPILOT_GITHUB_TOKEN

# 3. 检查 Copilot CLI 版本
copilot --version

---

错误：未找到认证信息

Error: No authentication information found

原因：没有任何凭证（未登录、环境变量未设置、Keychain 没有记录）。

修复：

# 方式一：通过 Copilot CLI 登录
copilot login

# 方式二：通过 GitHub CLI 登录
gh auth login

# 方式三：设置 Token 环境变量
export COPILOT_GITHUB_TOKEN=your-fine-grained-token

---

错误：Token 过期或被撤销

Error: Authentication failed
Your GitHub token may be invalid, expired, or lacking the required permissions.

修复：

1. 进入 GitHub 账号设置 → Developer settings → Personal access tokens
2. 检查 Token 是否过期，重新生成
3. 确认 Token 有 Copilot Requests 权限
4. 更新环境变量或重新登录

---

错误：Classic Token 被拒绝

以 ghp_ 开头的 Classic Token 不被支持。

修复：创建**细粒度 Personal Access Token（Fine-grained PAT）**替代 Classic Token，并授予 Copilot Requests 权限。

---

错误：访问被策略拒绝

Error: Access denied by policy settings

或 HTTP 403。

原因：

• 没有 GitHub Copilot 席位
• 所属组织的 Copilot 策略禁用了 CLI
• 企业策略设置为"Disabled everywhere"

修复：

1. 确认账号已分配 Copilot 席位
2. 联系组织管理员确认 Copilot CLI 策略是否开启
3. 如是企业账号，联系企业管理员检查 AI Controls 设置

---

错误：系统 Keychain 不可用

System keychain unavailable. Store token in plaintext config file? (y/N)

macOS：检查 Keychain Access 应用是否正常，或选择 y 改为明文存储。

Windows：检查 Windows 凭据管理器（Credential Manager）是否正常。

Linux（最常见）：需要安装 libsecret：

sudo apt install libsecret-1-0 gnome-keyring seahorse

安装后重启会话再试。如果仍无法使用 Keychain，可以选择 y 接受明文存储（注意 Token 会以纯文本保存在配置文件中）。

---

错误：登录账号不对（多账号场景）

检查当前登录账号：

# 在 Copilot CLI 中
/user

切换账号：

# 方式一：会话中切换
/user switch

# 方式二：登出后重新登录
/logout
/login

# 方式三：检查环境变量是否覆盖了账号
echo $COPILOT_GITHUB_TOKEN

---

macOS 清除旧 Keychain 记录

如果 macOS Keychain 中有旧的 Copilot CLI 凭证导致认证失败：

# 查找
security find-generic-password -s copilot-cli

# 删除
security delete-generic-password -s copilot-cli

删除后重新运行 copilot login。

---

常见问题

Q: 在 CI/CD 中怎么认证？

A: 通过 COPILOT_GITHUB_TOKEN 环境变量传入 Fine-grained PAT，不要在脚本中交互式登录。参见 CLI 自动化 GitHub Actions 指南。

Q: 认证成功但功能有限，可能是什么问题？

A: 检查 Token 的权限范围——只有 Fine-grained PAT 并且包含 Copilot Requests 权限才能使用完整功能。Classic Token 或权限不足的 Token 可能部分功能可用，部分功能报错。