Alishahryar1/free-claude-code

⭐ 23,393 · Python · GitHub 仓库

在终端、VSCode扩展或Discord中免费使用claude-code，支持语音（类似OpenClaw）。

一句话总结

Free Proxy 将 Claude Code 的路由导向替代提供商，让你能够以零成本使用本地或第三方模型进行 AI 编码。

🔥 核心能力与独特卖点

多提供商后端路由：将 Claude Code 的 API 流量路由至 八家不同提供商，包括免费选项（NVIDIA NIM、Kimi）和本地模型（LM Studio、Ollama、llama.cpp）。通过赋予你完全的提供商灵活性，直击 Anthropic 付费 API 定价的核心痛点。
按模型智能路由：为 Opus、Sonnet、Haiku 及回退流量分别指定提供商。这意味着你可以为简单任务使用免费提供商，为复杂推理使用更强大（或本地）的模型——同时优化成本与性能。
本地管理界面与验证：基于浏览器的 /admin 界面让你配置代理设置、实时验证变更并测试提供商连接性。无需再猜测配置是否正确——即刻获得实时反馈。
聊天平台集成：可选的 Discord 和 Telegram 机器人封装支持通过聊天平台进行远程编码会话，并借助本地 Whisper 或 NVIDIA NIM 实现语音笔记转录。将 Claude Code 转变为协作式、支持语音的编码助手。

独特卖点：这是唯一一个为 Claude Code 的完整客户端协议（终端、VS Code 扩展、JetBrains）提供即插即用代理的项目，同时支持免费、付费和本地模型——且无需修改 Claude Code 本身。

Architecture

技术架构

组件	详情
语言	Python 3.14
包管理器	uv (Astral)
关键依赖	Loguru（日志）、Ruff（代码格式化）、Pytest（测试）、Ty（类型检查）
传输协议	OpenAI 聊天翻译 + Anthropic Messages API 格式
配置	`~/.config/free-claude-code/.env` 中的环境变量
安全性	管理界面仅限于本地回环（远程请求返回 403）
部署	单条 `uv tool install` 命令，作为本地代理服务器运行

快速入门指南

bash

# 安装依赖（macOS/Linux）
curl -LsSf https://astral.sh/uv/install.sh | sh
uv self update
uv python install 3.14

# 安装依赖（Windows PowerShell）
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv self update
uv python install 3.14

# 安装代理
uv tool install git+https://github.com/Alishahryar1/free-claude-code.git

# 启动代理
free-claude-code

# 通过代理运行 Claude Code（PowerShell）
$env:ANTHROPIC_AUTH_TOKEN="freecc"; $env:ANTHROPIC_BASE_URL="http://localhost:8082"; $env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"; claude

# 通过代理运行 Claude Code（Bash）
ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 claude

优势、局限与使用场景

优势

完全免费：借助 NVIDIA NIM 和 Kimi 等受支持提供商
支持本地模型（LM Studio、Ollama、llama.cpp），适用于离线/私有使用
按模型路由：让你智能地混合使用免费和付费提供商
活跃项目：拥有 23,393 颗星，势头强劲
即插即用：无需修改 Claude Code

局限

需要 Python 3.14 和 uv 安装，可能与现有 Python 环境冲突
管理界面仅限本地：无法从其他设备进行远程管理或基于 Web 的监控
部分提供商需要 API 密钥（OpenRouter、DeepSeek、Wafer），降低了这些后端的“免费”属性
本地模型需要强大硬件（GPU、RAM）和手动配置

不适合谁使用？

需要 SLA 支持的企业团队——这是一个社区项目，无任何保证
希望获得完全托管解决方案的用户——你必须自行配置和维护代理
需要严格安全审计的团队——通过第三方提供商路由会引入数据隐私考量
使用 Python 3.13 或更旧版本的用户——该项目要求 Python 3.14

理想使用场景

个人开发者：希望使用 Claude Code 的界面，但无需支付 Anthropic API 费用
爱好者和探索者：尝试不同模型提供商（免费云、本地或混合）
注重隐私的用户：通过 LM Studio 或 Ollama 运行本地模型，同时使用 Claude Code 的 UI
预算有限的团队：能够接受来自 NVIDIA NIM 等免费提供商的最佳努力性能

社区与活跃度

拥有 23,393 颗星且最后更新于 2026 年 5 月 10 日，该项目显然在开发者社区中引起了强烈共鸣。仅星标数量就表明了巨大的兴趣——这不是一个小众工具，而是一场运动。它仍在积极维护（近期更新）的事实意味着你并非跳上一个已死的项目。免费访问、本地模型支持和聊天平台集成的组合，显然让厌倦了 API 定价壁垒的开发者找到了共鸣。这是一个可能从根本上改变团队评估 Claude Code 采纳方式的项目。

Alishahryar1/free-claude-code ​

一句话总结 ​

🔥 核心能力与独特卖点 ​

技术架构 ​

快速入门指南 ​

优势、局限与使用场景 ​

优势 ​

局限 ​

不适合谁使用？ ​

理想使用场景 ​

社区与活跃度 ​