alishahryar1 / free-claude-code

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-ultra-550b-a55b, 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:

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

Install uv, then run directly from the checkout. uv automatically installs the Python version required by the project.

git clone https://github.com/Alishahryar1/free-claude-code.git
cd free-claude-code
uv run fcc-server

Use uv run for Python commands. Do not run the project with a global Python interpreter.