核心优势#

1. 零成本使用：直接调用 NVIDIA NIM 免费接口，每分钟 40 次请求，完全够用
2. 完美伪装：Claude Code 完全无感，以为还在和 Anthropic 官方通信
3. 思考链保留：GLM、DeepSeek R1 等模型的思考过程完美显示
4. 工具调用救活：开源模型不规范的 Tool Call 输出，代理自动解析成 Claude 能识别的格式
5. 智能限流：内置并发控制和 429 退避，避免免费 API 被限流
6. 多 Provider 混搭：一个配置同时使用不同提供商的模型

支持的模型提供商#

第一步：准备 NVIDIA API Key#

如果没有，先去 build.nvidia.com 申请一个 nvapi- 开头的 Key。

第二步：克隆项目#

1
git clone https://github.com/Alishahryar1/free-claude-code.git
2
cd free-claude-code

第三步：安装依赖#

这个项目使用 Python，需要先安装 uv：

1
pip install uv
2
uv sync

第四步：配置 .env 文件#

1
NVIDIA_NIM_API_KEY="nvapi-你的Key"
2

3
# 模型映射：所有 Claude 模型都映射到这里
4
MODEL_OPUS="nvidia_nim/z-ai/glm-5.1"
5
MODEL_SONNET="nvidia_nim/z-ai/glm-5.1"
6
MODEL_HAIKU="nvidia_nim/z-ai/glm-5.1"
7
MODEL="nvidia_nim/z-ai/glm-5.1"
8

9
ENABLE_THINKING=true
10
PROVIDER_RATE_LIMIT=40

第五步：启动代理#

1
uv run uvicorn server:app --host 0.0.0.0 --port 8082

第六步：配置 Claude Code#

编辑 C:\Users\Administrator\.claude\settings.json：

1
{
2
  "env": {
3
    "ANTHROPIC_BASE_URL": "http://localhost:8082",
4
    "ANTHROPIC_AUTH_TOKEN": "ccnim"
5
  }
6
}

第七步：运行测试#

直接启动 Claude Code：

1
claude

然后说 “你好” 测试。

⚠️ 重要：不要在 Claude Code 中使用 /model minimaxai/minimax-m2.7！正确方式是直接说话，代理会自动映射到你在 .env 中配置的模型。

Q: free-claude-code 和 CC Switch 有什么区别？#

为什么 free-claude-code 成功率更高？

1. 模型名称格式统一：CC Switch 需要手动填写模型名，容易填错（如大小写、命名空间），free-claude-code 用 .env 统一配置，格式固定
2. 完整的请求转换：CC Switch 可能只做了简单的模型名替换，而 free-claude-code 做了完整的 API 格式转换（包括 thinking、tool call 等）
3. 无残留配置干扰：直接修改 settings.json 比工具更干净，CC Switch 可能有残留配置影响
4. 社区验证：free-claude-code 是 GitHub 上最受欢迎的 Claude Code 代理方案，文档详细，问题容易排查

Q: 一定要用批处理脚本吗？#

不需要！ 配置好 settings.json 后，在任意终端运行 claude 都会自动走代理。

如果你不想每次手动启动代理，可以创建一个 启动代理.bat 双击运行：

1
@echo off
2
cd /d D:\project2026\free-claude-code
3
start "NVIDIA NIM Proxy" cmd /k ".venv\Scripts\uvicorn.exe server:app --host 0.0.0.0 --port 8082"

Q: 为什么还是报错 “model may not exist”？#

检查三点：

1. Claude Code 的 settings.json 是否正确设置了 ANTHROPIC_BASE_URL 为 http://localhost:8082
2. 代理是否正在运行（端口 8082 是否监听）
3. .env 中的模型名称是否正确（带命名空间，如 z-ai/glm-5.1）

Q: 免费额度够用吗？#

NVIDIA NIM 免费层 40 次/分钟，对于日常开发完全够用。复杂任务建议适当放慢速度。

Q: 可以同时用多个模型吗？#

可以！在 .env 中为 MODEL_OPUS、MODEL_SONNET、MODEL_HAIKU 分别设置不同的模型，实现混合使用。

Q: 切换模型怎么操作？#

1. 编辑 D:\project2026\free-claude-code\.env
2. 修改 MODEL 的值：

   1
   MODEL="nvidia_nim/z-ai/glm-5.1"      # GLM-5.1
   2
   MODEL="nvidia_nim/minimaxai/minimax-m2.7"  # MiniMax M2.7
   3
   MODEL="nvidia_nim/moonshotai/kimi-k2-thinking"  # Kimi K2
   

3. 重启代理（双击 启动代理.bat）