FreeLLMAPI: установка, API-ключ и настройка Claude Code

FreeLLMAPI — программа, через которую можно попробовать бесплатные нейросети. Сейчас установим её, включим бесплатный источник и зададим вопрос. Для первых трёх шагов не нужно платить, писать код или получать ключи у других сервисов.

Понадобятся компьютер с Windows или Mac, интернет и возможность устанавливать программы. Английские названия кнопок оставлены как на экране, рядом — перевод. Бесплатный доступ может меняться. Скриншоты сняты на нашей отдельной установке: ответ действительно получен. Число 3197 на ней — особенность теста; обычный адрес программы — http://localhost:3001.

Что бесплатно, а за что платят

FreeLLMAPI не обучает собственную модель и не выдаёт каждому пользователю оплаченный баланс. Он пересылает запросы выбранным внешним провайдерам, учитывает ограничения и может переключаться на следующий источник при ошибке. Есть два способа получить доступ:

• Провайдеры без ключа. Некоторые источники допускают обращения без регистрации или отдельного API-ключа. Они работают только пока такой доступ действительно открыт: условия, региональные ограничения и доступные модели меняются.
• Ваши ключи провайдеров. Для большинства источников нужно зарегистрироваться у соответствующего сервиса, получить ключ и добавить его в FreeLLMAPI. Бесплатность определяется условиями вашего аккаунта, а не самим роутером.

Цифра «7,4 миллиарда токенов в месяц» на сайте проекта — заявленная агрегированная ёмкость перечисленных бесплатных предложений. Это не персональная гарантированная квота. Регистрация, подтверждение аккаунта, лимиты в минуту, доступность из вашей страны и временные акции могут уменьшить реально доступный объём. Нельзя складывать рекламные лимиты и считать, что столько токенов уже лежит на вашем счёте.

Согласно официальным тарифам, Premium ускоряет получение новых моделей, изменений квот и исправлений совместимости. Бесплатный каталог получает модели через 30 дней после появления в live-feed. Сам роутер остаётся бесплатным и открытым под MIT. Перед оплатой проверьте условия checkout: стоимость и состав предложения могут измениться.

Шаг 1. Как скачать и установить программу?

На Windows

1. Откройте страницу скачивания. Регистрироваться на GitHub не нужно.
2. Прокрутите до Assets — списка файлов. Если он свёрнут, нажмите Assets.
3. Нажмите файл с окончанием .exe. Source code не выбирайте: это для разработчиков.
4. Откройте папку Загрузки и дважды нажмите скачанный файл.
5. Установите программу по подсказкам открывшегося установщика.
6. Запустите FreeLLMAPI из меню Пуск.
7. Найдите значок программы рядом с часами справа внизу. Если его нет, нажмите стрелку скрытых значков.
8. Нажмите значок и выберите Open Dashboard — «Открыть панель управления».

На Mac

1. Нажмите  → Об этом Mac. Если в строке «Чип» написано Apple M1, M2, M3, M4 или другой Apple M — выбирайте arm64. Для Intel выбирайте x64.
2. Откройте страницу скачивания, найдите Assets и нажмите файл .dmg нужной архитектуры. Source code не нужен.
3. Откройте скачанный файл. Установите приложение по подсказкам. Если показаны значок приложения и папка Applications, перетащите значок в эту папку.
4. Откройте Программы → FreeLLMAPI. Требуется macOS 12 или новее.
5. Найдите значок FreeLLMAPI в верхней строке меню и выберите Open Dashboard.

Результат: в браузере открылась панель с меню Models, Playground, Keys. Если приложение предлагает первоначальную настройку, следуйте её подсказкам. Терминал для этого пути не нужен.

Если система блокирует приложение, не отключайте защиту: проверьте официальный источник файла и попросите помочь с проверкой. Оставьте FreeLLMAPI запущенным: при выходе из программы ответы перестанут работать. Закрытую вкладку можно открыть снова через Open Dashboard.

git clone https://github.com/tashfeenahmed/freellmapi.git
cd freellmapi
umask 077
ENCRYPTION_KEY="$(openssl rand -hex 32)"
printf "ENCRYPTION_KEY=%s\nPORT=3001\n" "$ENCRYPTION_KEY" > .env
docker compose up -d

docker compose logs -f freellmapi

Шаг 2. Куда нажать, чтобы включить бесплатную нейросеть?

1. В верхнем меню нажмите Keys — «Ключи».
2. Нажмите Add key — «Добавить ключ».
3. В окне нажмите Platform — список сервисов.
4. Найдите и выберите Kilo Gateway (no key needed). Если есть поиск, введите Kilo. Пометка означает «ключ не нужен».
5. Ничего не вводите в поле ключа: для этого варианта оно недоступно.
6. Нажмите Enable — «Включить».

