如何下载和安装 Localforge?
Localforge 提供 macOS 和 Windows 桌面版下载，也可以通过 npm 全局安装。安装后需要填入所选 LLM 提供商的 API 密钥才能开始使用。免费 MIT 版本支持本地执行、无限仓库和自动更新，无需付费即可长期使用。
获取渠道
根据 Localforge 官网页面，有三种获取方式：
| 方式 | 适用平台 | 获取途径 |
|---|---|---|
| 桌面版安装包 | macOS | 官网 Download for macOS 按钮 |
| 桌面版安装包 | Windows | 官网 Download for Windows 按钮 |
| npm 全局安装 | 跨平台（需 Node.js 环境） | 终端执行安装命令 |
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 等。填入密钥后即可在界面中一键切换模型。
版本与费用
| 版本 | 价格 | 包含内容 |
|---|---|---|
| Free (MIT) | $0 | 本地执行、无限仓库、Unsafe-mode flag、自动更新 |
| Sponsor | $49 | 在免费版基础上增加 1 年自动更新和 Priority Discord |
| Enterprise Support | $1k | 面向团队和组织，含本地执行、无限仓库等 |
免费版为永久免费且开源（MIT 协议），功能上已覆盖本地执行和无限仓库，适合个人开发者直接使用。
验证安装是否成功
安装完成后，启动 Localforge，确认以下两点即可判断环境正常：
- 界面能正常打开，显示 Electron 工作区（含标签页、多项目支持和可视化 diff）。
- 填入至少一个提供商的 API 密钥后，能成功发起一次对话或任务。
常见卡点
- npm 安装后命令找不到：确认 Node.js 和 npm 已正确安装，且全局 bin 目录在 PATH 中。
- 填入密钥后无法调用模型：检查密钥是否有效、对应提供商的账户是否有余额或配额。
- 想完全离线运行：选择 Ollama 等本地模型提供商，无需外部 API 密钥，代码和数据不出本机。
- 需要更详细的步骤：参考官网的 Setup Instructions 或 GitHub 仓库中的说明文档。