Alishahryar1/free-claude-code
⭐ 23,393 · Python · GitHub 仓库
在终端、VSCode扩展或Discord中免费使用claude-code，功能类似OpenClaw（支持语音）。
一句话总结
一个可将 Claude Code 流量路由至免费、本地或替代模型提供商的代理，绕开 Anthropic 付费订阅。
🔥 核心能力与独特卖点
- 多提供商后端支持：将 Claude Code 的 API 调用路由至 八个不同提供商，包括 NVIDIA NIM、Kimi、Wafer、OpenRouter、DeepSeek、LM Studio、llama.cpp 和 Ollama。彻底消除单一供应商锁定和 Anthropic 付费层的周期性订阅成本。
- 按模型路由：可独立为 Opus、Sonnet、Haiku 及回退流量分配不同提供商。完美解决成本与能力之间的权衡痛点——用强大的免费提供商处理复杂推理，用轻量级本地模型处理简单任务。
- 本地管理界面：通过
/admin路径提供 Web 界面，用于配置代理设置、验证更改并检查提供商健康状态。省去手动编辑配置文件的繁琐，实时反馈提供商连接状态。 - Discord/Telegram 机器人封装：可选的机器人集成支持远程编码会话，并具备语音笔记转录功能。将 Claude Code 的实用性扩展到团队协作和移动端工作流。
- 流式响应与工具调用：支持流式响应、工具调用、推理块及本地请求优化。完整保留 Claude Code 体验——包括实时输出和智能体工具调用——毫无降级。
独特卖点：与简单的 API 密钥替换不同，该项目提供了一个生产级代理，在保持与 Claude Code 客户端协议兼容的同时，提供精细的提供商路由、管理仪表盘和可选的机器人封装——全部零订阅成本。
技术架构
| 组件 | 详情 |
|---|---|
| 编程语言 | Python 3.14 |
| 包管理器 | uv (Astral) |
| 关键库 | Pytest（测试）、Ty（类型检查）、Ruff（代码检查）、Loguru（日志） |
| 代理服务器 | 将 Anthropic Messages API 调用路由至特定提供商适配器 |
| 管理界面 | Web 界面（仅回环地址）用于配置管理 |
| 提供商适配器 | 将 Anthropic API 格式转换为提供商特定 API（NVIDIA、Kimi、OpenRouter 等） |
| 机器人封装 | 可选的 Discord/Telegram 机器人，支持带语音转录的远程编码 |
| 配置 | 环境变量存储在 ~/.config/free-claude-code/.env |
快速入门指南
安装 Python 3.14 和 uv（跨平台）：
bash
# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
uv self update
uv python install 3.14powershell
# Windows PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv self update
uv python install 3.14安装并启动代理：
bash
uv tool install git+https://github.com/Alishahryar1/free-claude-code.git
free-claude-code通过代理运行 Claude Code：
bash
# Bash
ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 claudepowershell
# PowerShell
$env:ANTHROPIC_AUTH_TOKEN="freecc"; $env:ANTHROPIC_BASE_URL="http://localhost:8082"; $env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"; claude优缺点与使用场景
优点
- 零订阅成本，使用支持的免费提供商即可运行 Claude Code
- 灵活的提供商切换，按模型层级（Opus、Sonnet、Haiku）独立配置
- 管理界面简化配置与调试流程
- 支持本地模型（LM Studio、llama.cpp、Ollama），适用于离线或私有工作负载
- 机器人集成支持团队协作和语音驱动编码
缺点
- 需要 Python 3.14 和 uv 安装——并非零依赖的即插即用方案
- 管理界面仅限回环地址，无 SSH 隧道则无法远程管理
- 部分提供商需要 API 密钥，所谓"免费"可能仍需注册第三方服务
- 模型选择器支持取决于 Claude Code 是否启用 Gateway 模型发现——并非所有版本都保证支持
不适合哪些用户？
- 有严格合规需求的企业团队，无法将 API 流量路由至第三方代理或未批准的提供商
- 需要 Anthropic 官方 SLA、支持和数据隐私保障的用户——该代理不提供任何正常运行时间承诺或数据处理保证
- Python 版本低于 3.14 的开发者，无法升级其环境
- 需要多用户管理权限的团队——单用户回环界面不支持团队管理
理想使用场景
- 希望免费体验 Claude Code 的个人开发者，无需 Anthropic 付费订阅
- 运行本地模型（Ollama、LM Studio）的爱好者和开源贡献者，希望使用 Claude Code 的界面
- 正在评估多个模型提供商以优化成本和性能的团队
- 使用 Discord/Telegram 机器人进行远程协作的场景，结合语音转录实现结对编程
社区与活跃度
该项目拥有 23,393 颗星，截至 2026 年 5 月仍有更新，显然在开发者社区中引起了强烈共鸣。星标数量充分证明了其价值——开发者正在积极寻找供应商锁定 AI 工具的替代方案。项目的持续更新表明维护者正在积极处理与最新 Claude Code 版本及提供商 API 变更的兼容性问题。对于一个从根本上改变 Claude Code 使用成本逻辑的工具而言，这种社区热度既令人印象深刻，也为长期维护提供了有力保障。