Leave MODEL on the default nvidia_nim/nvidia/nemotron-3-super-120b-a12b, or search the model dropdown and select another model.
Click Validate, then Apply.
4. Run Your Coding Agent
Claude Code:
fcc-claude
Codex:
fcc-codex
Pi:
fcc-pi
All three launchers use the current Admin UI settings. Use the agent's model picker to choose from the models FCC exposes. Normal CLI arguments still work, for example:
fcc-codex exec "hello"
fcc-pi registers FCC only for that Pi process; your existing Pi settings, sessions, credentials, and extensions remain unchanged.
Choose A Provider
Enter the listed setting in the Admin UI, open Model Config, then search the MODEL dropdown and select a model. FCC constructs each slug as <provider-id>/<exact-provider-model-id>; free-text entry remains available when a provider cannot list a model. Click Validate and Apply. Provider names link to their key, model, or setup pages.
Mistral Codestral uses a separate key from Mistral La Plateforme.
OpenCode Zen and OpenCode Go share OPENCODE_API_KEY but use different model prefixes.
Cloudflare requires both its API token and account ID.
Ollama Cloud connects directly to ollama.com; use the exact model IDs shown
by FCC's model picker. Local Ollama remains available through the separate
ollama/ prefix.
Prefer tool-capable models for coding agents. Local models also need enough context for the agent's system prompt and tool definitions.
LM Studio
Start LM Studio's local server, load a tool-capable model, and use the model identifier shown by LM Studio with the lmstudio/ prefix. The default URL is http://localhost:1234/v1.
llama.cpp
Start llama-server with its OpenAI-compatible Chat Completions API and enough context for the model. Use the local model ID with the llamacpp/ prefix. LLAMACPP_BASE_URL defaults to http://localhost:8080/v1; FCC accepts either the server root or an explicit /v1 suffix.
Ollama
ollama pull llama3.1
ollama serve
Use the tag shown by ollama list with the ollama/ prefix. OLLAMA_BASE_URL defaults to http://localhost:11434; FCC accepts either the root URL or an explicit /v1 suffix.
Optional Model-Tier Routing
MODEL is the fallback for every request. Select a model for MODEL_FABLE, MODEL_OPUS, MODEL_SONNET, or MODEL_HAIKU to override an individual Claude Code tier; select None to use MODEL.
For example, route Opus to nvidia_nim/moonshotai/kimi-k2.6, Sonnet to open_router/openrouter/free, Haiku to lmstudio/qwen3.5-coder, and keep MODEL on zai/glm-5.2.
<a id="connect-your-client"></a>
Connect Your Client
For terminal use, start fcc-server, then run fcc-claude, fcc-codex, or fcc-pi. Use the guides below for editor integrations.
Get your numeric user ID from @userinfobot.
In groups, grant the bot permission to delete messages.
Set Messaging Platform to telegram.
Enter Telegram Bot Token, Allowed Telegram User ID, and an absolute Allowed Directory.
Apply the settings and restart the server if requested.
Messaging commands
| Usage | Behavior |
| --- | --- |
| /stats | Show session state. |
| Standalone /stop | Cancel all work. |
| Reply with /stop | Cancel only the selected request while other queued requests continue. |
| Standalone /clear | Reset all FCC state and remove every tracked message in that chat, including user prompts, voice notes, FCC replies, Telegram's online notice, and the clear command itself. |
| Reply with /clear | Delete the selected message and its literal platform reply subtree while preserving its ancestors and siblings. |
Re-run the installer with the voice backend you need.
macOS/Linux:
# NVIDIA NIM transcription
curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh -s -- --voice-nim
# Local Whisper on CPU or CUDA
curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh -s -- --voice-local
# Both backends
curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh -s -- --voice-all
# Local Whisper with the CUDA 13.0 PyTorch backend
curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh -s -- --voice-local --torch-backend cu130
Windows PowerShell:
# NVIDIA NIM transcription
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1"))) -VoiceNim
# Local Whisper on CPU or CUDA
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1"))) -VoiceLocal
# Both backends
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1"))) -VoiceAll
# Local Whisper with the CUDA 13.0 PyTorch backend
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1"))) -VoiceLocal -TorchBackend cu130
Restart fcc-server. In Admin UI → Messaging → Voice, enable voice notes, select cpu, cuda, or nvidia_nim, and choose the Whisper model. Local gated models need HUGGINGFACE_API_KEY; NVIDIA NIM transcription needs NVIDIA_NIM_API_KEY.
Stop every running FCC command first. The uninstaller removes the FCC uv tool, verifies every FCC command is gone, and then deletes ~/.fcc/. It leaves uv, Python, Claude Code, Codex, Pi, and shared PATH entries intact.
macOS/Linux:
curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/uninstall.sh" | sh
