接入 GitHub Copilot CLI

GitHub Copilot CLI 是 GitHub 官方推出的终端原生 AI 助手，能够直接在命令行场景下提供命令生成、错误解释、脚本编写、自动化流程设计等能力，是开发者提升终端操作效率的核心工具。通过 BYOK（自带密钥）模式将其接入 DeepSeek V4 系列模型，可充分发挥 DeepSeek V4 超强代码推理能力、百万级上下文窗口、高性价比等优势，在复杂工程问题排查、大代码库分析、多步自动化任务生成等场景下获得更优的使用体验。

本教程将完整指导你完成 DeepSeek 模型与 GitHub Copilot CLI 的对接配置，全程保留 Copilot CLI 的所有原生功能，支持 Agent 模式、工具调用与 MCP（模型上下文协议）能力。阅读完成后，你将能够完全使用 DeepSeek 模型驱动 Copilot CLI 的所有操作，无需依赖原有 GitHub Copilot 订阅。

重要提示： 请使用 anthropic 作为 provider type。使用 openai 类型会触发 400 错误：The reasoning_content in the thinking mode must be passed back to the API. — DeepSeek 要求将模型输出的 reasoning_content 在下一次请求中原样回传，Copilot CLI 的 OpenAI 集成不支持此机制。改用 Anthropic Messages API 端点可以完全避免此问题。

补充说明：该限制源于 DeepSeek V4 为思考型大模型，推理过程内容需要在多轮对话中传递以保证上下文一致性，Anthropic 协议原生支持该特性，因此无需额外适配即可正常使用。

1. 安装 GitHub Copilot CLI

操作目的：全局安装 GitHub Copilot CLI 官方发行包，让你可以在系统任意路径下调用 copilot 命令。 前置环境检查：Copilot CLI 要求 Node.js 22 或更高版本，执行以下命令确认环境符合要求：

node -v # 输出应 ≥ v22.0.0
npm -v # 输出应 ≥ v9.0.0

若 Node.js 版本不符合要求，建议通过 nvm 等版本管理工具安装适配版本，避免系统版本冲突。

执行以下命令安装：

npm install -g @github/copilot

国内用户优化：若 npm 下载速度较慢，可追加淘宝镜像源参数：npm install -g @github/copilot --registry=https://registry.npmmirror.com 权限问题解决：Linux/macOS 若提示权限不足，可在命令前追加 sudo；Windows 用户需以管理员身份运行 PowerShell 执行安装命令。

需要 Node.js 22 或更高版本。详细说明参考官方入门指南。

预期结果：安装完成后执行 copilot --version，正常输出版本号（如 v1.16.0）即表示安装成功。

2. 获取 DeepSeek API Key

操作目的：获取调用 DeepSeek 开放 API 的身份凭证，所有请求均需该密钥进行鉴权。

• 前往 DeepSeek 开放平台 创建 API Key。
• 复制 Key（以 sk- 开头）。

安全提示：API Key 是你的身份凭证，请勿泄露给他人，也不要提交至公开代码仓库、配置文件等公开场景，避免被盗用产生不必要的费用。若怀疑 Key 泄露，请立即到开放平台删除并重新生成。 复用说明：若你已有可用的 DeepSeek API Key，且拥有 V4 系列模型的调用权限，可直接使用，无需重复创建。

预期结果：复制得到的密钥为 sk- 开头的64位左右字符串，无多余空格或特殊字符。

3. 配置环境变量

操作目的：将 DeepSeek 相关配置传递给 Copilot CLI，使其优先调用 DeepSeek API 而非默认的 GitHub Copilot 服务。 配置说明：以下所有环境变量均为必填项，缺失任意项都会导致配置失效。

Linux / Mac：

export COPILOT_PROVIDER_TYPE=anthropic
export COPILOT_PROVIDER_BASE_URL=https://api.deepseek.com/anthropic
export COPILOT_PROVIDER_API_KEY=sk-your-deepseek-api-key
export COPILOT_MODEL=deepseek-v4-pro

Windows（PowerShell）：

$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-pro"

可选模型：deepseek-v4-pro、deepseek-v4-flash，修改 COPILOT_MODEL 即可切换。

永久生效配置：若希望重启终端后配置仍然生效，Linux/macOS 用户可将上述 export 命令添加至 ~/.bashrc、~/.zshrc 等 shell 配置文件中；Windows 用户可在「系统属性-环境变量」中添加对应项。 冲突排查：若之前配置过其他 BYOK 模型的环境变量，请先清除原有配置，避免参数冲突导致配置不生效。 验证方法：配置完成后执行 echo $COPILOT_PROVIDER_TYPE（Linux/macOS）或 echo $env:COPILOT_PROVIDER_TYPE（Windows），输出 anthropic 即表示环境变量设置成功。

