localforge.dev 暂未发现付费内容

Localforge 是一个运行在本机的桌面 AI 编程代理（GUI），MIT 开源，支持接入 OpenAI、Claude、Gemini、Ollama 等任意 LLM。它和云端 AI 编程工具的核心差别在于：代码、密钥和 git 历史始终留在你的机器上，模型调用由你自己提供 API 密钥完成。如果你在意代码隐私、想避免厂商锁定，或者需要代理在本地仓库里直接改文件、跑测试、执行 shell 命令，本地方案更合适；如果你不想管理密钥、希望开箱即用且团队协作托管在云端，云端工具更省事。

本地运行与云端方案的关键差异

本地运行具体意味着什么

Localforge 官方把「本地优先」拆成三点，这三点也是判断它是否适合你的依据：

• 代码不出本机：你的代码、密钥和 git 历史不会离开你的机器，因此没有 SaaS 数据窥探、厂商锁定或合规层面的顾虑。
• 本地文件操作：代理直接在你的仓库里编辑文件、运行测试、执行 shell 命令，速度取决于本地磁盘而非网络。你可以和代理并排编辑，也可以让多个代理同时处理同一个代码库。
• 可自行审查和改造：MIT 开源核心意味着你可以检查自己的安全边界、修改代理逻辑，适配自己的工作流。

什么时候选本地，什么时候选云端

选 Localforge 这类本地方案，如果：

• 代码涉及敏感信息、私有密钥或受合规约束，不能上传到第三方环境
• 需要代理处理大型多文件任务，希望低延迟地反复改文件、跑测试
• 想自由切换模型（OpenAI、Gemini、Claude、Ollama 本地模型等），不愿被单一服务商绑定
• 愿意自己管理 API 密钥，并接受「只付模型调用费」这种成本结构

选云端方案，如果：

• 不想自己申请和管理 API 密钥，希望开箱即用
• 团队协作、环境托管依赖服务商提供的统一平台
• 对本地安装桌面应用、维护运行环境没有兴趣

使用前需要知道的前提

Localforge 提供 macOS 和 Windows 桌面版下载，也可通过 npm 全局安装（npm i -g @rockbite/localforge）。它本身免费且 MIT 许可，但你需要自备所选模型提供商的 API 密钥，模型调用费用由该提供商收取——这一点和云端工具把模型费用打包进订阅不同。此外，它的能力边界是「代理在你的本地仓库里工作」，因此前提是你已经有一个本地代码库可供代理操作。

功能上，它提供任务追踪器（显示每一步及其原因）、Expert Mode（让更强的模型复核并提升结果）、提示词模板的保存与复用，以及带标签页、多项目支持和可视化 diff 的 Electron 界面。

Localforge 是一个免费、开源、MIT 许可的本地桌面 AI 编程代理，核心能力是让代理直接在你的代码仓库里自主编辑文件、运行测试、执行 shell 命令，同时提供图形界面来管理任务和模型。它适合希望代码不出本机、又想用代理式编程处理多文件大任务的开发者；前提是你需要自备所选模型提供商的 API Key。

代理能做什么

Localforge 的代理不是只给建议的聊天窗口，而是直接在本地仓库中操作：

• 编辑文件：代理直接修改代码，你可以与它并排编辑，也可以让多个代理同时处理同一个代码库。
• 运行测试：代理会执行测试来验证改动。
• 执行 shell 命令：以本地磁盘速度运行命令，不经过云端往返。
• 任务跟踪：内置任务跟踪器显示每一步操作以及为什么这样做，方便你判断代理的决策是否合理。
• Expert Mode：遇到复杂问题时开启，让更聪明的模型审查并提升结果。

这些能力组合起来，适合“大任务、多文件”的场景，而不是单文件补全。

模型接入与切换

Localforge 是代理无关（agent-agnostic）的，官方列出的可接入提供商包括：

OpenAI、Azure、Claude、Gemini、Vertex AI、Ollama、OpenRouter、Groq、DeepSeek、Mistral、Perplexity、Anyscale、Fireworks、Together，以及 qwen3。

切换方式是“一键切换提供商”，没有厂商锁定。费用模式是自带 Key（Bring Your Own Keys）：软件本身免费开源，你只需向所选模型提供商付费。

