告别束缚，自由飞翔：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（如果还没有）
npm install -g @github/copilot
第二步：克隆项目并配置
git clone https://github.com/Dark-Athena/copilot-cli-local.git
cd copilot-cli-local
cp config.env.example config.env
编辑 config.env，填入你的 API 信息：
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
第三步：启动！
# Windows
copilot-local
# Linux / macOS
chmod +x copilot-local.sh
./copilot-local.sh
就这么简单。三步搞定，即刻开聊。
灵活的模型切换
想试试不同模型？一行命令搞定：
# 试试 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 支持一下！
