项目核验档案

Alishahryar1/free-claude-code

free-claude-code 是一个本地代理工具，允许 Claude Code、Codex、Pi 及其 IDE 扩展通过自有的提供商代理运行。它支持在本地管理界面中配置和验证多达 25 个云端或本地模型提供商。

项目概览

该项目允许通过单一本地代理在多达 25 个云和本地提供商之间切换，无需修改编码客户端本身。

项目类型: AI 编程 · 模型运行
应用场景: 编程开发
部署方式: 查看项目说明
License: MIT

适合谁

希望通过单一本地代理和 Web 界面管理多个云端与本地提供商，并将其接入 Claude Code 等代理的开发者。
需要通过 Discord 或 Telegram 等消息平台并配合语音输入来与编码代理进行交互的用户。

核心能力

将编码代理的流量通过本地代理进行路由，该代理可连接至 25 个云端和本地提供商。
提供一个本地网页端管理界面，用于集中选择和验证接入的提供商。
兼容各编码客户端自带的原生模型选择器，用户可在客户端内直接选择代理暴露的模型。
支持将 Fable、Opus、Sonnet、Haiku 以及回退流量分别路由至不同的模型。
支持通过 NVIDIA NIM 或 Local Whisper 对语音笔记进行转录，以便在 Claude Code 会话中使用。
针对兼容的提供商，管理客户端的推理控制选项，包括关闭、低、中、高、超高和最大。
提供可选的令牌验证机制，以保护本地代理的安全。
提供可选功能，允许通过 Discord 或 Telegram 机器人运行 Claude Code 会话。

限制与风险

使用本地模型时，模型本身必须具备足够的上下文容量，以处理编码代理的系统提示词和工具定义。

如何开始

通过运行 curl 或 PowerShell 安装脚本完成安装，随后运行 fcc-server 命令。系统会自动打开基于 Web 的管理界面，用户可在其中验证并应用提供商密钥。

替代方案与同类比较

提供无需 DBMS 或云服务的开源代码生成和补全建议，支持消费级 GPU，适合寻求独立本地代码补全服务的用户。
为编码代理提供包括数据库、身份验证和存储在内的后端能力，适合需要代理直接构建全栈应用的场景。
专注于长周期智能体工程的开源混合专家模型，适合在数千轮工具调用中维持效能的任务。

同类比较

核验依据

README: Use Claude Code, Codex, Pi, or their IDE extensions through your own provider-backed proxy.
README: Switch among 25 cloud and local providers from the Admin UI.
README: INFO: Admin UI: http://127.0.0.1:8082/admin (local-only)
README: Route Fable, Opus, Sonnet, Haiku, and fallback traffic to different models.
README: Optionally run Claude Code sessions through Discord or Telegram with voice-note transcription.

来源更新时间：2026-07-15T18:04:47Z

打开原始 GitHub 项目

项目详情

0