界面与工作流

• Electron 桌面 GUI：带标签页、多项目支持、可视化 diff，减少在终端里反复操作。
• 提示模板：可以保存、调整、复用提示词，官方提到可共享的模板市场即将推出。
• 多项目：同一个工作区管理多个代码库。

本地运行意味着什么

所有操作都在你的机器上、在你的仓库内完成。官方强调代码、密钥和 git 历史不会离开本机，因此没有 SaaS 层面的窥探、厂商锁定或合规负担。代价是模型推理本身仍取决于你接入的提供商——如果用的是云端模型，请求仍会发往该提供商；只有接入 Ollama 等本地模型时才是完全离线。

版本与支持

免费版即可获得本地执行和无限仓库，付费主要买的是更新期限、优先支持和团队支持。

安装入口

官方提供 macOS 和 Windows 下载，也可以通过 npm 全局安装：

npm i -g @rockbite/localforge

安装后按页面上的 Setup Instructions 配置你的模型 API Key 即可开始使用。

如果你的日常开发涉及跨多个文件的改动、希望代理真正动手改代码而不是只给建议，并且在意代码留在本机，Localforge 的功能组合基本覆盖了这类需求；如果你只需要单文件补全或不想自己管理 API Key，它的价值会小很多。

Localforge 是一个免费、开源、MIT 许可的本地桌面 GUI，用于在代码库上运行 Codex AI、Claude 及任意 LLM 的自主代理循环。它完全在用户机器上运行，代码、密钥和 git 历史不离开本地，支持多文件大任务和多个代理并行。如果你希望用 AI 代理处理大型代码任务，同时不想把代码交给云端 SaaS，Localforge 是值得了解的选择。

它解决什么问题

云端 AI 编程工具通常要求你把代码上传到第三方服务器，带来隐私、合规和厂商锁定的顾虑。Localforge 把整个代理循环放在本地：代理直接在你的仓库里编辑文件、运行测试、执行 shell 命令，速度取决于本地磁盘，而不是网络往返。

它的核心定位是开发者本地 AI 结对编程环境，而非云端 SaaS 服务。

关键能力

本地 vs 云端

Localforge 官方给出的对比逻辑是：本地意味着完全控制、零延迟，以及对 AI 辅助开发环境的真正所有权。

• 完全控制：代码、密钥和 git 历史不离开本机，没有 SaaS 窥探、没有厂商锁定、没有合规麻烦。
• 本地文件：代理以 SSD 速度编辑文件、运行测试、操作 shell；可与代理并排编辑，或在同一代码库上运行多个代理。
• 可改造：MIT 核心，可自行审查安全性、修改代理、按自己的工作流定制。

如何开始

官方提供 macOS 和 Windows 下载，也可以通过 npm 全局安装：

npm i -g @rockbite/localforge

安装后填入你自己的模型 API 密钥即可使用。注意：Localforge 本身免费，但模型调用费用由你选择的提供商收取，官方未说明是否提供免费额度。

许可与支持

Localforge 采用 MIT 许可，官方称“永久免费”。页面列出三档支持方式：

• Free (MIT) — $0：永久免费开源，本地执行、无限仓库、unsafe-mode 标志、自动更新。
• Sponsor — $49：在免费版基础上增加 1 年自动更新和优先 Discord 支持。
• Enterprise Support — $1k：面向团队和组织，包含本地执行、无限仓库等。

适合谁

• 处理大型多文件任务、希望代理直接在本地仓库操作的开发者。
• 对代码隐私、合规有要求，不愿把代码交给云端 SaaS 的团队。
• 想自由切换 OpenAI、Gemini、本地模型等多种 LLM、避免厂商锁定的用户。
• 愿意自带 API 密钥、只向模型提供商付费的开发者。

如果你只需要轻量的云端补全、不涉及敏感代码，云端工具可能更省事；但当你需要代理自主跑完大任务、且代码不能出本机时，Localforge 的本地架构就是它的核心价值。

