Everything from my reel, written out. You install one free open-source app, plug in free API keys, and Claude Code, Codex or OpenCode run on free AI models instead of a paid plan.
FreeLLMAPI is a free open-source app that runs on your own computer. It pools the free tiers of many AI providers behind one key, and the project says that adds up to roughly 7–10 billion tokens a month.
Claude Code, Codex CLI, OpenCode, Cline, Roo Code, Kilo Code, Continue, Aider, Goose, Qwen Code, Crush, and any other tool that accepts an OpenAI-compatible endpoint.
| You need | Why / details |
|---|---|
| Mac or Windows PC | macOS 12 or newer, or Windows. On Linux, use Docker. |
| 30–45 minutes | For signing up to the free provider accounts. |
| Node.js 20+ | Needed for the one-command agent setup. |
| A phone number | Some providers, such as NVIDIA, verify by SMS. |
.dmg file. Works on Apple Silicon and Intel Macs (macOS 12+).setup.exe file. If SmartScreen warns you, click More info → Run anyway.curl -fsSL https://freellmapi.co/install.sh | bash
Some providers need no account at all. Switch these on first; they work immediately.
no key needed.Every key you add grows your monthly budget. Same routine each time: sign up, create a key, copy it. Then Keys → Add key, pick the provider, paste, click Add key, and Save at the end.
| Provider | Get your key | Notes |
|---|---|---|
| Google AI Studio | aistudio.google.com/apikey | Click Create API key. Unlocks Gemini. |
| Groq | console.groq.com/keys | Click Create API key. Very fast replies. |
| OpenRouter | openrouter.ai/keys | Gives the free models tagged :free. |
| Cerebras | cloud.cerebras.ai | API Keys is in the left menu. |
| NVIDIA NIM | build.nvidia.com | Phone verification. Hit a 404 after? Sign in again. |
| Mistral | console.mistral.ai/api-keys | Choose the free Experiment plan. |
| Cohere | dashboard.cohere.com/api-keys | Use a Trial key, not production. |
| Hugging Face | huggingface.co/settings/tokens | Create a token with Read access. |
| Requesty | requesty.ai | Key is under API Keys in the left menu. |
Many more are supported: type free key in Add key to see them all. The Models page lists each provider's free models and limits.
npx freellmapi keys test groq
node -v. On Windows, use PowerShell.claude --version, codex --version or opencode --version.| Agent | Install command |
|---|---|
| Claude Code | npm install -g @anthropic-ai/claude-code |
| Codex CLI | npm install -g @openai/codex |
| OpenCode | npm install -g opencode-ai |
Then make a project folder and open the terminal in it: mkdir my-project, then cd my-project.
Easiest route: copy the setup command the app generates, because it already has your local address. Keep the app running the whole time you use the agent.
freellmapi-. Copy it from the tray menu (Copy Key) or the top of the Keys page.http://localhost:3001.Or run it yourself, with your own address and key:
npx freellmapi setup-claude --url http://localhost:3001 --api-key freellmapi-YOUR-KEY
| Agent | Command |
|---|---|
| Codex | setup-codex |
| OpenCode | setup-opencode |
| Others | setup-cline, setup-aider, setup-roo … |
--dry-run to preview changes first; the tool backs up your config before writing. Claude Code needs the address without /v1, Codex and OpenCode with it. The setup commands handle this for you.npx freellmapi launch (Claude Code) or npx freellmapi launch-codex (Codex). The key is passed only for that session.http://localhost:3001/v1, your unified key as the API key, and auto as the model.claude, codex or opencode./model and pick one. Default or auto lets the app choose the best free model right now.hi and press Enter. A reply means everything works.auto:smart for harder tasks, auto:fast for quick edits.| Problem | Fix |
|---|---|
| Agent can't connect | Check the app is running (tray icon). Open the local address in your browser to confirm the server is up. |
| Auth or 401 error | Paste your unified key again, all of it, including freellmapi- at the start. |
| OpenCode ignores the key | Open OpenCode's JSON config and paste the key into the FreeLLMAPI provider entry by hand, replacing the environment-variable placeholder. |
| Claude Code still uses your Anthropic account | Open settings.json in the .claude folder in your home directory. Check ANTHROPIC_BASE_URL points to your local address and the token is your unified key. |
| Slow or worse in the evening | Top models used up their daily caps. They reset at midnight UTC (5:30 AM IST). More keys help. |
| A provider keeps failing | Run npx freellmapi keys test <provider>, or delete that key and make a new one. |
| npx not found | Node.js isn't installed or not on PATH. Reinstall from nodejs.org and open a new terminal. |
| Windows blocks the installer | Click More info, then Run anyway. |
To see which model answered, check the X-Routed-Via response header. Logs are under Open Logs Folder in the tray menu.
| Runs locally | Provider keys are stored encrypted on your machine; requests go straight to the providers you enabled. |
| Free-tier terms | The project is meant for personal experimentation. Each provider has its own free-tier terms, so read them before relying on one. |
| Keep your key secret | Anyone with your unified key can spend your token budget. Never show it in a reel, comment or screenshot. |
| Uninstall | Remove the app, then delete %APPDATA%\FreeLLMAPI\ (Windows) or ~/Library/Application Support/FreeLLMAPI/ (Mac). |
Made for you by texa.aitech. Follow @texa.aitech on Instagram for more AI tools and tech tips.