Alishahryar1/free-claude-code
A local proxy that lets coding AI agents run on 49 free or cheap model providers instead of one paid service
free-claude-code (FCC) sits between coding agents like Claude Code, Codex, Pi, and OpenCode and swaps their requests to whichever AI model provider you actually configured, instead of the original paid backend. It draws from 49 providers offering over 1.3 billion free tokens (units of text a model processes) per month, all picked through a web-based Admin UI, and works the same way across terminal, VS Code, JetBrains, Discord, Telegram, and voice input. If a provider goes down, FCC automatically retries and falls through to the next configured model without restarting your work.
What it does
- Runs nine coding agents (Claude Code, Codex, Pi, OpenCode, Cline, Hermes, DeepSeek Harness, Grok Build, Muse Code) against one shared model catalog
- Connects to 49 providers such as NVIDIA NIM, OpenRouter, Groq, DeepSeek, Gemini, and local Ollama by entering an API key in the Admin UI
- Supports an ordered fallback model list so a failed request retries and moves to the next provider instead of stopping your session
- Cuts terminal-output tokens sent to the model by up to 90% using an optional tool called RTK plus FCC's own optimizations
- Adds voice-note support via local Whisper or NVIDIA NIM transcription so you can talk to the agent instead of typing
Why it matters
For developers who want to use AI coding assistants without paying per token, this removes the manual work of wiring up multiple free APIs and keeps coding sessions alive through provider outages. It's built around following each provider's terms of service, aiming to reduce the risk of account bans rather than bypass them.
Terms in this repo
- token · the basic unit of text a language model counts and processes per request
- proxy · a middle server that intercepts and forwards requests between a client and the real backend
- Admin UI · the web dashboard used to configure FCC's providers and settings
- ToS (Terms of Service) · the usage rules set by each provider; breaking them can get an account suspended
- fallback models · a backup list of models FCC tries automatically if the primary one fails
Repository description (English)
Use Claude Code, Codex, Pi, and OpenCode for free (1.3B+ free tokens) from your terminal, app, IDE, or phone like OpenClaw (voice supported + ToS friendly)
Open on GitHubTrending repos
- vorssaint/vorssaint-utilsOne free menu bar app replaces a dozen paid Mac utilities
- freestylefly/awesome-gpt-image-2A library of 532 reverse-engineered prompts that turn GPT-Image2 into a predictable image-making tool
- block/buzzAn open-source workspace where humans and AI agents chat, code, and review in the same rooms
- NousResearch/hermes-agentNous Research's Hermes is an AI agent that gets smarter the more you use it
- virgiliojr94/book-to-skillA tool that turns technical book PDFs into on-demand reference skills for AI coding agents
- VoltAgent/awesome-agent-skillsA single hub collecting over 1000 'how-to' manuals that make AI coding assistants act like experts
- anthropics/claude-plugins-communityA shared shelf where anyone's Claude add-ons get listed for install
- Comfy-Org/ComfyUIA drag-and-connect tool that lets you build image, video, and audio AI pipelines without writing code