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

给文科生和小白的 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 仓库。 把这个文件夹上传上去。”
你会突然意识到: 原来很多看起来很硬核的东西,只是少了一个愿意把门打开的人。
你也可以把这篇文章转给那个总说自己不适合学技术的朋友。
看他什么时候开始觉得:原来我也能玩得动。