Результат: окно закрывается, Kilo Gateway появляется среди подключённых источников на странице Keys. Теперь проверим, отвечает ли он.

Если Kilo отсутствует или не отвечает, можно таким же способом попробовать OVH AI Endpoints (no key needed), если он есть в списке. Сервисы без этой пометки могут требовать регистрацию и отдельный ключ. Это дополнительный, не обязательный путь: как получить ключ OpenRouter.

Пометка unchecked означает «ещё не проверено», а не обязательно поломку. Сначала задайте вопрос по шагу 3. В нашем тесте достаточно было одного источника; цепочки моделей вручную не настраивали.

Где взять ключ для подключения другой программы?

1. На странице Keys нажмите вкладку Unified API key — «Единый ключ».
2. Найдите скрытую точками строку и нажмите Copy — «Скопировать».
3. Вставляйте ключ только в настройки своего инструмента. Не отправляйте его в чат и не показывайте посторонним.

Для общения прямо в FreeLLMAPI копировать ключ не нужно.

Шаг 3. Как задать первый вопрос?

1. В верхнем меню нажмите Playground — это чат для проверки нейросети.
2. Справа найдите Model. Оставьте Auto (fallback chain): программа выберет модель сама. Остальные настройки не меняйте.
3. Внизу нажмите поле Type a message… — «Введите сообщение».
4. Напишите: «Объясни простыми словами, что такое нейросеть. Ответь в двух предложениях».
5. Нажмите Enter на клавиатуре.
6. Дождитесь ответа. Не отправляйте вопрос много раз подряд: бесплатные источники могут отвечать медленно.

Результат: появляется ответ, а под ним — название модели и время. Если видите только свой вопрос, ответ ещё не получен. При ошибке воспользуйтесь подсказками в конце статьи.

В этом тесте был включён только Kilo Gateway. На запрос об API пришёл русский ответ от nvidia/nemotron-3.5-lightning:free; интерфейс показал 20 506 мс и 1 fallback. Это подтверждает конкретный маршрут в момент проверки, но не стабильную скорость, будущую бесплатность или качество работы агента с инструментами.

Если ответ появился — настройка для общения завершена! Можно задавать вопросы прямо здесь. Попробуйте «Предложи пять идей постов для моей темы» или «Объясни этот текст проще». Не вставляйте пароли и данные клиентов.

Шаг 4. Как пользоваться дальше?

Для обычного общения оставайтесь в Playground. Дальше ничего устанавливать не нужно. Следующие настройки нужны только для подключения другой программы.

Найдите в ней раздел подключения собственной нейросети. Если там есть поля Base URL, API key, Model, заполните их по таблице. Если полей нет, не вставляйте ключ в обычное сообщение чата — так подключение не работает.

Для локального клиента нужны три значения:

auto использует активную цепочку роутера. Для конкретной модели копируйте ID из своего каталога, а не из старого обзора. Совместимость с OpenAI означает формат API, а не доступ к платным моделям OpenAI.

import os
from openai import OpenAI
 
client = OpenAI(
    base_url="http://localhost:3001/v1",
    api_key=os.environ["FREELLMAPI_API_KEY"],
)
response = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Что такое API? Ответь кратко."}],
    max_tokens=150,
)
print(response.choices[0].message.content)

Как подключить Claude Code и не менять основной профиль?

FreeLLMAPI предоставляет Anthropic Messages API, который понимает Claude Code. Но Claude Code — клиент, а модель за ним может быть другой: подключение не превращает бесплатную модель в Claude Opus. Для серьёзной задачи отдельно оцените качество кода и работу инструментов. Базовый рабочий процесс описан в статье о разработке с Claude Code.

Нужны уже установленный claude, работающий роутер и поддерживаемый Node.js: текущий репозиторий указывает от 20.18 до версии ниже 25. Выберите актуальную LTS-версию в этом диапазоне. Для первой попытки предпочтителен разовый запуск:

Если Claude Code ещё не установлен, пропустите этот раздел: для чата в Playground он не нужен. Если уже пользуетесь Claude Code:

1. Оставьте FreeLLMAPI запущенным.
2. Откройте окно команд: на Windows — Пуск → PowerShell, на Mac — Программы → Утилиты → Терминал.
3. Введите node -v и нажмите Enter. Если появилась версия поддерживаемого диапазона — продолжайте. Если команда не найдена, установите подходящую LTS-версию с официального сайта Node.js, затем откройте окно команд заново.
4. Скопируйте следующую команду, вставьте её в окно команд и нажмите Enter. Если npx попросит разрешение установить пакет, проверьте название freellmapi и подтвердите вводом y и Enter.

