freellmapi-proxy — скилл для Claude Code: прокси к бесплатным LLM
Скилл разворачивает самохостящийся OpenAI-совместимый прокси, который сводит ключи бесплатных тарифов разных провайдеров в одну точку.
npx skills add reason-machines/trending-skills --skill freellmapi-proxy -a claude-codeЧто делает freellmapi-proxy
FreeLLMAPI собирает ключи примерно четырнадцати провайдеров — Google, Groq, Cerebras, SambaNova, NVIDIA, Mistral, OpenRouter, GitHub Models, Hugging Face, Cohere, Cloudflare, Zhipu, Moonshot, MiniMax — за одним эндпоинтом /v1/chat/completions. Запросы уходят на model: "auto", роутер сам выбирает доступного провайдера, а при 429 и 5xx переключается на следующего по цепочке. Ключи лежат в SQLite в зашифрованном виде, для многошаговых диалогов есть залипание сессии на одном провайдере.
Ставится как обычный Node-проект: git clone, npm install, затем в .env нужен ENCRYPTION_KEY — 64-символьная hex-строка, которой шифруются ключи провайдеров. Без него хранилище ключей не заработает. Дальше npm run dev поднимает сервер и дашборд на Vite, продакшн-сборка отдаёт API и панель на порту 3001.
Ключи добавляют через страницу Keys в дашборде, там же меняют порядок провайдеров в Fallback Chain и копируют единый bearer-токен freellmapi-…. Клиент подключается как обычный OpenAI SDK: меняется только base_url на http://localhost:3001/v1. Вызовы инструментов поддерживаются у всех провайдеров, а для Gemini запросы на лету переводятся в формат functionDeclarations и обратно.
Какие задачи решает
- свести ключи бесплатных тарифов нескольких провайдеров в один эндпоинт
- пережить лимит 429 без падения запроса — переключиться на следующего провайдера
- держать многошаговый диалог на одном провайдере, чтобы не терять контекст
- хранить ключи провайдеров зашифрованными, а не в открытом
.env - вызвать конкретную модель вроде
gemini-2.5-flashчерез общий роутер
Примеры запросов агенту
- Подними FreeLLMAPI и добавь ключи Groq и Cerebras через дашборд
- Настрой цепочку провайдеров так, чтобы Gemini шёл первым, а OpenRouter последним
- Отправь запрос через прокси с
model: "auto"и покажи, какой провайдер ответил
Как установить freellmapi-proxy
1Через Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill freellmapi-proxy -a claude-code2Вручную: положить файлы
~/.claude/skills/freellmapi-proxy/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/freellmapi-proxy/
1Через Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill freellmapi-proxy -a codex2Вручную: положить файлы
.agents/skills/freellmapi-proxy/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill freellmapi-proxy -a cursor2Вручную: положить файлы
.cursor/skills/freellmapi-proxy/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills freellmapi-proxy2Вручную: положить файлы
.github/skills/freellmapi-proxy/SKILL.md1Через Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill freellmapi-proxy -a gemini-cli2Командой платформы
gemini skills install https://github.com/reason-machines/trending-skills --path skills/freellmapi-proxyВручную: положить файлы
.devin/skills/freellmapi-proxy/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill freellmapi-proxy -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о freellmapi-proxy
Как установить freellmapi-proxy в Claude Code?
Выполните npx skills add reason-machines/trending-skills --skill freellmapi-proxy -a claude-code. Скилл окажется в ~/.claude/skills/freellmapi-proxy/SKILL.md.
Что делает freellmapi-proxy?
Разворачивает OpenAI-совместимый прокси, который объединяет ключи бесплатных тарифов примерно четырнадцати провайдеров и сам переключается между ними при ошибках.
Что нужно для запуска прокси?
Node.js 20+ и npm. В .env обязателен ENCRYPTION_KEY — им шифруются ключи провайдеров перед записью в SQLite.
