
👁 0 views
Free Claude Code (FCC) is an open-source proxy that connects the Claude Code interface to models from providers such as NVIDIA NIM, OpenRouter and Groq, or to local models served by Ollama, LM Studio or llama.cpp. You can try this setup with a provider that offers free usage, subject to its current quota and rate limits.
Table of contents 7 items
What is Free Claude Code?
FCC is an independent Python project distributed under AGPL-3.0. It uses the uv package manager and is unaffiliated with Anthropic. Claude Code supplies the coding interface while your selected provider supplies the model. Using an alternative provider does not grant free access to Anthropic’s Claude models. FCC also supports clients such as Codex, OpenCode, Cline and Aider. Project documentation.
How the FCC proxy works
FCC listens locally, typically at http://127.0.0.1:8082. Claude Code sends a request to FCC, which converts it to the selected provider’s format and translates the response back for the client, including streaming and tool calls where supported.

You can set a default model with MODEL and optional tier overrides with MODEL_OPUS, MODEL_SONNET and MODEL_HAIKU. Fallbacks and retries may consume quota on several providers during one request. Set rate limits that suit your account.
Supported model providers
- Cloud: NVIDIA NIM, OpenRouter, Groq, Cerebras, SambaNova, Gemini, DeepSeek, Mistral and others. Some offer limited free access. Check the terms and pricing of the specific model before use.
- Local: Run Ollama, LM Studio or llama.cpp on your own machine. FCC uses prefixes such as
ollama/,lmstudio/andllamacpp/. Choose a model with tool calling and enough context for code and tool descriptions.
How to set up Free Claude Code with NVIDIA NIM
1. Install FCC
Review the installer scripts linked in the project’s Quick Start before running them. On macOS or Linux, use Terminal. On Windows, use PowerShell. Select Claude Code when prompted. The installer can fetch the official Claude Code client if it is missing. Optional components such as RTK and Headroom aim to reduce token usage, with results depending on the workload.
curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1")))
2. Start the FCC server
Open Free Claude Code from Start or the desktop on Windows, or from Applications on macOS. On Linux, run fcc-server and keep the terminal open. Use the Admin UI address shown in the server log.
3. Add an NVIDIA NIM key and select a model
- Sign in to NVIDIA and create a key on its API Keys page.
- In FCC, open Providers → NVIDIA NIM → Add key. Add the key and save it.
- Choose a model available to your account, then click Apply. Enable Proxy Authentication if you need to restrict access.


4. Launch Claude Code and choose a model
Run fcc-claude and enter /model in Claude Code. FCC also provides launchers such as fcc-codex, fcc-opencode and fcc-aider. For troubleshooting, run fcc-doctor and redact credentials before sharing logs. Stop FCC before running fcc-update.


What to check before using FCC
- Limits and cost: Free quotas and rate limits vary by provider and can change. Check the account dashboard before relying on a free tier.
- Model quality: Test tool calls, code changes and multi-step tasks on a small project. Results depend on the model you choose.
- Source code and privacy: A cloud provider can receive source snippets and tool outputs included in requests. Review its terms and data policy. A local model can keep inference on-device when the entire workflow uses local services.
- Support: FCC is community-maintained. Use its issue tracker for proxy problems and consult the license before redistributing modified versions.
Who is Free Claude Code for?
It can suit students learning to work with coding agents, developers comparing models through one client, and users experimenting with local inference. For work with strict uptime or data handling requirements, validate the provider and deployment against those requirements first.
Frequently asked questions
Does FCC give me free access to Claude models?
To use Anthropic’s Claude models, you still need authorized access through your provider. FCC connects the client to the model you configure.
Is NVIDIA NIM free to use with Claude Code?
Availability and quotas depend on your NVIDIA account and the selected model. Check your account before starting.
Do I need Claude Code installed first?
The FCC installer can install the official client when you select Claude Code during setup.
Can I work offline?
Local inference can run offline after you have installed the tools and downloaded the model. Installation, updates, and any cloud-backed features need a connection.
Where does my source code go?
A cloud provider receives the context included in requests. For sensitive work, verify the exact model endpoint, any fallback providers and the tools you enable.