49 тысяч звёзд за подмену одного адреса: разбираем Free Claude Code

За обещанием «пользоваться Claude Code бесплатно» скрывается проект, собравший 49,2 тысячи звёзд и 8 тысяч форков — Free Claude Code, он же FCC, открытый код под MIT. Доступа к моделям Anthropic он, впрочем, никакого не открывает. Устроено иначе: на машине поднимается прокси, написанный на Python, агенту подсовывается другой адрес API, и трафик уходит к сторонним поставщикам — DeepSeek, Groq, OpenRouter, NVIDIA NIM, Kimi, Cerebras, Mistral, Ollama, список длинный.

Ниже — из чего складывается эта подмена, где в схеме заканчивается бесплатное и какую цену за него берут.

Две переменные окружения — и весь фокус

Официальный скриншот проекта объясняет механику лучше любого абзаца:

$env:ANTHROPIC_BASE_URL="http://localhost:8082"; $env:ANTHROPIC_AUTH_TOKEN="ccnim"; claude

Хождение в api.anthropic.com для клиента Claude Code не обязательно — на этой же способности построены штатные интеграции с Amazon Bedrock и Google Vertex AI. Место такого бэкенда и занимает FCC: на localhost:8082 слушает сервер, понимающий протокол Anthropic API, забирает запросы агента и перекладывает их выбранному поставщику. Токен авторизации годится любой — сверяет его локальный прокси, Anthropic тут не участвует.

В VS Code то же самое прописывается настройками расширения, где всплывает ещё несколько переменных:

"claudeCode.environmentVariables": [
  { "name": "ANTHROPIC_BASE_URL", "value": "http://localhost:8082" },
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "freecc" },
  { "name": "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY", "value": "1" },
  { "name": "DISABLE_AUTOUPDATER", "value": "1" },
  { "name": "DISABLE_ERROR_REPORTING", "value": "1" }
]

Именно CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY наполняет штатный пикер /model чужим каталогом. Судя по скриншоту авторов, позиций там за пять сотен, каждая помечена как «From gateway».

Последние строчки конфига тоже показательны: гасятся автообновление, отчёты об ошибках и команда обратной связи. Для работы через посторонний бэкенд решение объяснимое, но помнить о нём стоит — сам себя клиент обновлять перестанет.

Не только Claude Code: девять агентов на одном каталоге

Одним лишь Claude Code дело не ограничено. К тому же прокси цепляются Codex, Pi, OpenCode, Cline, Hermes, DeepSeek Harness, Grok Build и Muse Code, у каждого свой запускающий скрипт — fcc-claude, fcc-codex, fcc-opencode и так далее. Codex настраивается через ~/.codex/config.toml, куда добавляется секция [model_providers.fcc] с base_url = "http://127.0.0.1:8082/v1".

Поставщики заводятся в локальной админке. Поимённо перечислено порядка тридцати: NVIDIA NIM, OpenRouter, Google AI Studio и Vertex AI, DeepSeek, Mistral, Amazon Bedrock, Hugging Face, Cohere, GitHub Models, Kimi, MiniMax, Cerebras, Groq, SambaNova, Fireworks, Cloudflare Workers AI, Z.ai, а также локальные Ollama, LM Studio и llama.cpp. Заявлено при этом полсотни поставщиков и «свыше 1,3 млрд бесплатных токенов ежемесячно» — величина эта суммарная, по всем бесплатным тарифам сразу, и сам README сразу уточняет, что лимитами распоряжаются поставщики и меняться те могут когда угодно.

Настройка бывает и потоньше. Переменные MODEL_FABLE, MODEL_OPUS, MODEL_SONNET, MODEL_HAIKU разводят уровни моделей Claude Code по разным бэкендам: тяжёлое считает одна модель, рутину — другая.

Переключение на лету, ради которого всё и затевается

Самое ценное с инженерной точки зрения спрятано в одном предложении описания. В разделе Model Config составляется упорядоченный перечень Fallback Models; когда попытки достучаться до текущего поставщика исчерпаны, FCC берёт следующую модель из списка прямо посреди хода — сессию перезапускать не нужно, контекст задачи не теряется.

Всякий, кто запускал агентов на бесплатных тарифах, оценит: 429 и пятисотые сыплются оттуда регулярно, а означает это обычно рефакторинг, оборванный на середине. Отдельно обещана экономия на выводе команд — необязательный RTK вычищает типовой мусор из терминала, по заявлению проекта до 90 % токенов.

Установка и обратная дорога

Ставится одной строкой, и вот здесь curl | sh заслуживает меньшей нервозности, чем обычно. Скрипт занимает 1329 строк, прав root не просит, раскладывает всё по пользовательскому профилю и печатает каждую команду перед выполнением. Прочитать установщик заранее авторы предлагают сами — совет здравый.

curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh

Настройки хранятся в ~/.config/free-claude-code/.env и ~/.fcc/, сервер стартует командой fcc-server, версию покажет fcc-server --version. Парный скрипт удаления убирает сам FCC вместе с каталогом ~/.fcc/, однако не трогает поставленные агенты, uv, Python и добавленные записи PATH — Claude Code, Codex и остальных вычищать придётся вручную.

Во что обходится бесплатное

Дальше — аккуратнее с формулировками про ToS. Проект утверждает, что «следует условиям поставщиков и убирает интеграции, если те перестают быть разрешёнными», и прямо заявляет об отсутствии аффилиации с Anthropic. Заметьте: говорится про условия поставщиков моделей. Укладывается ли сам сценарий в условия использования клиента Claude Code — вопрос иной, и разбираться с ним каждому придётся самостоятельно, по актуальным условиям, а не по README стороннего проекта.

Наконец, про долговечность. Открытых issue — 238, открытых pull request — 107 при 969 коммитах: проект и живой, и с ощутимым завалом одновременно. Бесплатные тарифы перекраиваются чаще, чем выходят релизы, так что конфигурацию придётся время от времени пересобирать заново.

Источники

• Alishahryar1/free-claude-code — репозиторий проекта
• README проекта
• install.sh — установщик, который стоит прочитать до запуска
• Документация Claude Code

Цифры по звёздам, форкам, issue и коммитам — со страницы репозитория на 25 августа 2026 года.