free-claude-code: Connect Coding Agents to Multiple AI Models

Overview

Free Claude Code (FCC) is a Python-based local service for connecting coding agents and editor integrations to a catalog of cloud and local AI model providers. It gives developers one interface to configure provider credentials and models rather than managing separate model settings in each client.

It is most useful when you work across several coding agents or want provider fallback and model choice in one place. The project is independent of Anthropic and states that provider terms and free-tier availability are subject to change.

Key Features

• Routes requests from 11 listed coding agents and editor clients through a shared model catalog.
• Supports a broad range of hosted, subscription, and local model providers.
• Offers ordered fallback models for trying another configured model after request failures.
• Includes a local Admin UI for provider credentials, model selection, and integrations.
• Supports browser-based Codex sessions, plus optional Discord and Telegram access.
• Provides optional voice-note transcription through NVIDIA NIM or locally installed Whisper.
• Offers optional RTK integration and other prompt and terminal-output optimizations.

Use Cases

• A developer switching between Claude Code, Codex, Pi, or other supported agents who wants to manage provider settings centrally.
• A user combining free-tier services, paid APIs, and local models, with a configured fallback when a provider fails.
• A team member using coding tools in an IDE or desktop app who wants to connect those clients to the same local model setup.
• A developer who wants to send coding tasks from Discord or Telegram, or use voice notes, as optional integrations.

Getting Started

On macOS or Linux, install with:

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

Choose at least one coding agent during installation, then start FCC with fcc-server on Linux or open its desktop app on Windows or macOS. Configure a provider in the Admin UI. See the README for Windows installation, provider setup, and client-specific instructions.

Alternatives

• freellmapi: FreeLLMAPI routes requests across free and custom LLM endpoints, while free-claude-code focuses on configuring providers and connecting coding clients through a local proxy.

Considerations

• FCC runs locally and must be running for connected clients and integrations to use its models.
• Provider quotas, free access, model availability, and terms are controlled by the providers and can change. Some providers require separate API keys or subscription sign-in.
• The README recommends tool-capable models and notes that local models need sufficient context for agent prompts and tool definitions.
• The repository describes itself as an independent project, not affiliated with or endorsed by Anthropic. The input lists the license as NOASSERTION, while the README identifies it as AGPL-3.0-only, so verify the repository license before adopting it.