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