Repolode
Submit
Alishahryar1

Alishahryar1/free-claude-code

A local proxy that lets Claude Code, Codex, and other coding agents run on free or alternative model providers from your terminal, IDE, browser, or chat apps.

Open-source alternative to:Claude Code

View on GitHub
Stars
66,919
Forks
10,408
Open issues
310
Last commit
yesterday

What is it?

Free Claude Code (FCC) is a local proxy server that routes requests from coding agents to a wide range of model providers. Agents such as Claude Code, Codex, Pi, OpenCode, Aider and Cline can be pointed at models from providers including NVIDIA NIM, OpenRouter, Groq, Gemini, DeepSeek and local servers like Ollama, LM Studio and llama.cpp, all managed from a single Admin UI.

The project targets developers who want to keep using familiar coding agent tools without paying for a single vendor's model access. It includes automatic fallback to a configured next model when a provider fails, per-tier model routing for Claude Code's Opus, Sonnet and Haiku settings, and optional token reduction through RTK and Headroom. Clients can be connected through VS Code, JetBrains, Claude Desktop, Discord or Telegram, and voice notes can be transcribed with Whisper or NVIDIA NIM.

Installation uses shell or PowerShell scripts, with launchers such as fcc-claude and fcc-codex for each supported agent. The project is licensed under AGPL-3.0 and is stated to be independent of Anthropic.

Key features

  • 01Routes Claude Code, Codex, Pi, OpenCode, Aider and other agents to many model providers.
  • 02Automatically falls back to a configured next model when a request fails.
  • 03Supports local models through Ollama, LM Studio and llama.cpp.
  • 04Routes individual Claude Code model tiers to different models.
  • 05Connects to VS Code, JetBrains, Claude Desktop, Discord and Telegram.
  • 06Transcribes voice notes with Whisper or NVIDIA NIM.

Use cases

  • Running Claude Code with free or low-cost model providers.
  • Using local models on your own machine with a familiar coding agent.
  • Driving a coding agent from Telegram or Discord while away from the desk.
  • Comparing or falling back between models from several providers.

Quick start

  1. 1

    Run the official install script from the README

  2. 2

    Start FCC (on Linux, run the server; on Windows and macOS, open the app)

    fcc-server
  3. 3

    Add an NVIDIA NIM API key in the Admin UI and apply a model

  4. 4

    Run Claude Code through FCC

    fcc-claude

Things to know

  • The license is AGPL v3, a copyleft license with source-sharing obligations.
  • You need an API key or account with a model provider, and free-tier limits are set by each provider and may change.

In collections

Coding with local LLMsClaude Code tools, skills & pluginsAI coding assistants & agentsSelf-hosted appsRun LLMs locally

Topics

#ai#llm-proxy#coding-agent#claude-code#openai-compatible#ollama#self-hosted

FAQ

What is free-claude-code?
A local proxy that lets Claude Code, Codex, and other coding agents run on free or alternative model providers from your terminal, IDE, browser, or chat apps. Free Claude Code (FCC) is a local proxy server that routes requests from coding agents to a wide range of model providers. Agents such as Claude Code, Codex, Pi, OpenCode, Aider and Cline can be pointed at models from providers including NVIDIA NIM, OpenRouter, Groq, Gemini, DeepSeek and local servers like Ollama, LM Studio and llama.cpp, all managed from a single Admin UI.
Is free-claude-code free to use? What license does it have?
free-claude-code is open source under the Other license. Check the license terms before using it in commercial products.
Is free-claude-code still maintained?
Actively maintained. The last commit to free-claude-code was on Nov 6, 2026.
What can I use free-claude-code for?
Running Claude Code with free or low-cost model providers. Using local models on your own machine with a familiar coding agent. Driving a coding agent from Telegram or Discord while away from the desk. Comparing or falling back between models from several providers.
How do I install free-claude-code?
Run the official install script from the README Start FCC (on Linux, run the server; on Windows and macOS, open the app): fcc-server Add an NVIDIA NIM API key in the Admin UI and apply a model Run Claude Code through FCC: fcc-claude
Where can I get free-claude-code?
The source code and installation instructions are on GitHub: https://github.com/Alishahryar1/free-claude-code

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects