mrkeyoor.com_
Tue 03 Nov 07:17 UTC
AI Toolsevaluationupdated 30 Sept 2026

free-claude-code review

Free Claude Code is a local proxy and control panel that connects Claude Code, Codex, and other coding agents to cloud or local model providers. It gives you one model catalog, fallback routing, and client launchers, but it does not turn paid models into free services or remove provider quotas.

+1,315stars / 7d
Verdict

Our Free Claude Code run installed 116 packages and built in 8 seconds, but its test command failed before collection because pytest_asyncio was missing. Use it if keeping familiar coding clients while switching providers is worth running a local control plane and checking each provider yourself. Skip it when you need a green fresh-container suite, a permissive license, or guaranteed access to a particular paid model.

We ran it

Lab card: what happened when we ran free-claude-codeScreenshot of free-claude-code (github.com/Alishahryar1/free-claude-code)
Install✓ · 42s116 packages · 180 MB
Build✓ · 8s
Tests✗ · 7sran, no count parsed
Known vulns0(pip-audit)
Repo913 files~213,909 lines of source · 11.4 MB · 4 CI workflows · tests dir

Answers from our run

Does free-claude-code build from source?

Dependencies installed in 42 seconds (116 packages), and the build succeeded in 8 seconds. We cloned commit 105bfab into a clean Debian container with 3 CPUs and no project-specific setup.

Do free-claude-code's tests pass?

No. The project's own test command exited unsuccessfully after 7 seconds, and its output did not expose an individual test count.

Does free-claude-code have known vulnerabilities in its dependencies?

pip-audit found none in the dependency tree at the time of our run.

Who should not use free-claude-code?

Release pipelines that require a green suite in a fresh container: our test command stopped before collection because pytest_asyncio was missing.

What are the alternatives to free-claude-code?

Claude Code Router, LiteLLM, OpenCode. Our Free Claude Code run installed 116 packages and built in 8 seconds, but its test command failed before collection because pytest_asyncio was missing.

Setup3/542-second install, but the fresh-container test command failed
Docs4/5Clear client, provider, local model, update, and uninstall paths
Community5/556,262 stars and same-day release and issue activity
Maturity3/5v6.5.11 is active, but our supplied suite did not collect

Who it’s for

Developers who want to keep Claude Code or Codex while choosing among cloud, subscription, and local models.
People who need one local model catalog and ordered fallbacks across several coding agents.
Tinkerers willing to manage provider keys, model compatibility, and a Python 3.14 service.
Teams that can review the AGPL-3.0-only terms before modifying or hosting the proxy.

Who it’s NOT for

Release pipelines that require a green suite in a fresh container: our test command stopped before collection because pytest_asyncio was missing.
Environments pinned to another Python line: commit 105bfab declares an exact Python 3.14.7 requirement.
Organizations that cannot accept AGPL-3.0-only obligations for modified network services.
Users expecting paid Anthropic models or stable free quotas at no charge: the README says availability and limits remain under each provider's control.
Anyone who wants a small, single-purpose adapter: the checkout held 913 files and about 213,909 source lines.

Setup reality

Our sandbox installed commit 105bfab in 42 seconds, pulling 116 packages and using 180 MB. The build passed in 8 seconds. Tests failed with exit 4 after 7 seconds because tests/conftest.py could not import pytest_asyncio. Pip-audit found 0 known vulnerabilities.

Running FCC still needs at least one usable provider or a local model server. Cloud routes take provider keys or OAuth connections, local routes need LM Studio, llama.cpp, or Ollama, and messaging adds bot credentials plus an allowed directory. Proxy authentication is optional but should be enabled when the service is reachable beyond your machine.

Commit 105bfab requires Python 3.14.7 and uv 0.12.13 or newer. The repository has no Dockerfile, so containers are your responsibility. Desktop launchers target Windows and macOS, while Linux users keep fcc-server running in a terminal.

One proxy keeps familiar coding clients while models change

Free Claude Code sits between a coding agent and the model service that answers it. You keep using Claude Code, Codex, Pi, OpenCode, Cline, Hermes, Aider, or another supported client, while FCC translates requests for the selected provider. Its Admin UI handles model choice, provider settings, tier routing, and ordered fallbacks. That is useful if the client workflow is settled but the model source is not.

The README currently lists 56 providers and 11 coding agents. That breadth includes API services, subscription connections, and local servers rather than 56 interchangeable free endpoints. FCC's headline claim of more than 1.3 billion free tokens per month is an aggregate of provider allowances. The same README says availability and limits can change, so treat the catalog as a set of routes to verify, not a monthly entitlement.

