Alishahryar1 / free-claude-code
Use claude code, codex or pi for free from the terminal, IDE, or you phone like OpenClaw (voice supported)
description README.md
Independent open-source project. Not affiliated with or endorsed by Anthropic. Claude and Claude Code are trademarks of Anthropic.
What You Get
- 61 ToS-friendly providers. 1.3B+ free tokens every month. Use free, paid, subscription, and local models from one searchable UI without putting your account at risk. FCC follows provider terms and removes integrations if they stop being allowed.
- 11 coding agents. One model catalog. Run Claude Code, Codex, Pi, OpenCode, Cline, Hermes, DeepSeek Harness, Grok Build, Muse Code, Aider, or VS Code Chat with your FCC models.
- Keep coding through provider outages. After retries are exhausted, FCC automatically tries your next configured model without making you restart the turn. This works across every client.
- Up to 90% lower token usage. Optional RTK filters common command output, and Headroom compresses tool results. Five FCC optimizations handle quota probes, command-prefix detection, titles, suggestions, and filepaths without calling a provider.
- Native Code sessions in your browser. Choose a folder and run Codex in the browser with real-time and background support. Freely switch providers/models in the same session. Support for switching harnesses in the same session coming soon!
- Terminal, desktop, IDE, or phone. Work through native launchers, VS Code, Codex App, JetBrains, Discord, or Telegram.
- Voice notes in. Code out. Talk to your agent using local Whisper or NVIDIA NIM transcription.
- Agent capabilities stay intact. Stream responses, use tools, preserve native interleaved thinking for maximum performance, send images, and route Fable, Opus, Sonnet, and Haiku independently with compatible models.
Free-tier availability and limits are controlled by each provider and may change.
Claude Code running with FCC.
A native Codex session in FCC's browser UI.
Quick Start
1. Install
macOS/Linux:
curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh
Windows PowerShell:
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1")))
When prompted, choose at least one coding agent and optionally enable RTK + Headroom token optimization for supported agents.
2. Start FCC
Windows
Open Free Claude Code from your desktop or Start menu.
macOS
Open Free Claude Code from your desktop or Applications folder.
Linux
Run:
fcc-server
FCC opens the Admin UI after starting. On Windows and macOS, use the tray or
menu-bar icon to open Admin, restart, or quit. When using fcc-server, keep its
terminal open.
3. Configure NVIDIA NIM
- Create an API key at build.nvidia.com/settings/api-keys.
- Open the Admin UI URL from the server log.
- Open NVIDIA NIM in Providers, click Add key, paste the key, and click Save.
- Leave
MODELon the defaultnvidia_nim/nvidia/nemotron-3-super-120b-a12b, or search the model dropdown and select another model. - Click Apply to save your model selection.
To protect the local proxy with a bearer token, enable Proxy Authentication in Admin.
4. Run Your Coding Agent
Claude Code:
fcc-claude
Codex:
fcc-codex
Pi:
fcc-pi
OpenCode 2:
fcc-opencode
Cline:
fcc-cline
Hermes:
fcc-hermes
DeepSeek Harness Web:
fcc-dsh
Grok Build:
fcc-grok
Muse Code:
fcc-muse
Aider:
fcc-aider
Select an FCC model from Claude Code's native /model picker.
Choose A Provider
- Open a provider link below for its key, models, or setup instructions.
- In the Admin UI, configure the listed setting. For OpenAI / ChatGPT subscription access, use Providers → OAuth providers instead.
- Search the
MODELdropdown and select a model. If the provider cannot list models, enter<provider-id>/<exact-provider-model-id>manually. - Click Apply.
Optional: add an ordered Fallback Models list under Model Config. It applies to every connected client. A failed request may reach and consume usage from more than one provider before succeeding.
Provider modals support numbered API keys. Use Add key, remove rows, or drag their handles to reorder them. FCC uses key 1.
For another API endpoint, open Providers → Custom providers → Add provider. Enter its API base URL, optional keys, and API format. Leave Model IDs empty to discover models automatically, or enter one upstream model ID per line. Save, then select a model in Model Config.
Provider catalog
| Provid
More in Uncategorized

openclaw / openclaw
OpenClaw is an open-source personal AI assistant that runs on your own devices and connects to the communication platforms you already use. It provides a fast, always-available assistant that can respond, listen, speak, and perform tasks across desktop and mobile devices.

obra / superpowers
An agentic skills framework & software development methodology that works.

mattpocock / skills
Created by renowned TypeScript educator Matt Pocock, Skills is a collection of practical, reusable workflows for AI coding agents such as Claude Code and Codex. The skills help developers plan, test, debug, and build real-world software while keeping control of the engineering process

affaan-m / everything-claude-code
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.