1. 项目概述与背景
在Windows环境下使用AI模型进行开发时,直接调用商业API往往面临诸多限制。free-claude-code项目为解决这一问题提供了优雅的中转方案,它能够将Claude模型的请求映射到英伟达NVIDIA提供的各类开源模型上。这个方案特别适合需要在本地开发环境中快速切换不同AI模型的开发者。
我最近在实际项目中采用了这个方案,发现它不仅解决了API调用限制问题,还意外地带来了模型选择的灵活性。通过简单的配置修改,就能在Claude的交互界面中无缝切换到GLM5、MiniMax等优质模型,这在多模型对比测试时尤为实用。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与工具安装
2.1 获取项目代码
首先需要将free-claude-code项目克隆到本地。打开PowerShell或命令提示符,执行以下命令:
bash复制git clone https://github.com/Alishahryar1/free-claude-code.git
这个命令会在当前目录下创建free-claude-code文件夹,包含项目所有必要文件。我建议将这个文件夹放在容易访问的位置,比如用户目录下的Projects文件夹中。
提示:如果遇到网络问题导致克隆失败,可以尝试使用GitHub的ZIP下载功能,但后续更新会不太方便。
2.2 安装UV工具链
项目依赖UVicorn作为服务器运行环境。Windows用户可以直接下载预编译版本:
- 访问UV的GitHub发布页
- 下载
uv-x86_64-pc-windows-msvc.zip文件 - 解压得到uv.exe文件
我个人的经验是将uv.exe放在C:\Users\[用户名]\.uv目录下比较合适。然后需要将这个目录添加到系统PATH环境变量中:
- 按下Win+S搜索"环境变量"
- 选择"编辑账户的环境变量"
- 在用户变量中找到Path并编辑
- 添加UV所在的目录路径
验证安装是否成功:
bash复制uv --version
应该能看到版本号输出(如0.11.2)。
3. 配置详解与模型映射
3.1 配置文件修改
项目根目录下的.env文件是关键配置文件。建议先备份原始配置:
bash复制copy .