Python 3.14.7 and provider accounts are real prerequisites

The quick install script sets up FCC, prompts for coding agents, and can add optional RTK support. Afterward, fcc-server opens the Admin UI on Linux, while Windows and macOS get desktop launchers. The configuration is approachable for a personal workstation. It becomes more involved once several clients, fallback models, and messaging channels share the proxy.

At commit 105bfab, pyproject.toml requires exactly Python 3.14.7 and uv 0.12.13 or newer. Cloud providers need their own keys, OAuth session, or subscription. Local choices need a running LM Studio, llama.cpp, or Ollama server. The code is AGPL-3.0-only, a material constraint for companies that plan to modify it and expose that version over a network.

What happened when we ran it

Our sandbox installed commit 105bfab in 42 seconds, adding 116 packages and using 180 MB on disk. The build succeeded in 8 seconds. This was a fresh unprivileged Debian container with 3 CPUs, 8 GB of RAM, Python 3.12 in the base image, and no secrets. Pip-audit reported 0 known vulnerabilities.

The test step failed with exit 4 after 7 seconds. Pytest stopped while loading tests/conftest.py, where importing pytest_asyncio raised ModuleNotFoundError. The log contained no collected or passing test count, so the accurate finding is that the supplied test command did not reach collection in our environment. The log does not establish why the module was absent, and we will not turn that single line into a broader diagnosis.

The checkout itself was substantial: 913 files, roughly 213,909 source lines, and 11.4 MB before installation. Four CI workflow files and a tests directory were present, but there was no Dockerfile. A fresh container still needs a dependency path that produces the environment those tests expect, despite the repository's visible automation and tests.

Free routes still carry quotas, compatibility limits, and bills

FCC does not supply the models. A selected route may be a free allowance, a paid API key, a subscription connection, or your own local server. The model picker can show choices your account cannot use, and an ordered fallback may consume usage from more than one provider before a request succeeds. Budget controls therefore belong at the provider account as well as in the proxy.

The compatibility layer is the main reason to use the project. It preserves streaming, tools, images, and model-tier mapping across clients that normally expect different back ends. That promise also creates a wide test surface. Open issue 1797 reports a selected model becoming unavailable on NVIDIA NIM, while issue 1910 reports Claude Desktop connectors failing through FCC. These reports do not prove universal faults, but they identify integrations to test with your exact account and client.

Remote messaging needs a smaller trust boundary than the default demo

Discord and Telegram support can turn a phone message into work inside an allowed directory. The setup requires a bot token, an allowlist, and filesystem access for the agent. FCC also offers proxy bearer authentication. Those controls matter because this is not a read-only chat relay: the connected coding agent can inspect and change files within the access you give it.

Local providers reduce dependence on hosted APIs, but they do not remove setup work. The documented defaults point LM Studio at port 1234, llama.cpp at 8080, and Ollama at 11434. You still need a tool-capable model with enough context for the client's system prompt and tool definitions. FCC can route to that model, but it cannot make an undersized model behave like the client expects.

A September 30 release shows speed, while 296 open items show load

GitHub showed 56,262 stars, 8,996 forks, and 296 combined open issues and pull requests on September 30, 2026. The repository was pushed that morning, and v6.5.11 shipped the same day. Open pull requests and issue updates from that date show active maintenance rather than a project living on an old release badge.

The pace cuts both ways. Provider APIs, model names, coding clients, and authentication flows all move independently, so some of FCC's 296 open items are the cost of spanning that many boundaries. Use the project for its central bargain: keep the agent interface you like while changing the service behind it. Our failed collection means you should prove the test environment, one chosen provider, and one chosen client before making FCC part of daily work.

Alternatives

ProjectWhat it isPick it when
Claude Code Router gh↗A narrower local routing layer for using different models with AI coding agents.pick this instead when routing is the job and you do not need FCC's desktop, messaging, and browser features.
LiteLLM gh↗An LLM gateway and SDK with provider routing, budgets, and operational controls.pick this instead when a team-wide API gateway matters more than launchers for individual coding agents.
OpenCode gh↗An open-source coding agent with its own terminal and desktop experience.pick this instead when you can change the coding client and want fewer moving parts than a compatibility proxy.

What people are saying

  1. [github-trending] Alishahryar1/free-claude-code

Sources

  1. Free Claude Code README
  2. Free Claude Code v6.5.11 release
  3. Open issue 1797: selected model access
  4. Open issue 1910: Claude Desktop connectors

More ai tools reviews

kornia · skills · anarlog · pr-agent · agent-sprite-forge · KiroCrew · the whole board →

Related reading