Windows Terminal + GitHub Copilot + DeepSeek 配置指南

让你的命令行变身 AI 编程助手!

第一步:安装 Windows Terminal

一个更好看、更好用的命令行工具,代替丑丑的 CMD。

GitHub Release 页面下载:

  1. 打开 https://github.com/microsoft/terminal/releases
  2. 找到最新的版本(第一个就是),往下翻到 Assets
  3. 下载 Microsoft.WindowsTerminal_版本号_x64.msixbundle(选 x86_64 版本)
  4. 双击安装,一路下一步

注意:不要下载 arm64 版本,除非你是 ARM 架构的电脑(Surface Pro X 那种)。

验证:按 Win + R,输入 wt 回车,能打开就 OK!

第二步:安装 GitHub Copilot CLI

在终端里直接喊 AI 帮你写代码、改代码、查问题。

1. 安装 Node.js(需 ≥ v22)

阿里云镜像 下载,速度快很多:

  1. 打开 https://npmmirror.com/mirrors/node/
  2. 找到 v22 或 v24 的 LTS 版本
  3. 下载 node-vxx.x.x-x64.msi(Windows 64位版本)
  4. 下载后双击安装,一路下一步 验证安装成功:
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_TYPEanthropic 不是 openai
密钥忘了 去 DeepSeek 平台重新生成一个
打不开 $PROFILE 先运行 New-Item -Path $PROFILE -Force 创建

写代码从此不用切浏览器!