乐于分享
好东西不私藏

1.2w星爆火开源神器!零成本免费用专业AI编码助手Claude Code

1.2w星爆火开源神器!零成本免费用专业AI编码助手Claude Code


一、项目基本信息

https://github.com/Alishahryar1/free-claude-code

✨ Star数:12004 | 🍴 Fork数:1791 | 💻 开发语言:Python | 📄 开源协议:MIT 是当下非常热门的零成本AI编码助手解决方案,人气极高。


二、项目概要

该项目是一款轻量代理层工具,可把官方Claude Code(Anthropic推出的专业编码助手CLI和VSCode/IDEA插件)的API请求无缝转发到其他低成本甚至免费的大模型服务商,完全不需要Anthropic官方API密钥。目前支持NVIDIA NIM(提供每分钟40次免费调用额度)、OpenRouter、DeepSeek三类在线服务商,以及LM Studio、llama.cpp、Ollama三类本地模型运行方案,无需修改Claude Code的任何原生代码,仅需配置2个环境变量即可使用,还支持多模型映射、思维链解析、请求配额优化、聊天机器人对接等扩展功能,上手门槛极低,是普通用户低成本使用专业AI编码助手的首选方案。


三、核心痛点解决

Anthropic官方Claude Code需要付费订阅或调用收费API,使用成本较高,且代码数据需要上传到Anthropic官方服务器存在隐私泄露风险;同时很多用户希望复用Claude Code成熟的编码工作流,对接其他效果更好、成本更低的大模型,甚至用本地开源大模型私有化部署,本项目完美解决了这些问题,让用户可以零成本、高隐私地使用Claude Code的完整能力。


四、主要功能特性

1.零成本使用:NVIDIA NIM提供免费调用额度,本地部署完全无成本2.无缝兼容:无需修改Claude Code源码,仅需配置2个环境变量即可生效3.多服务商适配:支持6类主流大模型服务,可灵活切换4.多模型映射:可将Claude的Opus/Sonnet/Haiku三个等级分别映射到不同服务商的不同模型,灵活搭配5.体验完全对齐:自动解析思维链标签、工具调用格式,完全对齐Claude原生体验6.性能优化:自动拦截5类无用请求节省配额,智能限流避免触发服务商限制7.扩展能力强:自带Discord/Telegram机器人支持,可快速搭建远程自动编码Agent8.易扩展:采用模块化设计,新增服务商或对接其他平台仅需少量代码

五、技术架构体系

 项目采用分层模块化架构,入口为server.py启动的FastAPI服务:

API路由层负责接收Claude Code的标准请求请求优化模块拦截无用请求直接返回结果节省配额,模型路由模块根据配置将不同等级的Claude请求转发到对应模型协议转换层负责在Anthropic格式和服务商接口格式之间双向转换多服务商适配层封装了6类服务商的调用逻辑,新增服务商仅需继承基类实现少量代码即可内置限流和会话管理模块,保障服务稳定运行

六、适用场景

1.个人开发者/学生日常编码,想免费使用专业AI编码助手2.对代码隐私有要求的企业团队,私有化部署用本地模型处理内部代码3.大模型评测人员,快速切换不同模型对比编码效果4.AI Agent开发者,基于该项目快速搭建自动编码机器人

七、同类竞争优势

对比市面上其他Claude代理工具,本项目支持的服务商更多,覆盖在线免费额度、商用API、本地部署三类场景,且完全无缝兼容原生Claude Code的所有功能,无需修改插件源码,还自带请求优化、多模型映射、机器人对接等独有功能,社区活跃更新快,文档齐全上手门槛极低,是目前同类工具中功能最完善、用户最多的解决方案。


八、目标受众

个人开发者、在校学生、企业开发团队、AI工具二次开发者、自动编码Agent研发人员。


九、快速上手示例

前置准备

1.先安装官方Claude Code工具2.去NVIDIA NIM官网申请免费API Key3.安装uv包管理器

运行步骤

# 1. 克隆项目到本地git clone https://github.com/Alishahryar1/free-claude-code.gitcd free-claude-code# 2. 复制配置文件模板cp .env.example .env# 3. 编辑.env文件,填入你申请的NVIDIA NIM API Key,其他配置默认即可# NVIDIA_NIM_API_KEY="nvapi-你的密钥"# 4. 启动代理服务,默认运行在8082端口uv run uvicorn server:app --host 0.0.0.0 --port 8082# 5. 新开终端,设置环境变量启动Claude Code即可使用ANTHROPIC_AUTH_TOKEN="freecc" ANTHROPIC_BASE_URL="http://localhost:8082" claude

VSCode插件配置

如果要在VSCode中使用,打开设置搜索claude-code.environmentVariables,编辑settings.json添加:

"claudeCode.environmentVariables": [  { "name": "ANTHROPIC_BASE_URL", "value": "http://localhost:8082" },  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "freecc" }]

重载插件后即可使用。


十、关联项目推荐

1.https://github.com/anthropics/claude-code :Anthropic官方的Claude Code项目,是本项目的依赖使用对象,想要体验完整功能需要先安装该项目。2.https://github.com/ollama/ollama :热门的本地大模型运行工具,配合本项目可以实现完全本地化的AI编码助手,无需联网即可使用。3.https://github.com/lmstudio-ai/lmstudio :图形化的本地大模型管理工具,无需复杂命令即可下载运行开源大模型,适合新手搭配本项目使用。