free-claude-code
Overview
This is a fork of Alishahryar1/free-claude-code, maintained by Evan Damron. It adds an openai_compatible provider that points FCC at any OpenAI-compatible Chat Completions endpoint — the UK LLM Factory in particular — plus a local mlxvlm provider for Apple Silicon. That is the reason this repo exists; everything else tracks upstream daily. See FORK.md. Upstream's README begins below.
These steps take you from nothing to Claude Code talking to an LLM Factory model.
The installer below is this fork's, and installs this fork's package. Do not use upstream's install command — it installs upstream's build, which has no openai_compatible provider.
When prompted, choose at least one coding agent (Claude Code). Re-run the same command to update.
Sign in at llm-factory.ai.uky.edu (UK Shibboleth via CILogon). You need two things:
Or configure it by file instead of the UI
From the project’s README on GitHub.
At a glance
| Repository | Kentucky-Open-Science/free-claude-code |
|---|---|
| Research area | Other projects |
| Primary language | Python |
| Languages | Python 96.1%, PowerShell 1.3%, Shell 1.2%, JavaScript 0.8%, CSS 0.4%, TypeScript 0.1% |
| License | MIT |
| Stars / forks | 1 / 0 |
| Open issues and pull requests | 0 |
| Created | 2026-06-28 |
| Last push | 2026-09-05 |
| Default branch | main |
What the README covers
- 1. Install this fork
- 2. Get your LLM Factory credentials
- 3. Start FCC
- 4. Configure the provider in Admin
- 5. Route the Claude tiers (optional)
- 6. Run your coding agent
- Notes and limits for this provider
- Troubleshooting
- What You Get
- Quick Start
- 1. Install Or Update
- 2. Start FCC
- 3. Configure NVIDIA NIM
- 4. Run Your Coding Agent
- Choose A Provider
- LM Studio
- llama.cpp
- Ollama
- Connect Your Client
- Optional Integrations
- Messaging commands
- Manage Your Installation
- Update
- Uninstall
- Project Links
- License
Top contributors
- @Alishahryar1 (784 commits)
- @cursoragent (53 commits)
- @EvanDamron (11 commits)
- @rishiskhare (7 commits)
- @claude (6 commits)
- @Tanishq-1 (4 commits)
- @aaravsw3 (3 commits)
- @SEPURI-SAI-KRISHNA (2 commits)
- @wocessade (2 commits)
- @newmemories360 (2 commits)
Get the code
git clone https://github.com/Kentucky-Open-Science/free-claude-code.git