npx freellmapi launch --url http://localhost:3001

Без --api-key CLI запросит единый ключ. launch передаёт credentials дочернему процессу и не сохраняет их в конфигурационный файл. Это не значит, что Claude Code вообще ничего не пишет на диск: история и собственные настройки клиента — отдельная тема.

5. Когда программа попросит API key, вернитесь в Keys → Unified API key → Copy, вставьте ключ в окно команд и нажмите Enter. При скрытом вводе символы могут не отображаться — это нормально.
6. Если предложен выбор инструмента, выберите Claude Code.
7. В открывшемся Claude Code задайте простую задачу без личных данных. Теперь отвечает модель подключённого источника, а не обязательно Claude. Этот запуск через CLI описан по документации; лично проверен ответ в Playground, а не работа Claude Code.

Чтобы вернуться к обычному Claude Code: закончите этот сеанс и откройте Claude Code привычным способом. Команда launch не переписывает его файл настроек.

npx freellmapi setup-claude --url http://localhost:3001 --profile learning --dry-run

npx freellmapi setup-claude --url http://localhost:3001 --profile learning
CLAUDE_CONFIG_DIR="$HOME/.claude/profiles/learning" claude

Как экономить токены и защитить данные?

Дешевле всего не отправлять лишний контекст. Давайте агенту одну ограниченную задачу, исключайте сборки, зависимости и большие логи из контекста, просите краткий ответ. Для новой темы начинайте новый диалог вместо переноса всей истории. Небольшой ответ уменьшает расход, но не компенсирует огромный входной промпт.

У FreeLLMAPI есть опциональная компрессия промптов и кеширование. Включайте их после базовой проверки: сокращение контекста может повлиять на смысл, а кеш не заменяет доступный провайдер. Режим fusion вызывает несколько моделей для синтеза ответа, поэтому не подходит как исходная стратегия экономии.

Ключи провайдеров шифруются в SQLite, но запросы всё равно уходят внешним сервисам. «Локальный роутер» не означает «локальная нейросеть». Не отправляйте персональные данные, закрытый код и клиентские документы, пока не изучили политики каждого включённого провайдера. Отдельно разобрал риски ключей в .env.example: удаление секрета из файла не отменяет утечку в истории Git.

Если что-то не получилось: что нажать и проверить?

Панель не открывается

1. Найдите FreeLLMAPI в Пуск или Программах и запустите.
2. Через его значок выберите Open Dashboard.
3. Если видите Connection refused, проверьте, что не вышли из самого приложения. Не меняйте случайные настройки сети.

Kilo нет в списке или он не отвечает

1. Откройте Keys → Add key → Platform.
2. Посмотрите, есть ли OVH AI Endpoints (no key needed). Если есть, выберите его и нажмите Enable.
3. Вернитесь в Playground и отправьте один короткий вопрос.
4. Если оба источника недоступны, бесплатного ответа сейчас может не быть. Попробуйте позже или подключите свой ключ по отдельной инструкции. Покупка Premium не гарантирует устранения этой ошибки.

Появилась ошибка 429 или сообщение о лимите

Это означает, что запросов сейчас слишком много. Не нажимайте отправку повторно десятки раз. Подождите восстановления квоты: время зависит от сервиса. Бесплатный доступ не безлимитный.

Появилась ошибка 401

Если она в другой программе, заново скопируйте ключ через Keys → Unified API key → Copy и вставьте в её поле API key. Не используйте вместо него ключ отдельного провайдера. Если ошибка остаётся, источник тоже может требовать проверку доступа.

Хочу попросить помощи

Сохраните текст ошибки и название шага, на котором остановились. На скриншоте скройте ключи, email и личные данные. Для важных клиентских задач бесплатный источник без гарантий не должен быть единственным вариантом.

Источники и дальнейшее чтение

Материал написан самостоятельно, а не переведён из чужого руководства. Цены и команды привязаны к дате публикации; каталог меняется быстрее статьи.

• Официальный репозиторий FreeLLMAPI — назначение, лицензия и ограничения.
• Установка и хранение credentials — desktop, Docker, сохранение данных.
• API reference — маршрутизация и доступность моделей.
• Инструкции CLI и исходники запуска — launch, --dry-run, профили.
• Официальный сайт и тарифы — $19 в год и $49 lifetime за live-каталог.

Если только знакомитесь с инструментами, начните с вариантов бесплатного вайбкодинга. Практическая цель первого запуска здесь скромнее «полностью заменить платный AI»: подключить один источник, понять его лимиты и безопасно попробовать знакомый клиент через собственный роутер.