free-claude-code: A local proxy that connects coding agents to OpenAI-compatible AI providers.
What problem it solves
Coding agents often need to work with providers that differ in models, credentials, reasoning controls, and availability. This project provides a unified local layer for selecting providers, routing models, and maintaining access through retries and fallbacks.
Key features
Multi-harness model routing — Use supported coding agents with models from configured providers through dedicated launchers and model routing.
Source: README
Provider and model configuration — Configure supported providers in the Admin UI, choose models, manage multiple API keys, and add custom provider endpoints.
Source: README
Editor, app, and messaging integrations — Connect coding agents used in editors and desktop applications, and configure messaging integrations through the Admin UI.
Source: README
Reliability and fallback handling — Keep requests moving with automatic retries, configurable limits, model and provider fallback, and multi-key fallback.
Source: README
Model-tier and reasoning controls — Set a default model, override Claude Code model tiers, order fallback models, and select reasoning behavior for each routing tier.
Source: README
Quick start
Copied verbatim from the project's README.
curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | shfcc-serverfcc-claudeWho it may suit
Inference: may suit developers who want to connect coding agents to multiple hosted or local model providers through a common management interface.
Topics to discuss
Which provider or model fallback policies should be available by default?
How should model-tier and reasoning controls behave for different coding agents?
Which integrations would most improve day-to-day use across terminals, editors, and messaging apps?
Written by ReadmeX AI from the project's README, source and public GitHub data; it may contain mistakes.
Read the original README https://github.com/Alishahryar1/free-claude-code#readme
ReadmeX opened this community for a trending project; it is not run by the project. Maintainers can claim it from the community page.
Comments
…