免费Claude代码工具
一句话简介
一个基于Python的免费Claude代码辅助项目,提供类似Claude Code的编程辅助能力,无需付费即可使用AI协助完成编码任务。
标签
适用应用场景
- 日常编码问答与调试
- 代码片段生成与补全
- 学习新技术栈的示例参考
- 个人项目中的免费AI编程辅助
README 中文摘要
项目概述
Free Claude Code(FCC)是一个独立的开源项目,整合了 50 余家服务条款友好的模型提供商,每月可调度超过 13 亿免费 token。用户可在统一的管理界面中混用免费、付费、订阅及本地模型,无需担心账号风险。当某个提供商不可用时,FCC 会自动按回退顺序切换到下一个模型,无需用户重启当前回合。
核心特性
多代理接入
FCC 提供 9 款主流编码 Agent 的本地代理入口,共享同一套模型目录:
fcc-claude:Claude Codefcc-codex:Codexfcc-pi:Pifcc-opencode:OpenCodefcc-cline:Clinefcc-hermes:Hermesfcc-dsh:DeepSeek Harness Webfcc-grok:Grok Buildfcc-muse:Muse Code
Agent 能力保持完整,包括流式响应、工具调用、原生交错思考、图像发送,以及 Fable / Opus / Sonnet / Haiku 四个 Claude 等级独立路由。
终端输出优化
可选的 RTK 过滤器可削减最多 90% 的终端输出 token。FCC 本身也实现了五项优化:配额探测、命令前缀检测、标题生成、建议改写、文件路径处理,全部不调用上游模型。
多端接入
支持终端、桌面、IDE 与手机端:通过原生启动器、VS Code 扩展、Codex App、JetBrains ACP、Discord、Telegram 等渠道接入。Discord 和 Telegram 机器人配置在 Admin UI 的 Messaging 面板中完成。
语音输入
通过本地 Whisper 或 NVIDIA NIM 进行语音转写,再交给 Agent 处理。重跑安装脚本并附加 --voice-nim 或 --voice-local 参数即可启用。
快速开始
安装或更新
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")))
按提示选择至少一个编码 Agent 和可选的 RTK,重新执行同一命令即可更新。
启动与配置
- Windows:双击桌面或开始菜单中的 Free Claude Code。
- macOS:从桌面或 Applications 文件夹打开。
- Linux:在终端执行
fcc-server。
启动后 Admin UI 自动打开,可在 UI 中粘贴 NVIDIA_NIM_API_KEY 等配置,点击 Validate 与 Apply 即可启用。
客户端连接
启动 fcc-server 后运行任意 fcc-* 命令即可使用对应 Agent。IDE 接入需要在用户配置中追加代理地址与令牌,例如 VS Code 中 Claude Code 扩展的 JSON 配置:
"claudeCode.environmentVariables": [
{ "name": "ANTHROPIC_BASE_URL", "value": "http://localhost:8082" },
{ "name": "ANTHROPIC_AUTH_TOKEN", "value": "freecc" }
]
Codex 与 Codex App 需在 ~/.codex/config.toml 中配置 model_provider、base_url 与鉴权命令。
提供商与本地模型
提供商目录
涵盖 NVIDIA NIM、OpenRouter、Groq、ClinePass、OpenAI/ChatGPT(订阅模式)、xAI、QwenCloud(Token 与 Coding Plan)、Together AI、DeepInfra、SiliconFlow、Nebius、Chutes、Featherless AI、Agnes AI、ZenMux、W&B Inference、Azure OpenAI、Google AI Studio、Vertex AI、DeepSeek、Mistral La Plateforme、Codestral、OpenCode Zen/Go、Vercel AI Gateway、Amazon Bedrock、Hugging Face、Cohere、GitHub Models、Wafer、Kimi API/Code、Cerebras、SambaNova、Kilo.ai、Fireworks、Novita、Cloudflare、Z.ai、TokenRouter、NaraRoute、Poolside、LLM7、Ollama Cloud 等数十家。
本地模型
- LM Studio:
lmstudio/<模型 ID>,默认http://localhost:1234/v1 - llama.cpp:
llamacpp/<模型 ID>,默认http://localhost:8080/v1 - Ollama:
ollama/<标签>,默认http://localhost:11434
本地模型应选择具备工具调用能力且上下文足够大的版本。
模型分级路由
MODEL 是所有请求的回退默认值。可单独为 MODEL_FABLE、MODEL_OPUS、MODEL_SONNET、MODEL_HAIKU 配置覆盖模型;选择 None 时沿用 MODEL。例如把 Opus 路由到 NVIDIA NIM、Sonnet 路由到 OpenRouter 免费层、Haiku 路由到本地 LM Studio,同时保留 MODEL 为 Z.ai。
推理控制
在 Admin UI 的 Model Config → Reasoning 中选择行为:默认跟随客户端;或强制设为 Off / Low / Medium / High / X-High / Max;分级覆盖还支持 Inherit 沿用根配置。提供商若不支持该选项则保留自身默认行为。
管理与卸载
fcc-server --version 查看已安装版本;重跑安装命令即可更新。卸载脚本会移除 FCC、桌面启动器及 ~/.fcc/,但保留 uv、Python、Agent 与 RTK。
许可
MIT 许可证,详见 LICENSE 文件。本项目与 Anthropic 无关,Claude 与 Claude Code 为 Anthropic 的商标。
摘要更新于 2026-08-25 00:30:24
· 原文 25485 字符
· md5 d6d89288f9e9…