4. 启动 Copilot CLI

操作目的：启动 Copilot CLI 交互式界面，验证配置是否正常生效。

copilot

完整支持 Agent 模式、工具调用和 MCP — 全部由 DeepSeek 驱动。

预期结果：终端出现 Copilot CLI 欢迎界面，提示当前使用的模型为你配置的 deepseek-v4-pro 或 deepseek-v4-flash。你可输入测试指令（如「给我写一个统计当前目录下所有 TypeScript 文件代码行数的 shell 命令」），若能正常返回结果且无报错，即表示配置成功。

功能说明：Copilot CLI 原生的所有功能均可正常使用，包括 ? 解释上一条命令错误、!! 生成上一条命令的修复版本、/agent 进入多步任务模式等，所有能力均由 DeepSeek 模型提供支持。

可选：配置 Token 限制

操作目的：为 DeepSeek 模型配置适配的上下文窗口限制，充分发挥其百万级上下文能力。

由于 deepseek-v4-pro 不在 Copilot CLI 的内置模型目录中，默认会使用较小的 token 限制，可能导致长上下文被截断，因此建议显式配置 token 限制：

• COPILOT_PROVIDER_MAX_PROMPT_TOKENS：最大输入 token 数，设置为 840000 可覆盖 DeepSeek V4 90% 以上的输入窗口
• COPILOT_PROVIDER_MAX_OUTPUT_TOKENS：最大输出 token 数，设置为 128000 可支持超长代码、文档的生成需求

Linux / Mac：

export COPILOT_PROVIDER_MAX_PROMPT_TOKENS=840000
export COPILOT_PROVIDER_MAX_OUTPUT_TOKENS=128000

Windows（PowerShell）：

$env:COPILOT_PROVIDER_MAX_PROMPT_TOKENS="840000"
$env:COPILOT_PROVIDER_MAX_OUTPUT_TOKENS="128000"

运行 copilot help providers 可查看所有可用环境变量。

适用场景：如果你经常需要处理大代码库分析、长文档生成等场景，强烈建议配置该参数，避免上下文被截断导致结果不准确。

可选：离线模式

操作目的：阻止 Copilot CLI 调用 GitHub 官方 API，所有请求仅发送至 DeepSeek 服务器，满足数据隐私合规需求。

Linux / Mac：

export COPILOT_OFFLINE=true

Windows（PowerShell）：

$env:COPILOT_OFFLINE="true"

注意：提示词仍会发送到 api.deepseek.com — 离线模式仅阻止 GitHub 的 API 调用。

常见误解说明：此处的「离线模式」并非完全断网使用，仅指不与 GitHub 服务器通信，所有模型请求仍会发送至 DeepSeek 开放平台。若开启后出现功能异常，请检查网络是否可正常访问 api.deepseek.com。

相关资源

• GitHub Copilot CLI BYOK 文档：可查看 BYOK 模式的更多高级配置与功能说明。

常见问题（FAQ）

1. 启动后提示 401 认证错误怎么办？

   • 排查步骤：检查 COPILOT_PROVIDER_API_KEY 是否填写正确，是否存在多余空格或特殊字符；确认 API Key 未过期、未被禁用，且 DeepSeek 账户有可用配额。
   • 验证方法：可直接用该 Key 调用 DeepSeek 官方 API 测试，确认 Key 有效性。

2. 启动后提示 400 错误 The reasoning_content in the thinking mode must be passed back to the API 怎么办？

   • 根本原因：COPILOT_PROVIDER_TYPE 被设置为 openai，未使用要求的 anthropic 类型。
   • 解决方案：重新设置环境变量为正确的 provider type，重启终端后再次启动即可。

3. 环境变量设置后不生效怎么办？

   • 排查步骤：确认环境变量是在当前终端窗口设置的，若重启了终端需要重新设置（已配置永久生效的除外）；检查 shell 配置文件是否正确写入，执行 source ~/.zshrc（或对应配置文件）使其生效；确认没有其他优先级更高的环境变量覆盖了当前配置。

4. 模型响应速度慢怎么办？

   • 优化方案：简单场景可切换为 deepseek-v4-flash 模型，响应速度提升3-5倍；国内用户可将 COPILOT_PROVIDER_BASE_URL 替换为中国区端点 https://api.deepseeki.com/anthropic，降低网络延迟。

参考资料

• awesome-deepseek-agent：可查看更多 DeepSeek 生态的 Agent 工具与最佳实践。