OpenPilot：连接自选模型的桌面 AI 编程助手

OpenPilot 是干什么用的？用大白话解释

OpenPilot 是装在电脑上的开源 AI 编程助手。你先给它接上一个大模型，再选一个项目文件夹，用聊天的方式告诉它要完成什么。它可以直接在这个文件夹里创建或修改文件，并运行终端命令，让修改后的项目真正留在你的电脑上。

可以把它理解成“大模型在本地项目里干活的操作台”：模型负责理解需求和提出方案，OpenPilot 提供文件、终端及外部工具的操作能力。它适合想自主选择模型的开发者、独立开发者和原型制作者；使用者仍需检查代码与执行结果。

从生成项目到修复报错：它能替你做哪些工作

搭建原型时，可以让 OpenPilot 创建目录、编写源文件和补充 README；维护已有项目时，可以先检索代码，再修改相关文件。终端工具能够安装依赖、启动开发服务器、运行测试，并把输出显示在对话中，便于继续定位问题。

例如，可以先提出“创建一个带健康检查接口的小型 API，并写出启动说明”这样的有限任务，再根据实际文件和测试输出追加修改。这里的重点是形成“提出目标—修改文件—执行检查—继续修正”的工作过程。生成了代码并不代表通过验收，仍应核对接口行为、依赖和测试结果。

如何安装并完成第一次项目任务

截至 2026 年 10 月 12 日，官方 v1.0.5 已提供 Windows 安装版与便携版 EXE，以及 Apple silicon 和 Intel Mac 的 DMG。官网仍保留“macOS 即将推出”的旧文案，下载应以 GitHub 实际发布文件 为准；官网下载页注明 Windows 需要 10 或更高版本、x64 架构。

1. 下载适合电脑架构的版本，安装或启动便携程序。
2. 打开 Settings → Models，填写模型服务的 Base URL、API Key 和 Model ID，保存后在输入区域选择模型。
3. 选择要处理的项目文件夹。建议第一次先使用范围明确的小项目。
4. 写清任务目标、技术栈和验收条件，观察文件修改与终端执行记录，检查敏感命令的授权提示。
5. 打开修改后的文件，结合实际测试输出确认结果，再提出后续需求。

需要从源码运行的开发者，可按仓库说明准备 Node.js 20+，再执行依赖安装与启动步骤。

自带 API 与本地模型有什么区别

OpenPilot 使用兼容 OpenAI 格式的接口，官方列举了 OpenAI、OpenRouter、Ollama、LM Studio 和自定义网关。Ollama 的指南示例地址是 http://localhost:11434/v1；它是连接地址示例，不表示软件已经替你下载或启动了模型。

云端模型的推理在相应服务端完成，本地模型则需要你自己的运行环境和算力。模型能力会影响多步骤任务的质量，官方 FAQ 也提示较长的重构任务通常需要更强的模型。原生 Anthropic 接口仍列在路线图中，当前文档给出的接入路径是 OpenRouter。

联网查文档、接入 MCP、保存项目习惯

需要查询最新文档、错误说明或 API 资料时，先配置 TinyFish API Key，才会启用网页搜索和抓取工具。没有配置 TinyFish 时，本地文件与终端任务仍可使用，但这些联网研究工具不可用。

MCP 用于扩展工具和资源：在 mcp.json 中配置服务器，重启应用，再按对话启用所需连接。Skills 可以复用操作步骤，AGENTS.md 可以保存项目偏好，例如代码风格和测试约定，减少反复交代背景。项目说明能帮助代理遵循约定，但不应把它当成强制隔离或安全保障。

免费的是软件，模型费用和额度另算

按 2026 年 10 月 12 日核实的信息，OpenPilot 不要求注册产品账号或订阅，项目声明采用 MIT 许可证。你需要自己提供模型连接；云端推理、联网服务和其他外部工具是否收费、如何限额，应分别查看对应服务商。

因此，不能把“开源免费”理解成内含无限免费大模型调用。软件提供按模型查看会话及累计 Token 使用量的功能，便于观察消耗，但没有可核实的统一免费 Token 额度，也不能据此保证固定使用成本。

本地运行是否意味着数据完全不出电脑

不一定。应用运行在本地，选择云端模型后，请求仍会发送到该模型服务；TinyFish 和远程 MCP 连接也会涉及外部系统。使用本地模型有助于把推理留在自己的电脑上，但仍要检查整个配置的联网行为。

官方仓库的遥测说明 表示，匿名使用统计默认开启，可在首次设置或 Settings → About 中关闭；说明列出的排除项包括聊天内容、文件、路径和 API Key。当前源码还显示，新保存的密钥采用本地加密存储。官网 FAQ 中“没有服务器”和操作系统密钥库的表述与当前仓库存在差异，因此这里不承诺绝对离线、零遥测或某个云端服务的数据保留政策。

常见问题

OpenPilot 能直接修改已有项目吗？

可以。选中项目文件夹后，它能够读取、检索和编辑文件，并运行终端检查。建议从一个明确的小改动开始，检查实际差异与测试结果。

OpenPilot 免费，为什么还可能产生费用？

免费的是 OpenPilot 软件本身。模型 API、联网检索或其他连接服务的账单与额度由各服务商决定，软件并未承诺无限免费推理。

能接入 Ollama 或 LM Studio 吗？

官方支持通过兼容接口连接这类本地模型服务。实际效果取决于模型和电脑配置；启用云端工具或遥测时仍可能联网。

官方资源与开发者社区

• 入门与配置指南：查看模型、工作区、TinyFish 和 MCP 的设置方法。
• 官方 GitHub 仓库：检查源码、从源码启动及项目更新。
• 问题反馈入口：附上应用版本、系统信息和复现步骤提交问题。