free-claude-code

free-claude-code

Routes coding tools such as Claude Code, Codex and Aider to models from many providers, free and local ones included, from a terminal, IDE, phone or browser. An independent project, not tied to Anthropic.

Made by Alishahryar1 on GitHub. These notes are Mindket's, written from its README; the project's own files and license are in its repository.

About

What it is: free-claude-code is an independent open-source project that lets coding tools such as Claude Code, Codex and Aider use models from other providers. It supports 12 coding tools and 61 providers, covering free, paid, subscription and local ones. The README says it follows each provider's terms and removes an integration once the provider stops allowing it.

Who it suits: It suits developers who use AI coding tools and want a choice of model provider or a smaller token bill. People who like to reach a coding tool from a phone chat can use it too.

Industry | Who uses it | How they use it | Example
Software | Developers on AI coding tools | Send a coding tool to a model from another provider | Pointing Claude Code at a different provider's model
Education and hobby | Students and hobbyists | Work from the free token allowance the README counts at 1.3B+ per month | Running a coding tool on free tokens
Remote work | Developers away from the desk | Reach a coding tool from Discord or Telegram, with voice notes | Sending a voice note to a coding tool from a phone
Privacy-minded teams | Users of local models | Route a coding tool to a local provider | Using a locally run model with a coding tool

If you are happy with your coding tool's own model and billing, you can skip it.

Where to use it:

• Terminal
• Desktop apps such as Codex App and Claude Desktop
• IDE extensions: VS Code and JetBrains
• Your phone, through Discord and Telegram
• Your browser, through native Code sessions

Use case | Who | What they get back
Switch model provider | Developers | A coding tool working with a model from one of the supported providers
Cut token use | Heavy users | Lower token usage, up to 90% by the README's figure, using RTK and Headroom
Voice notes | Phone users | Voice notes handled by local Whisper or NVIDIA NIM

How to set it up:

• One of the supported coding tools, such as Claude Code or Codex
• A model provider that the project supports
• A Discord or Telegram account if you want the phone route

1. Get the code from the project's GitHub repository with git.
2. Follow the Quick Start in the README.
3. Choose which supported provider your coding tool should use.

For newcomers and experts: A coding tool, such as Claude Code or Codex, talks to an AI model. This project sits between the two, so the tool can use a model from a different provider. A small first step is reading the Quick Start and choosing one coding tool and one provider.

Routing keeps native streaming, tool use and interleaved thinking intact, so a coding tool should behave as it does with its own models. For Claude Code, it can map the Fable, Opus, Sonnet and Haiku slots to supported models.

Your coding tool sends a request
The project routes it to your chosen provider
The provider's model answers
Streaming and tool use pass back intact

Good to know:

• Supported tools: 12 in all, among them Claude Code, Codex, Aider, Cline and Antigravity CLI
• License: not declared on GitHub (NOASSERTION), so check the repository's own files
• Cost to run: depends on the provider you pick, from free and local to paid and subscription. Phone and voice use name Discord, Telegram and NVIDIA NIM.
• Data it reaches: your coding requests, which go to the provider you choose, plus Discord or Telegram messages if you use the phone route
• Not for: it is independent and not affiliated with or endorsed by Anthropic

On GitHub, 13 November 2026

• Stars: 69,340 (415 that day)
• Forks: 10,766
• Watching: 466
• Open issues and pull requests: 394
• Language: Python
• License: see the repository
• Trending: #12 repository of the day on GitHub trending (13 November 2026)

Links

• Code: https://github.com/Alishahryar1/free-claude-code
• Releases: https://github.com/Alishahryar1/free-claude-code/releases
• Issues: https://github.com/Alishahryar1/free-claude-code/issues
• Star history: https://www.star-history.com/#Alishahryar1/free-claude-code&Date

Get the code

git clone https://github.com/Alishahryar1/free-claude-code.git

Then follow the setup in its README. Nothing in this kit runs by itself.