企业官网建设流程全解析

零成本AI编程实战：FreeLLMAPI接入Aider、Cline、Roo Code等15款编码Agent教程

【免费下载链接】freellmapi7.4 billion tokens per month. 34 free LLM providers. 635 free model endpoints. All behind one /v1 endpoint, plus any custom OpenAI-compatible endpoint. Smart routing, automatic failover, encrypted keys. Personal experimentation only.项目地址: https://gitcode.com/GitHub_Trending/fr/freellmapi

FreeLLMAPI 是一款免费、自托管的 LLM API 路由器：把 34 家免费模型服务商、635 个免费模型端点聚合到一个 OpenAI 兼容接口背后，让你零成本驱动 Aider、Cline、Roo Code 等 15 款编码 Agent。智能路由、自动故障转移、加密密钥，每月约 74 亿免费 Token，个人 AI 编程完全够用。

为什么需要 FreeLLMAPI：把免费 Token 变成编程动力 🚀

每家大厂都有免费额度，但单家只是"玩具级"。手动把它们堆起来极其痛苦：34 套 SDK、34 种限流、34 个会失败的地方。

FreeLLMAPI 把这一切压成一个/v1端点：

• 聚合免费额度：34 家提供商、474 个模型家族，合计约74 亿 Token/月
• 智能路由：按实时速度、能力、可靠性打分，为每个请求挑选最优模型
• 自动故障转移：遇到 429/5xx 自动冷却并切换链上下一家模型，最多尝试 20 次
• 按密钥限流跟踪：RPM/RPD/TPM/TPD 计数器让路由永远不超出任何免费上限
• 加密存储：提供商密钥以 AES-256-GCM 加密存于本地 SQLite，应用只需要一个统一的freellmapi-…Token

三步搭建零成本 AI 编程网关

第 1 步：安装并启动路由器

任选一种方式（详见docs/install.md）：

方式 A：一行命令（需 Docker）

curl -fsSL https://freellmapi.co/install.sh | bash

方式 B：本地源码运行（Node 20+）

git clone https://gitcode.com/GitHub_Trending/fr/freellmapi cd freellmapi && npm install npm run dev

方式 C：桌面应用：Windows/macOS 可从项目 Releases 页面下载安装包，路由器+仪表盘直接从托盘菜单运行，还有实时请求统计弹窗。

第 2 步：添加免费密钥，拿到统一 API Key

打开http://localhost:3001，在Keys页面把各家提供商的免费 Key 添加进去（Groq、Google、Cerebras、Mistral、OpenRouter 等都支持）。每个密钥旁有状态指示灯和健康检查时间。

页面头部会显示你的统一 API Key（freellmapi-…开头）——之后所有编码 Agent 都只需要这一把钥匙。

第 3 步：调整 Fallback Chain 回退链

在Fallback页面拖拽排序你的免费模型链，也可以一键"按智能 / 按速度 / 按预算"排序。请求会从上到下依次尝试，直到成功。

完成后打开Models页面确认路由状态：每个模型都显示实时可靠性、速度、智能评分和月度 Token 预算条，下面的顺序就是当前真实的路由顺序。

一条命令接入 15 款编码 Agent ⚡

FreeLLMAPI 自带配置生成器：自动拉取你服务器上的实时模型目录、合并进现有配置、先做时间戳备份，绝不覆盖已有内容。所有命令都支持--dry-run预览 diff。

以 Aider 为例：

npx freellmapi setup-aider --url http://localhost:3001 --api-key <你的统一Key>

完整 15 款 Agent 一键接入清单：

Zed、JetBrains AI 等 Ollama 客户端可在Keys → Agents页开启 Ollama 模拟，指向http://localhost:3001即可。各工具的详细配方见docs/clients.md。

热门 Agent 接入要点 🔧

Aider（终端结对编程）：setup-aider会把 base URL 写为http://localhost:3001/v1，模型填auto即可让路由器代选。之后aider --model auto开始写代码，完全不用操心哪家提供商。

Cline / Roo Code（VS Code 插件）：两者都是标准 OpenAI Chat 协议，setup-cline/setup-roo一键写好配置。免费模型里的 tool calling 会被路由器在各提供商间正确往返，纯文本形式的工具调用还会被"抢救"成真正的tool_calls。

Claude Code / Codex CLI：Claude Code 使用 Anthropic Messages 协议（Base URL 填根目录即可，路由器自动翻译协议）；还可用npx freellmapi launch零落盘启动器，凭据只注入子进程、不写配置文件。

Cursor 等云端客户端：需要一个公网 URL。在Keys → Agents生成可独立吊销的 URL Token，走/v1/t/<token>/…路径——Token 可随时单独撤销，避免泄露风险。

让 Agent 更稳的 3 个进阶技巧 💡

1. 智能路由档位：模型名传auto（路由器代选）、auto:fast（速度优先）、auto:smart（智能优先），或按命名 Profile（如编码链）整组切换。
2. 上下文交接（Context Handoff）：中途因限流切到别的模型时，自动注入一条紧凑的 system 消息，告诉新模型"你正在接手别人的任务，别重头再来"。在.env中开启FREELLMAPI_CONTEXT_HANDOFF=on_model_switch即可，实现见server/src/services/context-handoff.ts。
3. MCP 内省：路由器自带 MCP 服务（/mcp），Agent 可以中途查询可用模型、提供商健康度和路由策略，相当于给 Agent 装了一双"看见后端"的眼睛。

工作原理：一个请求是如何被"救活"的

请求进来后，路由器挑选优先级最高、密钥健康且未超限的模型；遇到 429/5xx 就把该密钥冷却下来，重试链上下一家——整个故障转移循环（见server/src/lib/fallback-loop.ts）完整记录每一次尝试，直到成功为止。

使用注意事项 ⚠️

• 仅限个人实验：免费额度不是生产级基础设施，没有 SLA；正式产品请换成付费 API
• 额度每日重置：UTC 零点刷新，一天之内用尽顶级模型后，端点智能程度会下降
• 合规责任在你：代理不改变你与各提供商用户协议的约束关系，请自行遵守
• 本地优先：密钥只存在你自己的 SQLite 里（加密），请求从你的机器直连上游，单用户设计

从零搭建到跑通第一个编码 Agent，全程不超过 10 分钟——而 Token 账单永远是 0 元。去docs/clients.md找你的 Agent 配方，开始零成本 AI 编程吧！

【免费下载链接】freellmapi7.4 billion tokens per month. 34 free LLM providers. 635 free model endpoints. All behind one /v1 endpoint, plus any custom OpenAI-compatible endpoint. Smart routing, automatic failover, encrypted keys. Personal experimentation only.项目地址: https://gitcode.com/GitHub_Trending/fr/freellmapi