Verified project record

Alishahryar1/free-claude-code

A local proxy and Admin UI that routes Claude Code, Codex, and Pi agent traffic to free, paid, or local model providers. It enables developers to select, validate, and manage multiple providers from a single interface.

Project overview

Project type: AI Coding · Model Runtime
Use cases: Coding & Development
Deployment: Refer to project documentation
License: MIT

Best for

Developers and AI engineers who need to route coding agent traffic through various free, paid, or local providers and manage them from a local interface.
Teams or individuals wanting to add optional token authentication to their local proxy setup for coding agents.

Key capabilities

Routes coding agent traffic through a local proxy connected to 25 cloud and local providers.
Provides a local interface to choose and validate providers.
Allows the use of each coding agent's native model picker to select models exposed by the proxy.
Routes Fable, Opus, Sonnet, Haiku, and fallback traffic to different models.
Enables Claude Code sessions to run through Discord or Telegram with voice-note transcription using NVIDIA NIM or Local Whisper.
Manages client reasoning controls (Off, Low, Medium, High, X-High, Max) for compatible providers.
Protects the local proxy with optional token authentication.
Optionally runs Claude Code sessions through Discord or Telegram bots.

Limitations and risks

Local models routed through the proxy also need enough context to handle the agent's system prompt and tool definitions.

Getting started

Run the curl or PowerShell install script, start the fcc-server command, and open the Admin UI URL shown in the startup log to validate and apply provider keys.

Evidence and sources

README: Use Claude Code, Codex, Pi, or their IDE extensions through your own provider-backed proxy.
README: Switch among 25 cloud and local providers from the Admin UI.
README: INFO: Admin UI: http://127.0.0.1:8082/admin (local-only)
README: Route Fable, Opus, Sonnet, Haiku, and fallback traffic to different models.
README: Optionally run Claude Code sessions through Discord or Telegram with voice-note transcription.

Reviewed at: 2026-07-17T07:52:29Z