1. 项目概述
在当今AI技术快速发展的背景下,本地化部署AI开发助手已成为许多开发者和企业的迫切需求。本文将详细介绍如何在Windows 11环境下,从零开始搭建一个完整的Claude Code AI开发助手本地部署方案,并实现内网环境下的稳定使用。
这个方案的核心价值在于:
- 完全本地化运行,不依赖外部API服务
- 使用轻量级的Qwen:3b模型,适合大多数开发场景
- 通过ollama实现模型管理,简化部署流程
- 支持多种开发环境集成(命令行、VSCode、IDEA等)
整个部署过程涉及多个关键组件:
- Node.js环境搭建
- Git版本控制工具安装
- Ollama模型管理平台部署
- Claude Code AI助手安装与配置
- 内网访问优化设置
2. 环境准备与基础组件安装
2.1 Node.js环境配置
Node.js是运行Claude Code的基础运行时环境,建议使用LTS版本确保稳定性。以下是详细安装步骤:
- 从Node.js官网下载v24.14.0 x64版本安装包(node-v24.14.0-x64.msi)
- 运行安装程序,选择"Customize installation"选项
- 在安装选项中勾选"Add to PATH",确保命令行可直接使用node和npm
- 完成安装后,建议修改npm的全局安装目录和缓存目录:
bash复制npm config set prefix C:\Programs\nodejs\node_global
npm config set cache C:\Programs\nodejs\node_cache
注意:如果使用自定义目录,请确保该目录有写入权限,并手动创建所需文件夹
- 安装nrm(NPM registry manager)方便切换镜像源:
bash复制npm install -g nrm
常见问题排查:
- 如果nrm命令不可用,检查环境变量PATH是否包含node_global目录
- 可能需要重启终端或电脑使环境变量生效
- 验证安装:
node -v和npm -v应显示正确版本号
2.2 Git安装与配置
Git是版本控制工具,虽然不是Claude Code运行的必要条件,但对于代码管理和后续开发非常有用:
- 下载Git 2.53.0 64位安装包(Git-2.53.0-64-bit.exe)
- 运行安装程序,大部分选项保持默认即可
- 在"Adjusting your PATH environment"步骤,建议选择"Git from the command line and also from 3rd-party software"
- 完成安装后验证:
git --version
3. Ollama模型管理平台部署
3.1 Ollama安装与配置
Ollama是一个开源的本地大语言模型运行平台,我们将使用它来管理Qwen模型:
- 下载Ollama安装包(OllamaSetup.exe)
- 使用自定义安装路径(避免C盘空间不足问题):
bash复制.\OllamaSetup.exe /DIR="D:\ollama"
- 设置模型存储路径环境变量:
- 新建系统变量:OLLAMA_MODELS
- 变量值设为自定义路径,如:D:\ollama\models
3.2 模型操作与管理
Ollama提供了简单的命令行接口来管理模型:
bash复制# 拉取Qwen:3b模型
ollama pull Qwen:3b
# 运行模型(首次运行会自动下载)
ollama run Qwen:3b
# 停止模型运行
ollama stop Qwen:3b
# 删除模型
ollama rm Qwen:3b
提示:Qwen:3b是一个3B参数量的轻量级模型,适合本地运行。如果需要更强能力,可以考虑Qwen:7b或更大模型,但需要更高硬件配置
3.3 内网访问配置
要实现内网多设备访问Ollama服务,需要配置以下设置:
方法一:防火墙配置
- 打开Windows Defender防火墙
- 创建入站规则,允许TCP端口11434的入站连接
方法二:环境变量配置(推荐)
bash复制set OLLAMA_HOST=0.0.0.0
set OLLAMA_ORIGINS=*
或者通过系统属性永久设置:
- 新建系统变量OLLAMA_HOST,值为0.0.0.0
- 新建系统变量OLLAMA_ORIGINS,值为*
4. Claude Code安装与配置
4.1 安装Claude Code
Claude Code是Anthropic推出的AI编程助手命令行工具:
bash复制# 全局安装
npm install -g @anthropic-ai/claude-code
# 验证安装
claude --version
# 重新安装(如有问题)
npm uninstall -g claude-code
npm install -g claude-code
# 更新版本
claude update
4.2 环境变量配置
有两种方式配置Claude Code连接本地Ollama服务:
方法一:配置文件方式
在C:\Users\Administrator\.claude\settings.json中添加:
json复制{
"env": {
"ANTHROPIC_AUTH_TOKEN": "ollama",
"ANTHROPIC_BASE_URL": "http://localhost:11434",
"API_TIMEOUT_MS": "3000000",
"ANTHROPIC_MODEL": "Qwen:3b"
}
}
方法二:系统环境变量方式
添加以下用户变量:
- ANTHROPIC_AUTH_TOKEN = "ollama"
- ANTHROPIC_BASE_URL = "http://localhost:11434"
- ANTHROPIC_MODEL = "Qwen:3b"
注意:两种方式任选其一即可,方法一优先级更高。配置完成后需要重启终端使变更生效
5. 使用与集成
5.1 命令行使用
最简单的启动方式:
bash复制claude
启动后将进入交互模式,可以直接输入问题或指令与AI交互。
5.2 开发工具集成
VSCode集成:
- 在扩展商店搜索"Claude Code"
- 安装官方插件
- 配置插件设置,确保API地址指向本地Ollama服务
IntelliJ IDEA集成:
- 通过插件市场安装Claude Code插件
- 在设置中配置本地API端点
- 重启IDE生效
5.3 内网访问优化
在内网环境中,可以通过以下方式实现多设备共享:
- 在一台性能较好的机器上部署完整环境
- 在其他设备上安装Claude Code客户端
- 配置客户端连接主机的Ollama服务地址(如http://[主机IP]:11434)
6. 常见问题与解决方案
6.1 模型加载失败
现象:ollama run命令报错或长时间无响应
解决方案:
- 检查网络连接,确保能访问模型仓库
- 验证磁盘空间是否充足
- 尝试重新下载模型:
ollama rm Qwen:3b && ollama pull Qwen:3b
6.2 Claude无法连接Ollama
现象:claude命令返回连接错误
排查步骤:
- 确认Ollama服务正在运行:
ollama list - 检查端口监听:
netstat -ano | findstr 11434 - 验证环境变量配置是否正确
- 尝试直接访问API端点:
curl http://localhost:11434/api/tags
6.3 性能优化建议
-
硬件配置:
- 至少16GB内存(推荐32GB)
- 使用SSD存储加速模型加载
- 有NVIDIA GPU可考虑CUDA加速版本
-
模型参数调整:
bash复制
ollama run Qwen:3b --num_ctx 2048 --num_thread 8根据硬件情况调整上下文长度(num_ctx)和线程数(num_thread)
-
内存管理:
- 长时间不使用时停止模型释放内存
- 可编写批处理脚本按需启停
7. 高级配置与扩展
7.1 多模型管理
Ollama支持同时部署多个模型,只需重复pull命令即可:
bash复制ollama pull Qwen:7b
ollama pull CodeLlama:7b
使用时通过环境变量或命令行参数指定模型:
bash复制ANTHROPIC_MODEL=Qwen:7b claude
7.2 自定义模型微调
对于有特殊需求的场景,可以基于现有模型进行微调:
- 准备训练数据(JSON格式)
- 创建Modelfile:
code复制FROM Qwen:3b TRAINING_DATA ./custom_data.json PARAMETER learning_rate 0.0001 - 创建自定义模型:
bash复制
ollama create mymodel -f Modelfile - 使用自定义模型:
bash复制
ollama run mymodel
7.3 安全加固
对于企业内网环境,建议增加以下安全措施:
- 设置访问密码:
bash复制set OLLAMA_ORIGINS=http://yourdomain.com - 启用HTTPS(需配置证书)
- 实现IP白名单限制
在实际部署过程中,我发现模型首次加载时间较长(3B模型约2-5分钟,取决于硬件),建议在正式使用前先完成预热加载。另外,对于团队使用场景,可以考虑将模型服务部署在专用服务器上,其他成员通过内网IP访问,既节省资源又便于统一管理。
