告别束缚，自由飞翔：copilot-local 让 GitHub Copilot CLI 用上你自己的模型

你是否遇到过这样的困境：想用 GitHub Copilot CLI，却被官方模型限制、网络环境卡脖子、或者 API 额度不够用？现在，一个轻量级开源工具 copilot-local 彻底解决了这个问题。

什么是 copilot-local？

copilot-local 是一个开源的启动器脚本，它能让你以 离线模式（BYOK --- Bring Your Own Key） 运行 GitHub Copilot CLI，同时接入 任意第三方模型提供商。

简单来说：用 Copilot CLI 的优秀交互体验，配上你自己选择的大模型。

它不会修改、覆盖或干扰你原本的 Copilot CLI 环境------两者完全独立，和平共处。

为什么你需要它？

🎯 痛点一：官方模型受限

GitHub Copilot CLI 默认绑定特定模型，你无法自由选择。而 copilot-local 让你接入任何 OpenAI 兼容的 API------无论是 DeepSeek、Qwen、Llama，还是你自建的本地模型服务，统统可以。

🌐 痛点二：网络环境复杂

在国内访问 GitHub Copilot 服务经常不稳定。copilot-local 允许你将请求指向国内的 API 端点，彻底告别网络焦虑。

💰 痛点三：成本可控

使用自己的 API Key，意味着你可以精确控制每一笔 Token 消耗。配合高性价比的国产模型，成本可以低到令人惊喜。

🔒 痛点四：数据安全

代码是你的核心资产。通过 copilot-local，你的代码请求走的是你自己选择的 API 端点，数据流向完全由你掌控。

核心特性一览

特性	说明
🔌 任意 OpenAI 兼容 API	支持所有兼容 OpenAI 格式的模型提供商
🔑 配置文件管理	API Key 存放在本地 `config.env`，不硬编码，安全省心
🚀 自动检测环境	自动发现 Node.js 和 Copilot CLI 路径，开箱即用
🎯 命令行覆盖	`--model` 参数随时切换模型，灵活高效
📋 内置诊断	`--config` 一键查看当前配置，排查问题超方便
🖥️ 跨平台支持	Windows（`.bat`）和 Linux/macOS（`.sh`）双版本齐备
🛡️ 零侵入	不修改任何系统文件，不影响原有 Copilot CLI

30 秒上手

第一步：安装 Copilot CLI（如果还没有）

bash 复制代码

npm install -g @github/copilot

第二步：克隆项目并配置

bash 复制代码

git clone https://github.com/Dark-Athena/copilot-cli-local.git
cd copilot-cli-local
cp config.env.example config.env

编辑 config.env，填入你的 API 信息：

env 复制代码

COPILOT_PROVIDER_BASE_URL=https://your-api-endpoint.com/v1
COPILOT_PROVIDER_TYPE=openai
COPILOT_PROVIDER_API_KEY=sk-your-api-key-here
COPILOT_MODEL=your-model-name

第三步：启动！

bash 复制代码

# Windows
copilot-local

# Linux / macOS
chmod +x copilot-local.sh
./copilot-local.sh

就这么简单。三步搞定，即刻开聊。

灵活的模型切换

想试试不同模型？一行命令搞定：

bash 复制代码

# 试试 Qwen3 Coder
copilot-local --model qwen/qwen3-coder-next

# 试试 DeepSeek Coder
copilot-local -m deepseek/deepseek-coder

# 查看当前配置
copilot-local --config

配置优先级清晰明了：命令行参数 > 配置文件 > 默认值，让你在不同场景间自如切换。

技术细节：它是怎么做到的？

copilot-local 的核心原理非常巧妙：

设置 COPILOT_OFFLINE=true------告诉 Copilot CLI 进入离线模式，不再连接 GitHub 服务器
注入环境变量 ------通过 COPILOT_PROVIDER_BASE_URL、COPILOT_PROVIDER_API_KEY 等变量，将 Copilot CLI 的请求重定向到你指定的 API 端点
直接调用 Node.js 入口 ------绕过 PATH 查找，直接用 node 执行 Copilot CLI 的入口脚本

整个过程 不修改 Copilot CLI 的任何源码，纯粹通过环境变量注入实现，干净优雅。

默认配置就很能打

copilot-local 的默认配置已经针对国内用户做了优化：

默认模型 ：mimo-v2.5-pro（小米 MiMo 大模型，性能强劲）
默认端点 ：https://token-plan-cn.xiaomimimo.com/v1（国内节点，低延迟）
超大上下文窗口：90 万 Token 输入 + 13 万 Token 输出，处理大型代码库游刃有余

当然，你可以随时在 config.env 中替换为任何你喜欢的模型和端点。

适合谁？

👨‍💻 日常开发者：想要更灵活的 AI 编程助手，不想被单一模型绑定
🏢 企业团队：需要将代码请求指向私有部署的模型服务，确保数据安全
🧪 模型评测者：想在同一个 CLI 界面下快速切换不同模型进行对比测试
🌏 国内开发者：网络环境受限，需要稳定的国内 API 端点
💰 精打细算的你：希望用高性价比模型降低 AI 编程成本

项目结构一览

复制代码

copilot-cli-local/
├── copilot-local.bat       # Windows 启动脚本
├── copilot-local.sh        # Linux / macOS 启动脚本
├── config.env              # 你的配置文件（需自行创建）
├── config.env.example      # 配置模板
└── README.md               # 完整文档

没有复杂的依赖，没有冗余的框架。两个脚本 + 一个配置文件，就是全部。

开源免费，MIT 协议

copilot-local 采用 MIT 开源协议，你可以自由使用、修改和分发。欢迎提交 Issue 和 PR，一起让它变得更好。

写在最后

在 AI 编程工具百花齐放的今天，选择权 比任何时候都更重要。copilot-local 不是要替代什么，而是给你多一个选择------用你喜欢的模型，走你信任的网络，花你能接受的成本，享受 Copilot CLI 丝滑的终端交互体验。

自由，从一行配置开始。

🔗 项目地址 ：github.com/Dark-Athena/copilot-cli-local

如果这个项目对你有帮助，别忘了给个 ⭐ Star 支持一下！

本文作者： DarkAthena

本文链接： https://www.darkathena.top/archives/copilot-cli-local

版权声明： 本博客所有文章除特别声明外，均采用CC BY-NC-SA 3.0 许可协议。转载请注明出处