免费Claude代码工具

项目概述

Free Claude Code（FCC）是一个独立的开源本地代理，让用户能够将多种 AI 编程代理（Claude Code、Codex、Pi、OpenCode、Cline 等共 11 种）连接到 61 个兼容服务提供方，包括免费、付费、订阅及本地模型。FCC 自动管理 API 密钥、跨提供方的回退切换、token 优化与配额探测，避免账号因违反服务条款而被封禁。

核心特性

• 多提供方统一目录：在一个可搜索界面中使用免费、付费、订阅和本地模型；遵循各提供方条款，若集成不再被允许即移除。
• 代理目录统一：同一模型目录驱动 11 种编程代理，包括 Claude Code、Codex、Pi、OpenCode、Cline、Hermes、DeepSeek Harness、Grok Build、Muse Code、Aider、VS Code Chat。
• 故障自动切换：重试耗尽后自动尝试下一个回退模型，整个会话无需用户手动重启。
• token 使用量优化：可选 RTK 过滤常见命令输出、Headroom 压缩工具结果；另有 5 项内置优化处理配额探测、命令前缀检测、标题、建议与路径，无需调用提供方。
• 浏览器原生 Codex 会话：在浏览器中实时或后台运行 Codex，可自由切换提供方与模型。
• 多端入口：终端、桌面、IDE（VS Code、JetBrains）、Discord、Telegram 均可接入。
• 语音输入：通过本地 Whisper 或 NVIDIA NIM 转录，将语音笔记转为指令。
• 能力完整保留：流式响应、工具调用、原生交错思考、图片发送、Fable/Opus/Sonnet/Haiku 独立路由均得到支持。

安装

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")))

安装过程中至少选择一个编程代理，并可启用 RTK + Headroom token 优化。

启动与配置

• Windows：从桌面或开始菜单打开 Free Claude Code。
• macOS：从桌面或 Applications 文件夹打开。
• Linux：执行 fcc-server，保持终端开启。

启动后打开 Admin UI。首次配置以 NVIDIA NIM 为例：在 build.nvidia.com 生成 API 密钥，在 Admin UI 的 Providers 中粘贴并保存，MODEL 默认 nvidia_nim/nvidia/nemotron-3-super-120b-a12b，点击 Apply 即可。

运行编程代理

fcc-claude    # Claude Code
fcc-codex     # Codex
fcc-pi        # Pi
fcc-opencode  # OpenCode 2
fcc-cline     # Cline
fcc-hermes    # Hermes
fcc-dsh       # DeepSeek Harness Web
fcc-grok      # Grok Build
fcc-muse      # Muse Code
fcc-aider     # Aider

可在 Claude Code 原生 /model 选择器中挑选 FCC 模型。

选择提供方

在 Admin UI 的 Providers 页面配置对应设置项；OpenAI/ChatGPT 订阅通过 OAuth 提供方接入。在 MODEL 下拉框中搜索并选择模型，或按 <provider-id>/<exact-provider-model-id> 手动输入。可选配置有序的 Fallback Models 列表，失败请求将按顺序尝试多个提供方。

支持 JSON 数组形式的多个 API 密钥：

NVIDIA_NIM_API_KEY='["your-first-key","your-second-key"]'

如需自定义端点，可通过 Providers → Custom providers 添加 API Base URL、密钥与 API 格式。

内置提供方包括：NVIDIA NIM、OpenRouter、Groq、OpenAI/ChatGPT、xAI、Anthropic、Azure OpenAI、Google AI Studio、Vertex AI、DeepSeek、Mistral、Cohere、Hugging Face、AWS Bedrock、阿里云 Model Studio、QwenCloud、Cerebras、SambaNova、Cloudflare Workers AI、Ollama、LM Studio、llama.cpp 等共 61 个。

模型路由与推理控制

可为 MODEL_FABLE、MODEL_OPUS、MODEL_SONNET、MODEL_HAIKU 单独指定模型；MODEL 作为整体回退。在 Model Config 中可设置有序的回退模型，每个回退独立指定推理强度（Inherit/Off/From Client/Low/Medium/High/X-High/Max）。Default Effort 默认为 From Client，四个 Claude 层级默认为 Inherit。

连接客户端

在 Admin UI → Integrations 中点击对应卡片完成连接，支持 Claude Code VS Code 扩展、VS Code Chat、Claude Desktop、Codex VS Code/App、DeepSeek Harness Desktop、Claude Code JetBrains ACP。连接后需重启 VS Code 或应用，Codex/Claude Desktop 中通过模型选择器切换至 FCC 模型。

可选集成

Discord / Telegram 机器人

在 Admin UI → Messaging 中配置平台、Bot Token、允许的频道或用户 ID，以及允许操作的绝对目录。

消息命令

用法	行为
/stats	显示会话状态
独立 /stop	取消全部任务
回复 /stop	仅取消所选请求
独立 /clear	清除本聊天所有会话
回复 /clear	删除所选消息及其回复链

语音笔记

NVIDIA NIM 转录内置支持。如需本地 Whisper：

curl -fsSL ".../install.sh" | sh -s -- --voice-local
# CUDA 13.0
curl -fsSL ".../install.sh" | sh -s -- --voice-local --torch-backend cu130

Windows 对应使用 -VoiceLocal 与 -TorchBackend。

管理安装

fcc-server --version   # 查看版本
fcc-update             # 更新
fcc-doctor             # 收集诊断信息（自动复制 JSON 到剪贴板）

更新前需停止所有运行中的 FCC 命令；卸载脚本会移除 FCC 与 ~/.fcc/，但保留 uv、Python、各编程代理、RTK 与 Headroom。

许可证

GNU Affero 通用公共许可证第三版（AGPL-3.0-only）。