GitHub Copilot
完全使用指南
一站式掌握 GitHub Copilot 在各类 IDE 中的安装、登录、使用技巧，以及常见问题的排查与解决方案。
Visual Studio Code
推荐安装 VS Code
从 code.visualstudio.com 下载并安装最新版 VS Code（≥ 1.86 版本）。
安装 GitHub Copilot 扩展
打开 VS Code → 侧边栏「扩展」面板（Ctrl+Shift+X）→ 搜索 GitHub Copilot → 点击「安装」。
它会自动安装 GitHub Copilot 和 GitHub Copilot Chat 两个扩展。
登录 GitHub 账号
安装完成后，VS Code 右下角会弹出 "Sign in to GitHub" 提示，点击后浏览器将打开 GitHub 授权页面。
点击 "Authorize Visual-Studio-Code" 完成授权，浏览器会提示回跳到 VS Code。
验证安装是否成功
状态栏（底部）应显示 Copilot 图标 (⊡)。新建一个 .js 文件，输入：
function add(
Copilot 应自动显示灰色建议文字，按 Tab 即可接受。
IntelliJ IDEA / PyCharm / WebStorm / GoLand 等
确保 IDE 版本
JetBrains IDE 需要 2023.1 或更高版本。建议使用 Toolbox App 管理和升级。
安装 Copilot 插件
打开 Settings / Preferences → Plugins → Marketplace，搜索 "GitHub Copilot"，找到官方插件后点击 Install，然后重启 IDE。
登录 GitHub
重启后，底部状态栏会出现 Copilot 图标。
点击图标 → Login to GitHub → 浏览器弹出设备授权页面 → 输入显示的 Device Code → 授权确认。
验证补全
新建任意代码文件，输入注释或函数签名，等待灰色建议文字出现。按 Tab 接受建议。
Visual Studio 2022
版本要求
需要 Visual Studio 2022 17.8 及以上版本。推荐直接升级到最新版。
安装扩展
打开 扩展 → 管理扩展 → 联机，搜索 "GitHub Copilot"，点击下载并安装。
重启 Visual Studio 后扩展生效。
登录 GitHub
菜单栏顶部会出现 Copilot 按钮或状态栏图标，点击后选择 "Sign in with GitHub"。
在弹出的浏览器页面完成授权即可。
启用 Copilot Chat
视图 → GitHub Copilot Chat 打开对话窗口，可直接在 IDE 中向 Copilot 提问。
Neovim
版本要求
Neovim ≥ 0.6.0，需安装 Node.js ≥ 18。
安装 copilot.vim 插件
使用你喜欢的插件管理器。以 lazy.nvim 为例：
或 vim-plug：
登录认证
重启 Neovim 后，运行命令：
终端会输出一个 URL 和设备码，在浏览器中打开并完成授权。
验证状态
输出 "Copilot: Ready" 即为成功。
Xcode（macOS）
安装 Copilot for Xcode 应用
访问 GitHub - CopilotForXcode 仓库，下载最新 release 的 .dmg 或使用 Homebrew：
授权辅助功能权限
系统设置 → 隐私与安全性 → 辅助功能，添加并开启 Copilot for Xcode。
同时在 扩展 → Xcode Source Editor 中启用 Copilot 扩展。
登录 GitHub
打开 Copilot for Xcode 应用 → 点击 Sign In → 完成浏览器授权。
使用
在 Xcode 中编写代码时，Copilot 会以内联建议形式出现。使用 Option + ] 接受建议。
| 功能 | Windows / Linux | macOS |
|---|---|---|
| 接受建议 | Tab | Tab |
| 拒绝建议 | Esc | Esc |
| 下一条建议 | Alt + ] | Option + ] |
| 上一条建议 | Alt + [ | Option + [ |
| 触发内联建议 | Alt + \ | Option + \ |
| 打开 Copilot Chat | Ctrl + Shift + I | ⌘ + Shift + I |
| 内联聊天 (Inline Chat) | Ctrl + I | ⌘ + I |
| 接受部分建议（逐词） | Ctrl + → | ⌘ + → |
#file:xxx 引用文件，@workspace 让 Copilot 搜索整个项目上下文。数据来源：GitHub 官方文档 — Copilot Requests（2026-03）
✅ 包含模型（付费 ×0 / Free ×1）— 不消耗付费用户高级请求
| 模型 | 付费计划倍率 | Free 倍率 | 说明 |
|---|---|---|---|
| GPT-4.1 | ×0 | ×1 | 代码生成和指令遵循能力强，付费用户无限使用 |
| GPT-4o | ×0 | ×1 | 经典多模态模型，支持图片输入，付费用户无限使用 |
| GPT-5 mini | ×0 | ×1 | 轻量高速，日常编码首选，付费用户无限使用 |
| Raptor mini | ×0 | ×1 | 轻量模型，付费用户无限使用 |
🟢 低消耗（×0.25 ~ ×0.33）— 高频使用推荐
| 模型 | 付费计划倍率 | Free 倍率 | 说明 |
|---|---|---|---|
| Grok Code Fast 1 | ×0.25 | ×1 | 速度极快的代码专用模型，低消耗 |
| Claude Haiku 4.5 | ×0.33 | ×1 | 轻量快速，适合简单问答和代码补全 |
| Gemini 3 Flash | ×0.33 | — | 速度极快，大上下文窗口，高频交互理想选择 |
| GPT-5.1-Codex-Mini | ×0.33 | — | Codex 系列轻量版，代码任务性价比高 |
| GPT-5.4 mini | ×0.33 | — | 最新轻量模型，速度与质量兼顾 |
🔵 标准消耗（×1）— 中高复杂度任务
| 模型 | 付费计划倍率 | Free 倍率 | 说明 |
|---|---|---|---|
| Claude Sonnet 4 | ×1 | — | 代码推理能力顶尖，擅长长上下文分析和复杂重构 |
| Claude Sonnet 4.5 | ×1 | — | Sonnet 系列升级版，综合能力进一步提升 |
| Claude Sonnet 4.6 | ×1 | — | Sonnet 最新版（倍率可能调整） |
| Gemini 2.5 Pro | ×1 | — | 超大上下文窗口，多模态旗舰 |
| Gemini 3 Pro | ×1 | — | Gemini 3 代旗舰 |
| Gemini 3.1 Pro | ×1 | — | Gemini 最新旗舰，能力全面增强 |
| GPT-5.1 | ×1 | — | GPT-5 系列升级版 |
| GPT-5.1-Codex | ×1 | — | 专为代码优化的 Codex 模型 |
| GPT-5.1-Codex-Max | ×1 | — | Codex 增强版，适合大规模代码生成 |
| GPT-5.2 | ×1 | — | 更新的 GPT-5 系列模型 |
| GPT-5.2-Codex | ×1 | — | GPT-5.2 代码专用版本 |
| GPT-5.3-Codex | ×1 | — | GPT-5.3 代码专用版本 |
| GPT-5.4 | ×1 | — | GPT-5 系列最新版 |
🟡 高消耗（×3）— 深度推理，按需使用
| 模型 | 付费计划倍率 | Free 倍率 | 说明 |
|---|---|---|---|
| Claude Opus 4.5 | ×3 | — | Opus 系列高能力模型，适合架构设计与复杂重构 |
| Claude Opus 4.6 | ×3 | — | Opus 最新版，综合能力最强 |
🔴 超高消耗（×30）— 仅限关键复杂任务
| 模型 | 付费计划倍率 | Free 倍率 | 说明 |
|---|---|---|---|
| Claude Opus 4.6 (fast mode) Preview | ×30 | — | 快速模式 Opus 4.6，单次消耗巨大，请慎用 |
• 付费计划（Pro / Pro+ / Business / Enterprise）：GPT-4.1、GPT-4o、GPT-5 mini 为包含模型（×0），不消耗高级请求，额度用尽后仍可无限使用
• Free 计划：每月 2,000 次内联补全 + 50 次高级请求，所有 Chat 交互均计为高级请求（每次 ×1）
• 前往 GitHub Settings → Copilot 查看当月用量
1. 日常编码优先使用 包含模型（GPT-4.1 / GPT-4o / GPT-5 mini），付费用户完全免费
2. 需要更强能力时选择 ×0.33 的低消耗模型（Claude Haiku 4.5 / Gemini 3 Flash）
3. 在 VS Code 中开启 Auto Model Selection 可额外享受 10% 倍率折扣
4. Claude Opus 4.6 fast mode（×30）单次消耗巨大，请慎用
5. 代码补全（内联建议）使用包含模型时不消耗高级请求
点击登录后浏览器无反应 / 页面打不开
通常由默认浏览器设置或防火墙导致。
2. 手动复制终端/输出面板中显示的授权 URL，粘贴到浏览器地址栏
3. 检查是否有公司防火墙阻止了
github.com 域名4. 尝试使用隐私/无痕模式打开授权链接
登录成功但过一段时间后需要重新登录
Token 过期或凭据存储异常。
2. 检查系统密钥链/凭据管理器是否正常运行
3. Windows 用户：控制面板 → 凭据管理器 → Windows 凭据，删除
github.com 相关条目后重新登录4. 确保 VS Code 更新到最新版本
Device Code 输入后提示授权失败
Device Code 有效期约 15 分钟，超时后需重新获取。
2. 确保在正确的浏览器中登录了目标 GitHub 账号
3. 如果浏览器有多个 GitHub 账号登录，先注销其他账号
4. 尝试使用隐私模式浏览器以避免缓存干扰
Copilot 完全没有提供代码建议
2. 确认当前文件语言不在 Copilot 的禁用列表中：Settings → 搜索 "copilot enable" 检查语言开关
3. 命令面板 → "GitHub Copilot: Status" 检查连接状态
4. 尝试 "Developer: Reload Window" 重新加载窗口
5. 检查是否有其他补全类扩展（如 TabNine、Kite）产生冲突，建议禁用后测试
建议质量差 / 不相关 / 总是重复
建议质量与上下文密切相关。
2. 使用有意义的变量名和函数名
3. 打开相关的类型定义文件、接口文件，为 Copilot 提供更多上下文
4. 按 Alt+] 查看备选建议
5. 尝试修改注释/函数签名后重新触发建议（Alt+\）
建议延迟很高，响应慢
2. 如果使用代理/VPN，参见下方「网络 & 代理问题」部分
3. 关闭不必要的扩展，减少编辑器资源占用
4. 确认文件不是超大文件（>10000行的文件可能导致延迟）
5. 尝试重启编辑器
Copilot Chat 返回 "I'm sorry, I can't assist with that"
这是 Copilot 的内容安全策略触发的拒绝响应。
2. 将问题拆分为更小的技术性问题
3. 确保问题与编程/技术相关
4. 如果是正常技术问题被误判，可以通过 Copilot 反馈功能报告
开发工具无法连接 GitHub / Copilot 服务（代理软件配置）
开发工具（VS Code / JetBrains 等）默认不走系统代理，需要手动配置 HTTP 代理或开启 TUN 模式。
1. 查看代理软件的 HTTP 协议监听端口：
7890）② 通过系统命令查看：如果代理软件未标明端口，可在终端中查询：
powershell → 回车；或在开始菜单搜索「PowerShell」
Get-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings" | Select-Object ProxyServer
echo $http_proxy $https_proxy
http://127.0.0.1:7890 — 其中 7890 即为代理端口http.proxy3. JetBrains 配置：Settings → Appearance & Behavior → System Settings → HTTP Proxy
4. 保存后重启开发工具，重新登录 Copilot
方法二：开启代理软件的 TUN 模式
1. 在代理软件中找到 TUN 模式（也叫"虚拟网卡模式"或"增强模式"）并开启
2. TUN 模式会接管系统所有流量（包括开发工具），无需在 IDE 中单独配置代理
3. 开启后重启开发工具即可生效
⚠️ 注意：推荐优先使用方法一（HTTP 代理），更精准且不影响其他应用。TUN 模式会代理所有流量，可能影响局域网访问。
Claude 模型没有加载出来 / 模型列表中看不到 Claude
Claude 系列模型（Sonnet、Opus 等）在 Copilot Chat 模型选择器中未显示或加载失败。
这是网络/地区问题。Claude 模型由 Anthropic 提供，其请求需要通过 GitHub Copilot 服务端中转，而该服务端位于海外。如果你所在地区的网络无法直连或连接不稳定（如中国大陆等地区），模型列表将无法完整加载，Claude 系列会缺失或显示加载失败。
✅ 解决方法：
1. 配置网络代理（推荐） — 开发工具（VS Code / JetBrains）默认不走系统代理，需要手动配置 HTTP 代理或开启 TUN 模式：
2. 配置完代理后，重启开发工具，重新打开 Copilot Chat，模型列表应恢复正常
3. 尝试在 VS Code 命令面板（Ctrl+Shift+P）中执行 "Developer: Reload Window" 刷新窗口
4. 如果某个 Claude 模型显示为灰色或不可选，确认你的 Copilot 计划是否支持该模型（Free 用户可用模型有限，参见上方模型倍率表）
Chat took too long to get ready — Chat 初始化超时
VS Code 中 Copilot Chat 面板显示黄色警告：
⚠ Chat took too long to get ready. Please ensure you are signed in to GitHub and that the extension GitHub.copilot-chat is installed and enabled.
② 网络连接超时 — Copilot Chat 启动时需要连接 GitHub 服务端完成初始化。如果你在中国大陆等地区，网络无法直连 GitHub 服务，初始化会超时
步骤一：退出登录并通过 Chat 面板重新登录（核心解决方案）
第 1 步：退出当前 GitHub 账号