Playbooks · Coding tasks
free-claude-code: one proxy, 61 providers
Written November 13, 2026
A local proxy points 12 coding harnesses at 61 model providers, free tiers included. The pitch, the licence, and the terms risk, in the repo's own words.
What it is
free-claude-code (FCC) is a local proxy that sits between a coding tool and a model provider. The project README leads with the routing claim: route any supported client to models from any supported provider. The client keeps its interface and its workflow; the model answering can come from somewhere else entirely. The README also states, up front, that FCC is an independent open-source project, not affiliated with or endorsed by Anthropic.
The two lists
The README counts 12 supported clients: Claude Code, Codex, Pi, OpenCode, Cline, Hermes, DeepSeek Harness, Grok Build, Muse Code, Aider, Antigravity CLI, and VS Code Chat. Each gets its own launcher — fcc-claude, fcc-codex, fcc-opencode, and so on — after the proxy is installed and started with fcc-server.
On the other side sit 61 supported providers, spanning free, paid, subscription, and local options. The catalogue runs from NVIDIA NIM, OpenRouter, Groq, and Google AI Studio through Anthropic and OpenAI themselves, down to local backends. The quick start walks a new user through one path: install, start the server, add an NVIDIA NIM key in the Admin UI, leave the default model or pick another, and start the agent. Other Chat Completions clients can point at the proxy's local address, http://127.0.0.1:8082/v1, as an OpenAI-compatible base URL.
The pitch, attributed
Two numbers headline the project, and both are the project's own claims. The README advertises 1.3B+ free tokens per month, aggregated across provider free tiers. It also claims up to 90% lower token usage through two bundled tools, RTK and Headroom. Neither figure is a measurement anyone else publishes, and the README hedges the first one itself: free-tier availability and limits are controlled by each provider and may change. The reliability list is more concrete — automatic retries, configurable rate limits and concurrency control, and fallback across models, providers, and multiple API keys.
Where it runs, and what fallback costs
The client side is not tied to a terminal. The README lists use through desktop apps such as the Codex App and Claude Desktop, IDE extensions in VS Code and JetBrains, a phone through Discord and Telegram (voice notes included), and the browser through native Code sessions. The routing decision is made once, in the proxy, and every connected client draws on the same provider catalogue.
Fallback deserves a second look before you rely on it. The README's provider section warns that a failed request may reach and consume usage from more than one provider before succeeding. Automatic fallback keeps a session alive through an outage; it can also spend quota at two or three providers on a single hard request. Provider keys are managed in the Admin UI with numbered key rows, and FCC works through them in order, which makes the order you enter keys a small but real cost decision.
The licence and the terms risk
FCC is released under the AGPL-3.0-only licence. Teams that modify and redistribute copyleft code will want that fact early, not late.
The sharper risk sits in one README sentence about provider terms: "FCC follows provider TOS and removes integrations if they stop being allowed." Read it as the author intends. An integration your workflow depends on can disappear from the proxy when a provider's terms stop allowing it — removed by the project itself, as a matter of its stated policy. A routing layer also means the model doing your coding is whichever provider you selected, with that provider's limits, data terms, and failure modes. The proxy is one install; the arrangement behind it is 61 separate ones.
Related playbooks
- Antigravity removes free Claude models Nov 18
- Vera: unlimited AI code review, free at every tier
- Check a Cursor machine for the tampered Claude Code extension
- Claude Code 2.1.319: unattended runs stop stalling
Sources
Back to: Coding playbooks hub · Also: Claude Code 2.1.321: Fable 5.2 is default