Repository iconcurepo.dev
free-claude-code preview

Alishahryar1 / free-claude-code

Use claude code, codex or pi for free from the terminal, IDE, or you phone like OpenClaw (voice supported)

60.4k Stars
visibility407 Watchers
fork_right9.4k Forks
Python
historyUpdated recently

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 Free Claude Code

Claude Code running with FCC.

Native Codex browser session in FCC, showing model controls and a repository exploration

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

  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.

Free Claude Code Admin UI

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

Claude Code model picker showing FCC models

Select an FCC model from Claude Code's native /model picker.

Choose A Provider

  1. Open a provider link below for its key, models, or setup instructions.
  2. In the Admin UI, configure the listed setting. For OpenAI / ChatGPT subscription access, use Providers → OAuth providers instead.
  3. Search the MODEL dropdown and select a model. If the provider cannot list models, enter <provider-id>/<exact-provider-model-id> manually.
  4. 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