#GitHub
#AI
#Copilot
#GPT-5
#Windows

Windows用户,2026从零开始驾驭 GitHub CLI 与 Copilot.md

GitHub CLI

给文科生和小白的 AI 魔法书:从零开始驾驭 GitHub CLI 与 Copilot.md

你看到“命令行、终端、环境变量”这几个词,就开始头皮发麻的话,我太懂了。 很多人不是学不会,是刚点开就被一堆黑话吓退了。

我写这篇,是想把门槛压到最低。 你不需要会编程,不需要懂什么底层,原理也先放一边。 你只要会复制粘贴,会按回车,就够了。

你可以把它当成一张新手通行证。 拿到以后,你就能用中文指挥电脑干活,而且是那种省时间、省心、还很有成就感的活。


你到底在装什么?先把概念捋顺

很多教程最大的问题是:一上来就让你装一堆东西。 装完你还不知道自己装了啥,这会很崩。

我们先用人话说清楚,两个主角是谁。

GitHub CLI 是你的“手”

它的命令是 gh。 你可以理解成:你给电脑装了一只手。

以前你要打开浏览器,点进 GitHub,找按钮,上传文件,新建项目,看消息。 现在你在黑窗口里打一行字,就能完成。 省掉一堆点点点。

你可以拿它做这些事:

  • 把本地文件夹推到 GitHub,当备份。
  • 把别人的项目下载下来研究。
  • 创建和管理仓库、Issue、Pull Request 这些网页上要点半天的东西。

概念图对比

Copilot CLI 是你的“脑”

它是寄生在 gh 里的 AI。 你可以把它想成:你的手旁边站着一个随叫随到的聪明队友。

你不用记命令。 你直接说人话就行。

比如你想压缩图片。 你说:“我想把这个文件夹的图片都压小一点,保持清晰。” 它会把命令给你。 你看着不放心,还能追问:“这句命令每一段是什么意思?”

很多人第一次用上会有种感觉: 原来我不是不会,我只是没人把话翻译成我能懂的样子。


你最容易翻车的地方,我先替你踩掉

有两个坑,特别常见。 我不想你卡在这里,然后怀疑人生。

版本太旧:你装了半天,装了个过去

以前 Copilot 是外挂,要额外装一堆东西。 现在不一样了。 新版本的 GitHub CLI 已经把 Copilot 直接内置了。

你的目标很简单: 装最新版的 gh,就等于“手”和“脑”一起到位。 少走一大圈弯路。

你用错了那个“黑窗口”

Windows 上那两个窗口长得很像:一个偏蓝,一个偏黑。 新手最容易随手点错。

蓝色的那个通常是老版本 PowerShell。 对中文和一些符号不太友好,容易乱码,也容易让 Copilot 体验变差。

旧版和新版终端窗口

我们要用的是 PowerShell 7。 图标更偏黑。 你后面所有操作,都尽量在它里面做,省很多无意义的折腾。


安装这套魔法装备,真的就是复制粘贴

别紧张,我按你能跟着做的方式写。

先装 PowerShell 7

打开 Microsoft Store。 搜索 PowerShell。 认准图标偏黑的那个,安装。

装完以后,你可以在开始菜单里搜 PowerShell。 点开的如果是黑色图标,基本就对了。

你不需要理解它是什么。 你只要把它当作一扇更好用的门。

再装 GitHub CLI

去 GitHub CLI 的 releases 页面下载最新版。 下载那个后缀是 .msi 的 Windows 安装包。 双击,安装过程一路 Next 就行。

装完之后,打开 PowerShell 7,输入:

gh --version

能看到版本号,就说明装好了。 版本越新,越省事。


最关键的一步:让它能稳定连上网

这里我会说得很直白。 因为你只要卡在这一步,你后面就会遇到各种看不懂的报错。

很多人不是不会用。 是 GitHub 的网络访问在你的环境里不太稳定。 表现出来就是:登录失败、模型列表拉不出来、下载卡住。

你要做的是:给它设置代理环境变量,让它知道该从哪里走。

把代理写进 PowerShell 的启动配置

在 PowerShell 7 里复制粘贴这行,回车:

if (!(Test-Path $PROFILE)) { New-Item -Type File -Path $PROFILE -Force }; notepad $PROFILE

