StackMap
Subscribe
Explore / free-claude-code
Alishahryar1

free-claude-code

Provider-backed proxy that runs Claude Code, Codex or Pi on 25 cloud and local providers — fcc-* launchers, local Admin UI with validation, per-tier model routing, IDE/Discord/Telegram hookups.

40,447 6,619 Python MITupdated today
gateway
View on GitHubDispute this mapping →
Curator's take

40k stars because it nails onboarding: one installer, `fcc-server` + `fcc-claude`, paste an NVIDIA NIM key and Claude Code runs for free — the Admin UI validates providers, and the agents' NATIVE /model pickers see the whole FCC catalog. Tier routing is the power feature: send Opus traffic to Kimi, Sonnet to an OpenRouter free route, Haiku to a local LM Studio model. Local models (Ollama, llama.cpp, LM Studio) are first-class. NOT a quota-stacker — you pick a provider rather than multiplex free tiers with failover (that's freellmapi's job), and expect capability drift vs real Anthropic models on complex agentic work. Discord/Telegram remote sessions with voice-note transcription are a genuinely odd, genuinely useful extra.

Mapped by ShipWithAI editors · links verified
README.md

🤖 Free Claude Code

Use Claude Code, Codex, Pi, or their IDE extensions through your own provider-backed proxy.

License: MIT Python 3.14 uv Tested with Pytest Type checking: Ty Code style: Ruff Logging: Loguru

Run your coding agents with free, paid, or local models. Choose and validate providers from one local Admin UI.

Quick Start · Providers · Clients · Integrations · Manage

Free Claude Code in action

Claude Code running through the Free Claude Code proxy.

Codex CLI in action through Free Claude Code

Codex CLI using the local FCC Responses provider.

Claude Code model picker showing gateway models

Claude Code native /model picker with FCC gateway models.

Codex model picker showing generated FCC model catalog

Codex native /model picker with the generated FCC catalog.

Star History

What You Get

  • Launch Claude Code with fcc-claude, Codex with fcc-codex, or Pi with fcc-pi.
  • Switch among 25 cloud and local providers from the Admin UI.
  • Use each coding agent's native model picker.
  • Route Fable, Opus, Sonnet, Haiku, and fallback traffic to different models.
  • Keep streaming, tool use, reasoning, and image input across compatible models.
  • Connect Claude Code and Codex in VS Code or Claude Code through JetBrains ACP.
  • Optionally run Claude Code sessions through Discord or Telegram with voice-note transcription.
  • Protect the local proxy with optional token authentication.

Quick Start

1. Install Or Update

macOS/Linux:

curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh

Windows PowerShell:

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1")))

Re-run the same command whenever you want to update. You can review the installers before running them: [install.sh](s

Continue your stack

What teams reach for next — and why each earns a place beside free-claude-code. Ranked by curator confidence.