Localforge 是一个本地运行的桌面 GUI 代理工具，官方定位为“agent-agnostic”（代理无关），因此它不绑定任何单一模型厂商。你可以在界面中接入 OpenAI、Gemini、Claude、Ollama 本地模型，以及 qwen3、deepseek、groq、mistral、openrouter 等众多提供商，并通过一键切换在不同模型之间转换。前提是你需要自备所选模型提供商的 API 密钥，费用直接付给对应提供商，Localforge 本身不代收模型调用费。

支持的模型与提供商

根据官网页面信息，Localforge 明确列出可接入的提供商包括：

官网同时用“any LLM”“you name it”来描述其兼容范围，说明设计上并不限制于上述列表，只要提供商提供兼容的 API 接口即可尝试接入。

如何切换模型

官方描述的核心机制是“Swap providers instantly, zero lock-in”——即时切换提供商，无厂商锁定。具体表现为：

• 一键切换：在 GUI 中直接更换当前使用的模型，无需修改代码或重启整个工作流。
• 多模型并存：页面提到可以“run multiple agents on the same codebase”，即在同一代码库上运行多个代理，意味着不同代理可以配置不同模型。
• Expert Mode 联动：开启 Expert Mode 后，可以让一个更聪明的模型来审查和提升结果，这实际上也是一种模型分工与切换的使用方式。

如何配置密钥与本地模型

Localforge 采用“Bring Your Own Keys”（自带密钥）模式：

1. 云端模型：填入对应提供商的 API 密钥，调用费用由该提供商收取，Localforge 不额外收费。
2. 本地模型：通过 Ollama 等方式接入，实现完全离线运行。官网强调“Everything happens on your machine”，代码和密钥不会离开本机。

选择建议

• 如果你追求完全离线与隐私：优先用 Ollama 接入本地模型，代码、密钥、git 历史都不出本机。
• 如果你需要最强推理能力：可接入 OpenAI、Claude、Gemini 等云端模型，但需接受数据发送给对应提供商。
• 如果你希望灵活比价与路由：OpenRouter 这类聚合商可以在一个密钥下切换多家模型。
• 如果你在团队或企业环境：官网列出 Enterprise Support（$1k）档位，但具体支持内容需以官方页面为准。

Localforge 本身是 MIT 许可、永久免费的开源项目，模型调用成本完全取决于你选择的提供商和用量。

Localforge 提供 macOS 和 Windows 桌面版下载，也可以通过 npm 全局安装。安装后需要填入所选 LLM 提供商的 API 密钥才能开始使用。免费 MIT 版本支持本地执行、无限仓库和自动更新，无需付费即可长期使用。

获取渠道

根据 Localforge 官网页面，有三种获取方式：

npm 安装命令为：

npm i -g @rockbite/localforge

页面同时提供了 “Copy Setup Instructions” 入口和 GitHub 仓库链接（含 Star 入口），可获取更详细的安装说明。

安装后的必要配置

Localforge 本身不内置模型，需要你自备 API 密钥。页面明确说明 “Bring Your Own Keys”——填入所选提供商的密钥后，费用只支付给对应的模型提供商，Localforge 本身不额外收费。

支持的提供商包括：OpenAI、Azure、Claude、Gemini、Vertex AI、Ollama、DeepSeek、Groq、Anyscale、Fireworks、Together、Mistral、Perplexity、OpenRouter、qwen3 等。填入密钥后即可在界面中一键切换模型。

版本与费用

免费版为永久免费且开源（MIT 协议），功能上已覆盖本地执行和无限仓库，适合个人开发者直接使用。

验证安装是否成功

安装完成后，启动 Localforge，确认以下两点即可判断环境正常：

1. 界面能正常打开，显示 Electron 工作区（含标签页、多项目支持和可视化 diff）。
2. 填入至少一个提供商的 API 密钥后，能成功发起一次对话或任务。

常见卡点

• npm 安装后命令找不到：确认 Node.js 和 npm 已正确安装，且全局 bin 目录在 PATH 中。
• 填入密钥后无法调用模型：检查密钥是否有效、对应提供商的账户是否有余额或配额。
• 想完全离线运行：选择 Ollama 等本地模型提供商，无需外部 API 密钥，代码和数据不出本机。
• 需要更详细的步骤：参考官网的 Setup Instructions 或 GitHub 仓库中的说明文档。