它会弹出记事本。 你把下面两行粘进去:

$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"

这里的 7890 是端口号。 很多工具默认是 7890,也有人的会是 10809。 你去你自己的代理软件设置里看一眼,以你那边为准。

粘贴两行代码

保存,关掉记事本。 把 PowerShell 窗口也关掉。 重新打开 PowerShell 7。

这一步的意义是:以后你每次打开 PowerShell,它都会自动带着这两条设置。 你不用每次手动输入。

题外话:你以后如果不想用了,也可以再打开那个文件,把这两行删掉。 不会对电脑造成什么不可逆的影响。


见证奇迹:让 gh 和 Copilot 跑起来

登录 GitHub

在 PowerShell 7 输入:

gh auth login

它会问你一些选项。 常见的选择是:GitHub.com、走 HTTPS、用浏览器登录。

它给你一个验证码。 你复制。 回车后会打开浏览器。 在网页里粘贴验证码,授权。

这个过程像你用微信扫码登录某个网站。 本质是一样的。

唤醒 Copilot

输入:

gh copilot

第一次它可能会问你是否安装 Copilot 相关组件。 你输入 Y,让它装就行。

如果一切顺利,你会看到 GitHub 的字符画。 那种感觉有点像:你第一次把游戏装好,进入主界面。

主界面

新手怎么玩,才会觉得它真的值

这里我不讲大道理。 就讲你今天就能用上的几种方式。

让它全程说中文

你可以在 Copilot 的对话里输入:

/init

它会引导你生成一个偏好配置。 你可以直接写:

“请用中文回答。 我用 Windows。 回复尽量简短。 我会复制你的命令执行,也请告诉我每一步在做什么。”

你别小看这个。 你越会提要求,它越像你的私人助理。 很多人觉得 AI 不好用,其实是没把需求说清楚。

用人话让它给命令

你可以这样问:

“我想把一个文件夹上传到 GitHub 作为备份,要怎么做?” “我下载了一个项目,现在想运行它,你告诉我从哪里开始。” “我遇到报错,我把报错粘给你,你告诉我最可能的问题点在哪里。” “给我一个命令,把这个目录下所有 jpg 改名成时间戳开头。”

你会发现你不再依赖搜索。 因为搜索要筛选广告,要判断真假。 Copilot 更像是把你带到一个能直接干活的答案旁边。

看看它现在用的是哪个模型

在对话里输入:

/model

它会列出可用的模型。 你不需要纠结哪个更高级。 对小白来说:速度快、稳定、输出命令靠谱,就很好用。 你先用默认的。 用顺手了再换。


Copilot.md 是什么?你为什么会需要它

你看到标题里有 Copilot.md,可能会问:这又是啥?

你可以把它理解成:给 AI 的一张说明书。

很多人用 AI 的体验是: 同一个问题问三次,得到三种答案。 不是 AI 变笨了。 是它没拿到你的偏好和上下文。

Copilot.md 这种文件的价值在于: 你把你想要的风格、习惯、项目约定写进去。 它在这个项目里就更像一个懂你的同事。

你可以在里面写这种话:

  • 我不懂术语,请用大白话解释。
  • 我在 Windows 环境下操作。
  • 给命令时请同时解释风险。
  • 不要一次给太多选项,优先给最稳的方案。

它不是必须。 但它很适合那种:你不想每次都重新教育 AI 的人。


你学到的不是命令,而是一种新手也能用的掌控感

你走完这套流程。 表面上是装了 GitHub CLI 和 Copilot。 实际上你获得的是一个更舒服的工作方式。

你以后不必死记硬背命令。 也不用在网页里迷路。 更不需要看见报错就心慌。

你只要记住一个画面: 那个黑窗口里闪烁的光标,是你和电脑对话的入口。 你说人话,它帮你翻译成电脑能执行的话。

如果你愿意。 现在就打开 PowerShell 7。 对它说一句:

“帮我在桌面新建一个文件夹。 再帮我创建一个 GitHub 仓库。 把这个文件夹上传上去。”

你会突然意识到: 原来很多看起来很硬核的东西,只是少了一个愿意把门打开的人。

你也可以把这篇文章转给那个总说自己不适合学技术的朋友。 看他什么时候开始觉得:原来我也能玩得动。 写个贪吃蛇游戏