Free Claude Code
github.com/alishahryar1/free-claude-code- Category
- Developer Tools
- Rank
- No. 1421Tools index
Previous survey · No. 1330 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- alishahryar1
- GitHub
- 55.0k stars
- Date
About
Free Claude Code runs a local proxy server that presents 48 different model providers — free and paid — behind one endpoint, so coding agents such as Claude Code, Codex, OpenCode, and Cline can be pointed at whichever backend the user configures. Provider keys and model selection are managed through a web admin UI, and optional filters cut terminal output tokens while preserving streaming and tool use.
What it does
Free Claude Code runs a local proxy between coding agents and model providers. A browser admin panel selects credentials, models, and routing, while dedicated launchers connect Claude Code, Codex, or Pi. Compatible models retain streaming, tool use, reasoning, and image input.
Why it's ranked here
Its appeal comes from practical choice, not free compute by itself. One local control layer spans many hosted and local providers, several coding agents, desktop operation, and optional messaging bots. Built-in handling for routine agent requests can avoid unnecessary provider calls. The cost is operational complexity and dependence on each selected model's compatibility.
What's good
Model routing can use one default or map separate Claude model families independently. The provider catalog covers API services, subscription authentication, and local runtimes. Five common request patterns are handled locally, and optional terminal filtering reduces noisy context. Pi integration stays process-scoped, preserving existing settings, sessions, credentials, and extensions.
Tradeoffs
The tool does not eliminate provider setup, credentials, quotas, or model costs. Local backends must expose compatible chat APIs, support tools, and provide enough context for agent instructions. Linux keeps the server terminal open, while desktop tray behavior targets Windows and macOS. Voice features add substantial optional dependencies, including GPU-oriented packages for local transcription.
How to use it well
Use it when you regularly switch models or providers while keeping Claude Code, Codex, or Pi as the working interface. Start with one tool-capable model, validate it in the admin panel, then add routing only when workloads justify it. It does not replace model hosting, provider accounts, or the coding agents themselves.
Technical notes+
pyproject.toml packages src/free_claude_code with Hatchling, requires Python 3.14 or newer, and declares four console scripts plus the fcc-desktop GUI script. src/free_claude_code/api/app.py builds a FastAPI application through create_app, injects ApiServices, installs request-correlation and admin cache middleware, mounts admin and public routers, and emits protocol-specific error payloads for /v1/responses versus message requests. The package structure separates application, api, cli, config, core, messaging, providers, and runtime. pyproject.toml also configures pytest against tests, Ruff, Ty, optional cloud voice dependencies, and a separate local voice stack.
Observed
- License
- MIT
- Primary language
- Python
- Runtime requirement
- Python 3.14 or newer
- Packaging
- Hatchling wheel package with command-line and desktop entry points
- Interfaces
- Local FastAPI proxy, browser admin interface, CLI launchers, and desktop tray application
- Coding agents
- Claude Code, Codex, and Pi
- Platform support
- Windows, macOS, and Linux
- Architecture
- Separate application, API, CLI, configuration, core, messaging, provider, and runtime packages
Read from README.md, pyproject.toml, src/free_claude_code/__init__.py, src/free_claude_code/api/app.py, src/free_claude_code/api/__init__.py, src/free_claude_code/cli/__init__.py, src/free_claude_code/core/__init__.py, src/free_claude_code/config/__init__.py, src/free_claude_code/runtime/__init__.py, src/free_claude_code/messaging/__init__.py, src/free_claude_code/providers/__init__.py, src/free_claude_code/application/__init__.py, src/free_claude_code/cli/managed/__init__.py, src/free_claude_code/api/handlers/__init__.py, src/free_claude_code/config/admin/__init__.py.
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.