本地 AI 模型接入 Cursor：cursor-byok 三步上手指南

本地 AI 模型接入 Cursorcursor-byok 三步上手指南【免费下载链接】cursor-byokcursor-byok is a local implementation of Cursors backend. https://github.com/leookun/cursor-byok/releases项目地址: https://gitcode.com/gh_mirrors/cu/cursor-byok我的一位同事把公司代码库接进 Cursor 后第三周就被合规部门约谈AI 对话记录去了哪个数据中心谁也说不清。cursor-byok 正是为这类处境准备的开源工具——它在本地实现 Cursor 的后端逻辑把请求转发到你指定的模型接口无论是自建推理服务、开源模型还是你自己付费的 API 密钥都能无缝接进 Cursor。这篇文章用我实际踩坑的经验带你走完从拉取代码到跑通第一次对话的完整路径。1. 真实卡点模型选择权为什么会成为问题先看三个常见场景你大概率中过其中一个订阅账单按席位按月付费但真正高频使用的往往只有少数几个模型成本大头花在了可选而非常用上。数据边界不少公司要求代码不得离开内网官方在线模型的每一次补全都在把代码片段悄悄送去远端。选择受限你手上可能已经有一个跑得很顺的开源模型或者公司自建的推理网关但 Cursor 的模型名单里根本没有它的位置。这三个问题指向同一件事如果能自己决定请求发往哪里问题就解决了一半。cursor-byok 做的就是把这另一半补上——让 Cursor 的每个请求都按你的路由规则走同时保留编辑器的完整体验。2. 它怎么工作一个本地中转站用一句话概括cursor-byok 是 Cursor 后端的本地复刻。它在你机器上起一个服务Cursor 发出的补全、对话请求先到达这个服务再由它转发给你配置的模型接口最后把返回流式传回编辑器。对使用者来说这意味着三件事模型入口统一收敛到一份本地配置里换模型不用动 Cursor 的设置数据路径完全可控本地模型的请求甚至可以不出本机一次配置团队内可复用多套配置之间切换只需改一个文件。上图是项目界面里展示的模型生态除了 Cursor 官方能力Moonshot AI、Qwen、小米 MiMo 等第三方服务都能被接进来以及更多意味着只要接口兼容理论上都可以注册。看到这里你大概已经理解它的定位了接下来进入动手环节。3. 第一步拉取代码与准备运行环境仓库地址如下直接克隆到本地git clone https://gitcode.com/gh_mirrors/cu/cursor-byok cd cursor-byok项目主体用 Go 编写前端界面基于 Vue。从源码构建需要 Go 1.21 及以上版本如果只是想运行服务、不重新编译前端Node.js 并非必须。构建完成后你会看到类似下图的控制面板面板上集中了服务启停、账号状态、会话统计缓存命中率、Token 消耗、价值估算以及模型配置入口日常操作基本都从这里发起。面板就绪后下一步是拿到通信所需的凭证。4. 第二步拿到那把钥匙——Cursor 访问令牌要让本地服务以你的身份与 Cursor 通信需要一份访问令牌。它存放在 Cursor 的本地数据库中用系统自带的 sqlite3 就能读出来。macOS 用户执行sqlite3 $HOME/Library/Application Support/Cursor/User/globalStorage/state.vscdb \ SELECT value FROM ItemTable WHERE key cursorAuth/accessToken;Windows 用户执行sqlite3 $env:APPDATA\Cursor\User\globalStorage\state.vscdb SELECT value FROM ItemTable WHERE key cursorAuth/accessToken;有两点提醒其一令牌等同你的账号凭证不要写进会提交到仓库的公开文件其二如果报错提示表不存在先确认 Cursor 已经登录过一次再保持退出状态重试。5. 第三步写入配置启动服务打开cursor-tab-server/config.yaml把上一步拿到的令牌填进去token: 在这里粘贴你的访问令牌随后启动服务./cursor-byok服务起来后本地会监听一个地址通常形如http://localhost:8080把 Cursor 的模型指向它即可完成对接。首次运行后程序会在用户目录下自动建立数据区包括~/.cursor-local-assistant-v2/config.yaml用户级配置~/.cursor-local-assistant-v2/data/ca.crt本地 CA 证书~/.cursor-local-assistant-v2/history/会话历史记录~/.cursor-local-assistant-v2/logs/运行日志备份时只需把这个目录整体打包带走迁移到新机器就能直接恢复。至此服务链路已经通了剩下的就是给助手挑选合适的大脑。6. 给你的助手换大脑模型接入与测试项目支持的主流接入类型如下表所示类型典型代表接入方式OpenAI 系GPT-4、GPT-3.5、GPT-4o标准 OpenAI 接口AnthropicClaude 系列兼容接口本地模型自部署的推理服务暴露 OpenAI 格式 API 即可其他兼容服务Moonshot、Qwen、MiMo 等填写基础地址与密钥在模型配置页里每个模型可以维护显示名称、API 基础地址、密钥和模型 ID 四项核心信息。我推荐先用测试按钮跑一遍界面会直接给出吞吐速率t/s和首字延迟几十个模型横向对比一遍谁快谁慢一目了然比凭印象选模型靠谱得多。7. 三个值得一试的进阶玩法多任务并行单个会话里可以同时推进多个任务适合批量修改、批量审查这类场景不用一条条排队等结果。现成的提示词模板项目在prompt/目录下内置了多套提示词覆盖代码审查、调试辅助、提交信息生成、计划制定等高频场景直接取用比自己从零打磨稳定得多。完全离线部署把模型也部署到内网后整个链路Cursor → 本地服务 → 内网模型不再触碰公网代码数据全程不出内网尤其适合数据敏感团队。8. 卡壳排查、提速与适用人群部署中最常遇到的两类问题整理成一张速查表症状常见原因处理办法连接失败令牌错误或已过期重新读取令牌并更新配置连接失败端口被占用更换端口或先停掉占用进程连接失败防火墙拦截本地回环放行 localhost 对应端口响应慢超时设置过短调大请求超时阈值响应慢提示词过长精简上下文内容响应慢上游服务拥堵换时段重试或切换备用模型性能调优上我的三条建议是打开会话缓存减少重复请求把相似任务合并成批量操作条件允许时优先使用本地模型省掉公网往返的延迟。至于谁适合用它——个人开发者可以把它当成全部模型都摆在本地的实验台想省订阅费或反复对比模型都方便团队可以用一份配置全组复用统一提示词模板和代码审查口径企业则能借此把模型请求留在内网同时满足合规与定制工作流的需求。如果你正好处在上面的某个场景不妨今晚就花二十分钟把仓库克隆下来按第二步到第五步的顺序跑一遍先接一个本地模型试试水温。配置完成的那一刻你会发现自己第一次真正握有选择权能决定 AI 助手到底用谁的大脑。【免费下载链接】cursor-byokcursor-byok is a local implementation of Cursors backend. https://github.com/leookun/cursor-byok/releases项目地址: https://gitcode.com/gh_mirrors/cu/cursor-byok创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考