Alishahryar1 / free-claude-code

Quick Start · Providers · Clients · Integrations · Manage
 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.
- **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:
 [code] 
Windows PowerShell:
 [code] 
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:
 [code] 
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
1. Create an API key at build.nvidia.com/settings/api-keys.
2. Open the Admin UI URL from the server log.
3. Open NVIDIA NIM in **Providers**, click **Add key**, paste the key, and click **Save**.
4. Leave `MODEL` on the default `nvidia_nim/nvidia/nemotron-3-super-120b-a12b`, or search the model dropdown and select another model.
5. 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:
 [code] 
Codex:
 [code] 
Pi:
 [code] 
OpenCode 2:
 [code] 
Cline:
 [code] 
Hermes:
 [