Вайбкодинг · free-claude-code × Claude Code · установка по шагам
Гоняй Claude Code бесплатно, пока другие платят Anthropic за каждый токен
Открытый код, лицензия MIT, около 40 тысяч звёзд на GitHub. Обычно за каждый запрос к Claude ты платишь Anthropic, и на экспериментах счёт капает. А рядом лежит способ гонять тот же Claude Code бесплатно, через открытые модели. Ниже разложу по шагам: что нужно до старта, какую команду вставить, где взять бесплатный ключ, что увидишь и как этим пользоваться. Без терминальной магии, понятно человеку, который открывает это впервые
Что это за штука
Прокси-обманка: Claude Code думает, что это Anthropic, а под капотом бесплатная модель
Claude Code это Claude, который живёт прямо в редакторе кода и сам пишет тебе проекты. Каждый его ответ идёт через серверы Anthropic и стоит денег. free-claude-code это маленький посредник, который ставится на твой компьютер между Claude Code и моделью. Прокси значит «посредник»: все запросы идут через него, а он решает, кому их отдать
Фокус в подмене. Claude Code думает, что говорит с Anthropic, а посредник тихо перенаправляет запрос на бесплатную открытую модель, например через сервис NVIDIA. Оболочка, команды, агенты, привычный вид, всё то же самое, а счёт за токены обнуляется. Провайдер это как раз тот, кто даёт модель: у free-claude-code на выбор 24 провайдера, мы возьмём бесплатный NVIDIA. Проект открытый, около 40 тысяч звёзд и свободная лицензия MIT. Ставим по шагам, всё почти одной командой
Шаг 0 · что нужно до старта
Сначала на компьютере должны стоять Claude Code и Node.js
free-claude-code это посредник, ему нужно, к кому подключаться. Значит сам Claude Code (это Claude, встроенный в редактор кода VS Code, как программа на компьютере) уже должен стоять. Если его нет, поставь сначала его, это один вечер и без программирования
Ещё нужен Node.js. Это среда, в которой крутятся многие инструменты разработчика, на ней же доустанавливаются сами агенты Claude Code. Скачивается с сайта nodejs.org в пару кликов. А вот про Python можно не думать: установщик free-claude-code часть нужного (Python и утилиту uv) докачает сам, тебе руками ставить их не придётся
Если Claude Code ещё не стоит
У меня есть отдельный гайд: скачать, оплатить российской картой и запустить за один вечер, всё по скриншотам
Установить Claude Code с нуляClaude Code и Node.js на месте? Тогда поехали обнулять счёт
Шаг 1 · вот он, репозиторий
Открой страницу проекта на GitHub
GitHub это склад открытого кода, туда выкладывают такие проекты. Зайди на страницу по адресу github.com/Alishahryar1/free-claude-code. Там видно число звёзд (столько людей отметили проект полезным), лицензию и инструкцию. Так выглядит её шапка:
Локальный прокси, который подсовывает Claude Code бесплатные открытые модели
Шаг 2 · ставим инструмент
Одна команда в терминал, дальше установщик всё докачает сам
Открой в VS Code встроенный терминал (верхнее меню Terminal → New Terminal). Вставь команду ниже и нажми Enter. Это официальный установщик проекта: он сам скачает недостающее (Python, утилиту uv) и разложит free-claude-code на компьютер. Если у тебя Mac или Linux, бери первую команду, если Windows, вторую
# ставим free-claude-code (macOS / Linux)
curl -fsSL "https://github.com/Alishahryar1/free-claude-code/blob/main/scripts/install.sh?raw=1" | sh
# ставим free-claude-code (Windows PowerShell)
irm "https://github.com/Alishahryar1/free-claude-code/blob/main/scripts/install.ps1?raw=1" | iex
Прежде чем вставлять, прочти
Эта команда качает установщик и запускает его у тебя на компьютере, то есть ставит инструмент себе. Такое всегда бери только с официальной страницы проекта, чтобы видеть первоисточник, а не из случайного поста в чате. Оригинал команды и код лежат вот тут: github.com/Alishahryar1/free-claude-code
Что увидишь
Установщик прогонит несколько строк, доустановит недостающее и в конце напишет, что готов. После этого у тебя в терминале появятся две новые команды: fcc-server и fcc-claude, с ними и работаем дальше
Шаг 3 · поднимаем посредника
Запусти прокси одной командой
Теперь включим самого посредника. В том же терминале набери команду ниже и нажми Enter. Она поднимет прокси и не даёт терминалу закрыться, так и должно быть, окно занято работой
# поднимаем прокси
fcc-server
Что увидишь
В логах (это те строки, что бегут в терминале) появится адрес панели настройки, обычно http://127.0.0.1:8082/admin. Это Admin UI, локальная панель управления посредником. Локальный адрес значит, что она крутится только на твоём компьютере, наружу ничего не уходит. Скопируй этот адрес, он понадобится на Шаге 5
Шаг 4 · берём бесплатный ключ
Получи бесплатный ключ NVIDIA, чтобы было чем платить за токены вместо тебя
Модель кто-то должен считать, у нас это бесплатный сервис NVIDIA. Чтобы он пускал наши запросы, нужен ключ API. Ключ API это как пароль-пропуск: длинная строка, по которой сервис узнаёт, что это ты, и отдаёт ответы. Берётся он бесплатно, по шагам:
- 01
Заведи аккаунт на build.nvidia.com
Открой в браузере build.nvidia.com и зарегистрируйся, обычной почтой. Это бесплатно
- 02
Подтверди телефон
NVIDIA попросит номер телефона и пришлёт код. Это разовая проверка, что ты живой человек, без неё ключ не выдадут
- 03
Создай ключ на странице ключей
Зайди на build.nvidia.com/settings/api-keys, нажми создать ключ и скопируй его. Он начинается с nvapi-, дальше длинная строка. Держи его под рукой, вставим на следующем шаге
Шаг 5 · вставляем ключ
Открой Admin UI и скорми ему ключ
Открой в браузере адрес панели из Шага 3 (http://127.0.0.1:8082/admin). Это и есть Admin UI, тут посредник настраивается кликами, без кода. Делай по порядку прямо в этом окне:
NVIDIA_NIM_API_KEY
Модель по умолчанию
- 01
Вставь ключ в поле NVIDIA_NIM_API_KEY
Найди в панели поле с подписью NVIDIA_NIM_API_KEY и вставь туда свой ключ, тот, что начинается на nvapi-
- 02
Нажми Validate
Кнопка Validate проверяет, что ключ рабочий. Панель сходит к NVIDIA и убедится, что тебя пускают. Если всё хорошо, покажет, что ключ принят
- 03
Нажми Apply
Кнопка Apply сохраняет настройку. Теперь посредник знает, куда отправлять запросы, и по умолчанию берёт модель nvidia_nim/…. Всё, обманка собрана
Как пользоваться
Запускаешь Claude Code через прокси и работаешь как обычно, только бесплатно
Прокси поднят и настроен. Теперь Claude Code запускаем не как обычно, а через посредника, для этого есть отдельная команда. Открой новый терминал (первый занят прокси из Шага 3), набери команду ниже и нажми Enter:
# запускаем Claude Code через прокси
fcc-claude
Откроется знакомый Claude Code, тот же вид и те же команды. Разница одна: запросы идут через открытую модель, а не через Anthropic, и счёт за токены не капает. Пиши ему задачи как всегда, собирай проекты, гоняй агентов
Захочешь сменить модель внутри, набери прямо в Claude Code команду /model, и он предложит выбрать другую из доступных. Так можно пробовать разные бесплатные модели и смотреть, какая тебе больше заходит
А если работаешь на платном Claude Code и просто хочешь меньше жечь токенов, а не обнулять счёт совсем, приёмы экономии собраны отдельно: Как экономить токены в Claude: рабочие приёмы и настройки
Чтобы не споткнуться
Ключ NVIDIA не принят: проверка телефона и опечатка при вставке
- 01
Сначала Claude Code, потом прокси
Посредник ставится поверх Claude Code, а не вместо него. Если Claude Code ещё не стоит, обманывать нечего. Не запускается или ругается на пустом месте, вернись к Шагу 0 и проверь, что Claude Code и Node.js на месте
- 02
Телефон для ключа NVIDIA обязателен
Без подтверждения телефона NVIDIA ключ не выдаст, а без ключа посредник платить за токены нечем. Если на Validate панель говорит, что ключ не принят, почти всегда дело в непройденной проверке телефона или в опечатке при вставке ключа
- 03
Бесплатное иногда медленнее, и это честно
Открытые модели через NVIDIA бесплатны, но у них бывают ограничения по скорости и по числу запросов в час, и по качеству они не всегда как платный Claude. Для учёбы, тестов и первых проектов этого за глаза, а на боевой продукт под нагрузкой лучше вернуться на платный Claude Code. Есть и другой путь к тем же бесплатным моделям, без прокси, прямо в терминале, разобран в статье Claude Code в терминале на бесплатных моделях: DeepSeek, GLM, Kimi
Первоисточник
Весь код, актуальные команды и список из 24 провайдеров лежат в открытом репозитории. Всегда сверяйся с ним, а не с пересказами:
github.com/Alishahryar1/free-claude-codeУчиться на повторах
Пробуешь и учишься без страха за счётчик
Поставить прокси это полдела, по шагам выше ты это сделаешь сегодня. А меняет он вот что: пока каждый запрос стоит денег, ты жмёшься, перечитываешь промпт по три раза, боишься лишний раз нажать. С бесплатной моделью этот тормоз пропадает, ты пробуешь смело, ломаешь, переделываешь, гоняешь агентов десятками заходов и просто учишься
Так вайбкодинг из «страшно и дорого» превращается в песочницу: сиди и лепи, пока не получится. Именно на таких повторах руки и запоминают, как собирать продукт, а не как экономить токены
Два разных финала
Отсюда расходятся два пути. Один - десяток брошенных экспериментов. Другой - готовый продукт
Счётчик токенов обнулён, Claude Code гоняешь сколько влезет. С этого места дорога у всех одна, только каждый идёт по ней сам
Без системы вокруг это превращается в десяток начатых и брошенных идей: попробовал, не дожал, начал другое. Свобода экономить не равна свободе довести дело до конца
Три бесплатных вечера Концентрата, 13-15 октября в 19:00 МСК: своя команда ИИ-агентов, шесть связок монетизации и контент-завод 3.0
Регистрация на сайте до 14 октября, участие бесплатное
Эту же связку, свободный Claude и свои проекты, я гоняю каждый день, и веду людей по шагам, которые проверил на себе, а не вычитал в чужом гайде
Занять место бесплатноРегистрация на сайте до 14 октября, участие бесплатное
Сохрани себе
Памятка по шагам
- 01 Заведи аккаунт на build.nvidia.com Открой в браузере build.nvidia.com и зарегистрируйся, обычной почтой. Это бесплатно
- 02 Подтверди телефон NVIDIA попросит номер телефона и пришлёт код. Это разовая проверка, что ты живой человек, без неё ключ не выдадут
- 03 Создай ключ на странице ключей Зайди на build.nvidia.com/settings/api-keys , нажми создать ключ и скопируй его. Он начинается с nvapi- , дальше длинная строка. Держи его под рукой, вставим на следующем шаге
- 01 Вставь ключ в поле NVIDIA_NIM_API_KEY Найди в панели поле с подписью NVIDIA_NIM_API_KEY и вставь туда свой ключ, тот, что начинается на nvapi-
- 02 Нажми Validate Кнопка Validate проверяет, что ключ рабочий. Панель сходит к NVIDIA и убедится, что тебя пускают. Если всё хорошо, покажет, что ключ принят
- 03 Нажми Apply Кнопка Apply сохраняет настройку. Теперь посредник знает, куда отправлять запросы, и по умолчанию берёт модель nvidia_nim/… . Всё, обманка собрана
- 01 Сначала Claude Code, потом прокси Посредник ставится поверх Claude Code, а не вместо него. Если Claude Code ещё не стоит, обманывать нечего. Не запускается или ругается на пустом месте, вернись к Шагу 0 и проверь, что Claude Code и Node.js на месте
- 02 Телефон для ключа NVIDIA обязателен Без подтверждения телефона NVIDIA ключ не выдаст, а без ключа посредник платить за токены нечем. Если на Validate панель говорит, что ключ не принят, почти всегда дело в непройденной проверке телефона или в опечатке при вставке ключа
Куда идти дальше
Следующий шаг
Регистрация на сайте до 14 октября, участие бесплатное