📦Alishahryar1 / free-claude-code
← 返回首页
Use Claude Code, Codex, Antigravity, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)
⚖️ NOASSERTION📅 创建于 2026-01-28🔄 更新于 2026-10-31
🔗 GitHub Python

📄 仓库 README

在 GitHub 查看 ↗
来自 GitHub 仓库自述文件 · 版权归原作者所有

Free Claude Code

[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-2e7d32.svg?style=for-the-badge)](https://github.com/Alishahryar1/free-claude-code/blob/main/LICENSE) [![Python 3.14](https://img.shields.io/badge/python-3.14-3776ab.svg?style=for-the-badge&logo=python&logoColor=white)](https://www.python.org/downloads/) [![Package Manager: uv](https://raw.githubusercontent.com/Alishahryar1/free-claude-code/HEAD/assets/package-manager-uv.svg)](https://github.com/astral-sh/uv) [![Testing: Pytest](https://img.shields.io/badge/Testing-Pytest-ad1457.svg?style=for-the-badge)](https://github.com/Alishahryar1/free-claude-code/actions/workflows/tests.yml) [![Type Checker: Ty](https://img.shields.io/badge/Type%20Checker-ty-fdd835.svg?style=for-the-badge)](https://pypi.org/project/ty/) [![Formatter: Ruff](https://img.shields.io/badge/Formatter-ruff-bf4b00.svg?style=for-the-badge)](https://github.com/astral-sh/ruff) [![Logging: Loguru](https://img.shields.io/badge/logging-loguru-00695c.svg?style=for-the-badge)](https://github.com/Delgan/loguru) [Quick Start](#quick-start) · [Providers](#choose-a-provider) · [Clients](#connect-your-client) · [Integrations](#optional-integrations) · [Manage](#manage-your-installation)

Independent open-source project. Not affiliated with or endorsed by Anthropic. Claude and Claude Code are trademarks of Anthropic.

Features

  • Route any supported harness to models from any supported provider.
  • 12 supported harnesses: Claude Code, Codex, Pi, OpenCode, Cline, Hermes, DeepSeek Harness, Grok Build, Muse Code, Aider, Antigravity CLI, or VS Code Chat.
  • Preserved native streaming, tool use, and interleaved thinking for maximum performance.
  • For Claude Code, route Fable, Opus, Sonnet, and Haiku to supported models.
  • 61 supported providers, including free, paid, subscription, and local providers.
  • 1.3B+ free tokens per month.
  • FCC follows provider TOS and removes integrations if they stop being allowed.
  • Use through the terminal, desktop apps (Codex App, Claude Desktop, and DeepSeek Desktop), IDE extensions (VS Code and JetBrains), your phone (Discord and Telegram), or your browser through native Code sessions.
  • Voice notes supported for Discord and Telegram using local Whisper or NVIDIA NIM.
  • Up to 90% lower token usage using RTK and Headroom.
  • State-of-the-art reliability features so you can keep coding through provider outages:
  • Automatic retries.
  • Configurable rate limits.
  • Configurable concurrency control.
  • Automatic model/provider fallback.
  • Automatic multi-API key fallback.

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-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.

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

Antigravity CLI (connect on the Integrations page first):

fcc-agy

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 | Provider | Admin UI setting | Example `MODEL` | | --- | --- | --- | | [NVIDIA NIM](https://build.nvidia.com/settings/api-keys) | `NVIDIA_NIM_API_KEY` | `nvidia_nim/nvidia/nemotron-3-ultra-550b-a55b` | | [OpenRouter](https://openrouter.ai/keys) | `OPENROUTER_API_KEY` | `open_router/openrouter/free` | | [Groq](https://console.groq.com/keys) | `GROQ_API_KEY` | `groq/llama-3.3-70b-versatile` | | [ClinePass](https://docs.cline.bot/getting-started/clinepass) | `CLINE_API_KEY` | `cline_pass/cline-pass/kimi-k3` | | [OpenAI / ChatGPT](https://learn.chatgpt.com/docs/auth) | Connect ChatGPT in the Admin UI | `openai/` | | [OpenAI API](https://platform.openai.com/api-keys) | `OPENAI_API_KEY` | `openai_api/gpt-5.6-sol` | | [GitHub Copilot](https://docs.github.com/en/copilot/how-tos/copilot-sdk/auth/authenticate) | Connect GitHub Copilot in the Admin UI | `github_copilot/` | | [xAI (Grok)](https://console.x.ai/team/default/api-keys) | `XAI_API_KEY` | `xai/grok-4.5` | | [Alibaba Cloud](https://www.alibabacloud.com/help/en/model-studio/get-api-key) | `ALIBABA_CLOUD_API_KEY` | `alibaba_cloud/` | | [QwenCloud Token Plan](https://home.qwencloud.com/api-keys) | `QWENCLOUD_API_KEY` | `qwencloud/qwen3.7-plus` | | [QwenCloud Coding Plan](https://home.qwencloud.com/api-keys) | `QWENCLOUD_CODING_API_KEY` | `qwencloud_coding/qwen3.7-plus` | | [Together AI](https://api.together.ai/settings/api-keys) | `TOGETHER_API_KEY` | `together/zai-org/GLM-5.2` | | [DeepInfra](https://deepinfra.com/dash/api_keys) | `DEEPINFRA_API_KEY` | `deepinfra/deepseek-ai/DeepSeek-V4-Flash` | | [SiliconFlow](https://cloud.siliconflow.com/account/ak) | `SILICONFLOW_API_KEY` | `siliconflow/Qwen/Qwen3-32B` | | [Nebius Token Factory](https://tokenfactory.nebius.com/project/api-keys) | `NEBIUS_API_KEY` | `nebius/Qwen/Qwen3-30B-A3B` | | [Chutes](https://chutes.ai/docs/getting-started/authentication) | `CHUTES_API_KEY` | `chutes/Qwen/Qwen3-32B-TEE` | | [Featherless AI](https://featherless.ai/account/api-keys) | `FEATHERLESS_API_KEY` | `featherless/Qwen/Qwen3-32B` | | [Agnes AI](https://agnes-ai.com/) | `AGNES_API_KEY` | `agnes/agnes-2.0-flash` | | [ZenMux](https://zenmux.ai/platform/pay-as-you-go) | `ZENMUX_API_KEY` | `zenmux/deepseek/deepseek-v4-flash-free` | | [W&B Inference](https://wandb.ai/settings) | `WANDB_API_KEY` | `wandb/openai/gpt-oss-20b` | | [Anthropic](https://platform.claude.com/settings/keys) | `ANTHROPIC_API_KEY` | `anthropic/` | | [Azure OpenAI](https://learn.microsoft.com/azure/foundry/openai/how-to/chatgpt) | `AZURE_OPENAI_API_KEY` and `AZURE_OPENAI_BASE_URL` | `azure_openai/` | | [Google AI Studio (Gemini)](https://aistudio.google.com/apikey) | `GEMINI_API_KEY` | `gemini/models/gemini-3.1-flash-lite` | | [Google Vertex AI](https://cloud.google.com/vertex-ai/generative-ai/docs/start/openai) | `VERTEX_PROJECT_ID` + ADC | `vertex/google/gemini-3.5-flash` | | [DeepSeek](https://platform.deepseek.com/api_keys) | `DEEPSEEK_API_KEY` | `deepseek/deepseek-chat` | | [Mistral La Plateforme](https://console.mistral.ai/) | `MISTRAL_API_KEY` | `mistral/devstral-small-latest` | | [Mistral Codestral](https://console.mistral.ai/) | `CODESTRAL_API_KEY` | `mistral_codestral/codestral-latest` | | [OpenCode Zen](https://opencode.ai/auth) | `OPENCODE_API_KEY` | `opencode_zen/gpt-5.3-codex` | | [OpenCode Go](https://opencode.ai/auth) | `OPENCODE_API_KEY` | `opencode_go/minimax-m2.7` | | [Vercel AI Gateway](https://vercel.com/docs/ai-gateway/models-and-providers) | `AI_GATEWAY_API_KEY` | `vercel/openai/gpt-5.5` | | [Amazon Bedrock](https://console.aws.amazon.com/bedrock/) | `AWS_BEARER_TOKEN_BEDROCK` | `bedrock/openai.gpt-oss-120b` | | [Hugging Face Inference Providers](https://huggingface.co/settings/tokens) | `HUGGINGFACE_API_KEY` | `huggingface/Qwen/Qwen3-Coder-480B-A35B-Instruct:fastest` | | [Cohere](https://dashboard.cohere.com/api-keys) | `COHERE_API_KEY` | `cohere/command-a-plus-05-2026` | | [Wafer](https://wafer.ai/) | `WAFER_API_KEY` | `wafer/DeepSeek-V4-Pro` | | [Kimi API](https://platform.moonshot.ai/console/api-keys) | `KIMI_API_KEY` | `kimi/kimi-k2.5` | | [Kimi Code](https://www.kimi.com/code/console) | `KIMI_CODE_API_KEY` | `kimi_code/k3` | | [MiniMax](https://platform.minimax.io/user-center/basic-information/interface-key) | `MINIMAX_API_KEY` | `minimax/MiniMax-M3` | | [Cerebras Inference](https://cloud.cerebras.ai/) | `CEREBRAS_API_KEY` | `cerebras/gpt-oss-120b` | | [SambaNova](https://cloud.sambanova.ai/apis) | `SAMBANOVA_API_KEY` | `sambanova/Meta-Llama-3.3-70B-Instruct` | | [Kilo.ai](https://kilo.ai) | `KILO_API_KEY` | `kilo/kilo-auto/free` | | [Fireworks AI](https://fireworks.ai/account/api-keys) | `FIREWORKS_API_KEY` | `fireworks/accounts/fireworks/models/llama-v3p3-70b-instruct` | | [Novita AI](https://novita.ai/settings/key-management) | `NOVITA_API_KEY` | `novita/deepseek/deepseek-v4-flash-0731` | | [Cloudflare Workers AI](https://developers.cloudflare.com/workers-ai/) | `CLOUDFLARE_API_TOKEN` and `CLOUDFLARE_ACCOUNT_ID` | `cloudflare/@cf/moonshotai/kimi-k2.6` | | [Z.ai Coding Plan](https://z.ai/manage-apikey/apikey-list) | `ZAI_API_KEY` | `zai/glm-5.2` | | [Z.ai API (pay as you go)](https://z.ai/manage-apikey/apikey-list) | `ZAI_API_KEY` | `zai_api/glm-4.7-flash` | | [TokenRouter](https://www.tokenrouter.com/) | `TOKENROUTER_API_KEY` | `tokenrouter/moonshotai/kimi-k3-free` | | [NaraRoute](https://router.bynara.id/) | `NARAROUTE_API_KEY` | `nararoute/kimi-k3-free` | | [Poolside AI](https://platform.poolside.ai/) | `POOLSIDE_API_KEY` | `poolside/poolside/laguna-s-2.1` | | [LLM7.io](https://dash.llm7.io/) | `LLM7_API_KEY` | `llm7/default` | | [Scaleway](https://console.scaleway.com/iam/api-keys) | `SCW_SECRET_KEY` | `scaleway/deepseek/deepseek-v4-flash` | | [Lightning AI](https://lightning.ai/) | `LIGHTNING_API_KEY` | `lightning/lightning-ai/Qwen3.8-27B` | | [Experiential Labs](https://platform.experientiallabs.ai/) | `EXPLABS_API_KEY` | `experiential/union-alpha` | | [Cheaper Inference](https://cheaperinference.com/signup) | `CHEAPER_INFERENCE_API_KEY` | `cheaperinference/gpt-5.4-mini` | | [OrcaRouter](https://www.orcarouter.ai/) | `ORCAROUTER_API_KEY` | `orcarouter/deepseek/deepseek-v4-flash-free` | | [Atlas Cloud](https://console.atlascloud.ai/api-keys) | `ATLASCLOUD_API_KEY` | `atlascloud/deepseek-ai/deepseek-v4-flash` | | [xKiro](https://xkiro.com/) | `XKIRO_API_KEY` | `xkiro/qwen/qwen3.7-flash:free` | | [Opper](https://platform.opper.ai/) | `OPPER_API_KEY` | `opper/claude-sonnet-4-6` | | [Ollama Cloud](https://ollama.com/settings/keys) | `OLLAMA_API_KEY` | `ollama_cloud/qwen3-coder:480b` | | [LM Studio](https://lmstudio.ai/) | `LM_STUDIO_BASE_URL` | `lmstudio/` | | [llama.cpp](https://github.com/ggml-org/llama.cpp) | `LLAMACPP_BASE_URL` | `llamacpp/` | | [Ollama](https://ollama.com/) | `OLLAMA_BASE_URL` | `ollama/` |
Provider-specific setup - OpenAI / ChatGPT uses your ChatGPT subscription rather than an API key. Connect from **Providers → OAuth providers → OpenAI / ChatGPT → Connect** in the Admin UI and finish signing in through your browser. Restart an already-running agent after connecting. - Anthropic uses a separately billed API key. Add it under **Providers → Cloud providers → Anthropic → Configure**, then choose a discovered model. Multi-workspace keys also require `ANTHROPIC_WORKSPACE_ID`. - OpenAI API uses a separate Platform API key. Enter it under **Providers → Cloud providers → OpenAI API → Configure**. The model list may include IDs that cannot handle coding requests. Choose a text-generation model. - GitHub Copilot uses your signed-in GitHub account and subscription. Install [Copilot CLI 1.0.83](https://github.com/github/copilot-cli/releases/tag/v1.0.83) on PATH, then choose **Providers → OAuth providers → GitHub Copilot → Connect**. Finish signing in, then select a `github_copilot/` from the model picker. Available models and quotas depend on your subscription and organization policies. Restart an already-running agent after connecting. - Azure OpenAI uses the deployment names from your resource. Set `AZURE_OPENAI_BASE_URL` to its complete v1 endpoint, such as `https://YOUR-RESOURCE-NAME.openai.azure.com/openai/v1/`, and select a deployment that supports Chat Completions. Enter the deployment name as a custom model slug if it does not appear in the model dropdown. - Mistral Codestral uses a separate key from Mistral La Plateforme. - Kimi Code subscription keys use `kimi_code/`. Kimi API credit keys use `kimi/`. Kimi Code plans are for personal interactive coding-agent use under [Kimi's community guidelines](https://www.kimi.com/code/docs/en/kimi-code/community-guidelines.html). - Alibaba Cloud uses a Model Studio pay-as-you-go key and defaults to Singapore. For another region or workspace, set `ALIBABA_CLOUD_BASE_URL` to its [OpenAI-compatible endpoint](https://www.alibabacloud.com/help/en/model-studio/base-url) ending in `/compatible-mode/v1`. The key and endpoint must use the same region. - QwenCloud Coding Plan keys use `qwencloud_coding/`. QwenCloud Token Plan keys use `qwencloud/`. The keys and endpoints are not interchangeable. Coding Plan is for local, personal, interactive coding-agent use under the [Coding Plan terms](https://www.alibabacloud.com/help/en/model-studio/coding-plan). - OpenCode Zen and OpenCode Go share `OPENCODE_API_KEY` but use the explicit `opencode_zen/` and `opencode_go/` model prefixes. - For Amazon Bedrock, set `BEDROCK_BASE_URL` to the URL for the same region as the API key and select one of the listed models. - Vertex AI uses Google Application Default Credentials instead of an API key. Locally, run `gcloud auth application-default login` once. Service-account files and attached service accounts also work. Set `VERTEX_PROJECT_ID`, and optionally change `VERTEX_LOCATION` from its `global` default. - Cloudflare requires both its API token and account ID. - For Ollama Cloud, use the exact model IDs shown in the model picker. Local Ollama uses 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.
Local provider setup FCC automatically discovers models from running local servers at startup. If you start a server later, click **Refresh models** in Admin to add its models to the picker. ### 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`. ### 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`. Provider cards show the checked endpoint and response time, with a useful message when a local server is unavailable. After starting the server or correcting its settings, click **Test** to refresh its models.
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`. In **Admin UI → Model Config**, add **Fallback Models** in the order FCC should try them if the selected model fails. Each fallback has its own reasoning effort: **Inherit**, **Off**, **From client**, **Low**, **Medium**, **High**, **X-High**, or **Max**. Choose a model, effort, and API key number in the bottom row, then click **+**. **Key 1**, **Key 2**, and so on refer to the current numbered keys in that provider's settings. Edit the selections in place, drag the handle to change the order, or click the red trash button to remove a fallback. **Inherit** keeps the original request's resolved reasoning setting. **From client** uses the effort or token budget sent by your coding agent, bypassing the global or tier setting. You can select the same model with another key number.
Reasoning control Open **Admin UI → Model Config → Model Routing** and choose an effort beside each model. **Default Effort** starts at **From client**. Fable, Opus, Sonnet, and Haiku start at **Inherit**. | Selection | Behavior | | --- | --- | | **From client** | Use the effort sent by your coding agent. If none is sent, keep the provider default. | | **Off** | Request reasoning to be disabled. | | **Low**, **Medium**, **High**, **X-High**, or **Max** | Override the client with the selected reasoning level. | | **Inherit** | Tier overrides use Default Effort. Fallbacks keep the original request's resolved effort. |

Connect Your Client

FCC launchers automatically start the server.

For editor and app integrations, install the client, start FCC, then open Admin UI → Integrations and click Connect on its card.

  • Claude Code in VS Code: Install the Claude Code extension.
  • VS Code Chat: Install the latest VS Code, connect, and select an FCC model in its built-in Chat model picker.
  • Claude Desktop: Install Claude Desktop. Fully quit it before connecting or disconnecting, then reopen it. Disconnect returns to normal Claude sign-in.
  • Codex in VS Code and App: Install the Codex extension or Codex App.
  • DeepSeek Harness Desktop: Install and open the app once before connecting. Start a new session to use FCC models.
  • Claude Code in JetBrains ACP: Install Claude Agent in JetBrains AI Assistant and start it once, then click Connect in FCC. Reopen the IDE, select Claude Code (FCC), and start a new chat. After JetBrains updates the agent, restart FCC before starting a new chat. Requires a local IDE in its standard installation locations.

Reload VS Code or restart the app/IDE after connecting. In Codex and Claude Desktop, select an FCC model from the model picker. Reload or restart the client when FCC reports updated settings. Use Disconnect on the same card to remove the integration.

To complete Claude Code onboarding separately, open Admin UI → Integrations → Claude Code onboarding and click Complete onboarding. Connecting Claude Code in VS Code also completes onboarding.

Run FCC on the same computer and in the same user environment as the client you are configuring.

Optional Integrations

Configure integrations from Admin UI → Messaging, then click Apply.

Discord bot 1. Create a bot in the [Discord Developer Portal](https://discord.com/developers/applications). 2. Enable **Message Content Intent** and invite it with read, send, message-history, and **Manage Messages** permissions so `/clear` can remove user prompts. 3. Set **Messaging Platform** to **discord**. 4. Enter **Discord Bot Token**, **Allowed Discord Channels**, and an absolute **Allowed Directory**. 5. Apply the settings and restart the server if requested.
Telegram bot 1. Create a bot with [@BotFather](https://t.me/BotFather). 2. Get your numeric user ID from [@userinfobot](https://t.me/userinfobot). In groups, grant the bot permission to delete messages. 3. Set **Messaging Platform** to **telegram**. 4. Enter **Telegram Bot Token**, **Allowed Telegram User ID**, and an absolute **Allowed Directory**. 5. 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 Clear all FCC conversations and their messages in this chat.
Reply with /clear Delete the selected message and the chain of replies to it. Keep other conversations.
Voice notes NVIDIA NIM transcription support is included in every installation. In **Admin UI → Messaging → Voice**, enable voice notes, select `nvidia_nim`, and choose a supported model. Configure your **NVIDIA NIM API key** on the Providers page. For local Whisper on CPU or CUDA, re-run the installer with the local voice option: macOS/Linux: Local Whisper on CPU or CUDA: 
curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh -s -- --voice-local
Local Whisper with CUDA 13.0: 
curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.sh" | sh -s -- --voice-local --torch-backend cu130
Windows PowerShell: Local Whisper on CPU or CUDA: 
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1"))) -VoiceLocal
Local Whisper with CUDA 13.0: 
& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install.ps1"))) -VoiceLocal -TorchBackend cu130
After installing local support, restart `fcc-server`. In **Admin UI → Messaging → Voice**, enable voice notes, select `cpu` or `cuda`, and choose the Whisper model. Local gated models need `HUGGINGFACE_API_KEY`.

Manage Your Installation

Run fcc-server --version to check the installed version without starting FCC.

Update

Stop all running FCC commands, then run:

fcc-update

The update installs the checked stable FCC release with its matching installer.

If fcc-update is unavailable or fails, try running the install command again.

To reinstall FCC or change optional components while already up to date, run the installer directly.

For local voice support, include --voice-local (macOS/Linux) or -VoiceLocal (Windows), plus your --torch-backend or -TorchBackend option if used.

Muse Code on native Windows

To install or update only Muse Code:

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/install-muse.ps1")))

To remove the Muse Code copy installed by FCC, keeping its data:

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/uninstall-muse.ps1")))

Uninstalling FCC leaves Muse Code installed.

Uninstall

Stop every running FCC command and quit connected desktop/editor apps before uninstalling.

Removes

  • Free Claude Code, including its desktop launcher and commands
  • ~/.fcc/

Keeps

  • uv and Python
  • Your coding agents, RTK, and Headroom

macOS/Linux:

curl -fsSL "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/uninstall.sh" | sh

Windows PowerShell:

& ([scriptblock]::Create((irm "https://raw.githubusercontent.com/Alishahryar1/free-claude-code/main/scripts/uninstall.ps1")))

Project Links

For a problem after installation, run the command below and paste its output into your bug report.

fcc-doctor

License

GNU Affero General Public License version 3 only (AGPL-3.0-only). See LICENSE for details.

📈 近 7 天 Star 趋势

每日新增 Star（柱）与累计 Star（线）· 数据来自 GitHub

🏆 排名变化趋势

在各榜单中的排名历史（数字越小越靠前）

📋 历史上榜记录

每次快照的详细数据
日期 榜单 排名 周期新增 总 STAR