Windows 11 完整终极教程
cc-nim + NVIDIA API + Claude Code CLI
📌 你的固定配置（全程使用，请勿修改）
API 密钥：nvapi-****
官方接口：https://integrate.api.nvidia.com/v1
模型名称：z-ai/glm4.7、minimaxai/minimax-m2.1
一、环境准备（必做，解决所有安装/版本冲突）
1. 卸载旧Python + 重启电脑
- 打开
设置 → 应用 → 已安装的应用 - 卸载 所有Python/Microsoft Store Python
- 重启电脑（解决文件占用报错
0x80070020）
2. 安装最新版 Python（官网独立包）
- 下载：www.python.org/downloads/
- 安装时 必须勾选
Add Python.exe to PATH - 验证（新开PowerShell）：
python -V
# 显示 Python 3.13+ 即为成功
3. 安装 Git（下载cc-nim用）
下载：git-scm.com/download/wi… → 默认安装即可
二、部署 cc-nim 代理（核心步骤）
1. 下载源码
打开 PowerShell，逐行执行：
# 进入你的工作目录
cd D:\gz\szcx
# 下载cc-nim
git clone https://github.com/alishahryar1/cc-nim.git
# 进入项目文件夹
cd cc-nim
2. 生成配置文件
# 复制模板配置
copy .env.example .env
# 打开配置文件
notepad .env
3. 填写配置（直接全选粘贴，替换你的密钥）
# ===================== 你的专属配置 =====================
NVIDIA_NIM_API_KEY=nvapi-****
NVIDIA_NIM_BASE_URL=https://integrate.api.nvidia.com/v1
NVIDIA_NIM_MODEL=z-ai/glm5
# 固定配置
HOST=127.0.0.1
PORT=8000
LOG_LEVEL=info
# =======================================================
保存记事本，关闭文件。
4. 一键安装所有依赖
pip install .
等待显示 Successfully installed 即完成。
三、启动 cc-nim 代理
执行命令，窗口保持打开，不要关闭！
python -m uvicorn server:app --host 127.0.0.1 --port 8000
✅ 成功标志：Uvicorn running on http://127.0.0.1:8000
四、配置 Claude Code CLI（新开 PowerShell 窗口）
1. 设置环境变量
# 指向本地代理
$env:ANTHROPIC_BASE_URL="http://127.0.0.1:8000"
# 你的NVIDIA密钥
$env:ANTHROPIC_API_KEY="nvapi-****"
2. 永久设置默认模型
claude config model z-ai/glm5
五、开始使用（全功能兼容）
直接执行 claude 命令，支持代码生成、解释、重构：
# 生成代码
claude "写一个Python快速排序，加中文注释"
# 解释本地代码文件
claude "解释这段代码" < main.py
# 代码优化
claude "优化这个函数性能" < test.py
六、常见问题（一键修复所有报错）
1. 模型报错：z-ai/glm5 不存在/无权限
执行命令切换官方可用模型：
claude config model z-ai/glm4.7
2. 端口被占用
修改 .env 中 PORT=8001，重启代理。
3. 401 Unauthorized
检查 .env 中 NVIDIA_NIM_API_KEY 是否正确。
4. Python 命令报错
用 py 替代 python：
py -m uvicorn server:app --host 127.0.0.1 --port 8000
✅ 最终总结
- 全程适配你的配置：密钥/接口/模型完全一致
- 无环境冲突：官网Python + 纯净部署
- 一键运行：启动代理 → 配置CLI → 直接使用
- 完美兼容：支持 Claude Code CLI 所有功能
