Windows Terminal + GitHub Copilot + DeepSeek 配置指南
让你的命令行变身 AI 编程助手!
第一步:安装 Windows Terminal
一个更好看、更好用的命令行工具,代替丑丑的 CMD。
去 GitHub Release 页面下载:
- 打开 https://github.com/microsoft/terminal/releases
- 找到最新的版本(第一个就是),往下翻到 Assets
- 下载
Microsoft.WindowsTerminal_版本号_x64.msixbundle(选 x86_64 版本) - 双击安装,一路下一步
注意:不要下载 arm64 版本,除非你是 ARM 架构的电脑(Surface Pro X 那种)。
验证:按 Win + R,输入 wt 回车,能打开就 OK!
第二步:安装 GitHub Copilot CLI
在终端里直接喊 AI 帮你写代码、改代码、查问题。
1. 安装 Node.js(需 ≥ v22)
去 阿里云镜像 下载,速度快很多:
- 打开 https://npmmirror.com/mirrors/node/
- 找到 v22 或 v24 的 LTS 版本
- 下载
node-vxx.x.x-x64.msi(Windows 64位版本) - 下载后双击安装,一路下一步 验证安装成功:
node --version
npm --version
看到版本号就 OK。
2. 安装 Copilot CLI(BYOK 模式)
在终端里运行:
npm install -g @github/copilot
需要 Node.js 22 或更高版本。安装完成后会自动注册
copilot命令。
验证:
copilot --version
看到版本号就说明装好了!
第三步:申请 DeepSeek 密钥
Copilot CLI 底层可以用 DeepSeek 的模型,又快又便宜。
1. 注册 DeepSeek 账号
打开 https://platform.deepseek.com,点 Sign Up 注册
2. 创建 API Key
- 登录后点左侧 API Keys
- 点 Create API Key
- 随便取个名字(比如 “my-key”)
- 复制生成的密钥(一串像
sk-xxxxxxxx的字符串)
注意:密钥只显示一次! 复制下来存到记事本里,丢了就要重新生成。
第四步:把 DeepSeek 接入 Copilot CLI
注意:必须使用
anthropic作为 provider type。 使用openai会触发 400 错误 — DeepSeek 要求将模型输出的reasoning_content原样回传,Copilot CLI 的 OpenAI 集成不支持此机制。Anthropic Messages API 端点可完全避免此问题。
官方接口文档:https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/copilot_cli
基础配置
$env:COPILOT_PROVIDER_TYPE="anthropic"
$env:COPILOT_PROVIDER_BASE_URL="https://api.deepseek.com/anthropic"
$env:COPILOT_PROVIDER_API_KEY="sk-your-deepseek-api-key"
$env:COPILOT_MODEL="deepseek-v4-flash"
可选模型:
deepseek-v4-flash(默认,更快)、deepseek-v4-pro(更强),改COPILOT_MODEL即可切换。
写入配置文件(持久化)
把以上内容加到 PowerShell 配置文件中,就不用每次手动设置了:
notepad $PROFILE
在打开的记事本末尾粘贴(记得把密钥换成你自己的):
$env:COPILOT_PROVIDER_TYPE="anthropic"
$env:COPILOT_PROVIDER_BASE_URL="https://api.deepseek.com/anthropic"
$env:COPILOT_PROVIDER_API_KEY="sk-你的密钥粘贴到这里"
$env:COPILOT_MODEL="deepseek-v4-flash"
$env:COPILOT_PROVIDER_MAX_PROMPT_TOKENS="840000"
$env:COPILOT_PROVIDER_MAX_OUTPUT_TOKENS="128000"
保存即可。运行 copilot help providers 可查看所有可用环境变量。
第五步:验收
关掉终端重新打开,试试来真的:
copilot
AI 能正确读取你的文件内容并执行操作,就说明全部配置成功了!
常见问题
| 问题 | 解决方法 |
|---|---|
npm install 报错 |
以管理员身份运行 Terminal 再试 |
copilot 找不到 |
重新打开 Terminal;或检查 Node.js 版本是否 ≥ 22 |
| Copilot 回复慢 | DeepSeek 免费额度用完了?去 platform.deepseek.com 充值 |
| 环境变量报错 | 检查 COPILOT_PROVIDER_API_KEY 是否正确粘贴了密钥 |
400 错误 / reasoning_content |
确认 COPILOT_PROVIDER_TYPE 是 anthropic 不是 openai |
| 密钥忘了 | 去 DeepSeek 平台重新生成一个 |
打不开 $PROFILE |
先运行 New-Item -Path $PROFILE -Force 创建 |
写代码从此不用切浏览器!