不需要复杂的依赖分析,不用编写下载脚本,只需在有网环境装好、打包、拷贝,三步搞定。
适用场景
- 内网开发环境,无法直接访问互联网
- 已在内网部署了本地大模型(如 Ollama、GPUStack 等)
- Windows x64 操作系统(其他平台同理,替换对应包名即可)
前置条件
| 环境 | 要求 |
|---|---|
| 有网机器 | Node.js 18+、npm 9+ |
| 内网机器 | Node.js 18+、已部署本地大模型服务 |
第一步:在有网机器上安装并打包
新建一个空文件夹,打开 CMD,依次执行以下命令:
bash
mkdir claude-offline
cd claude-offline
npm init -y
npm install @anthropic-ai/claude-code
安装完成后,当前目录下会生成 node_modules 文件夹。Claude Code 及其平台二进制包都在里面。
将整个 node_modules 文件夹打包压缩:
bash
# PowerShell 命令
Compress-Archive -Path .\node_modules -DestinationPath .\node_modules.zip
第二步:拷贝到内网机器并解压
将 node_modules.zip 拷贝到内网目标机器上,解压到某个目录,例如:
cmd
D:\claude-offline\node_modules
解压后确认关键文件存在:
node_modules\@anthropic-ai\claude-code\------ 主包node_modules\@anthropic-ai\claude-code-win32-x64\------ Windows 可执行文件
第三步:配置环境变量
需要让系统能找到 Claude Code 的可执行文件。
3.1 将 claude 命令添加到 PATH
找到 claude.exe 文件所在路径:
cmd
D:\claude-offline\node_modules@anthropic-ai\claude-code-win32-x64
将此路径添加到系统环境变量 Path 中:
- 打开"系统属性" → "高级" → "环境变量"
- 在"系统变量"中找到
Path,点击编辑 - 新建一条,填入上述完整路径
- 确定保存
3.2 验证可执行文件
打开一个新的 CMD 窗口,执行:
bash
claude --version
如果输出版本号,说明 PATH 配置成功。
第四步:配置本地大模型
在用户目录下创建或编辑 .claude 文件夹中的配置文件。
4.1 创建 ~/.claude/settings.json
文件路径为 C:\Users\你的用户名\.claude\settings.json,内容如下:
json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的API Key或占位符",
"ANTHROPIC_BASE_URL": "http://你的本地模型地址:端口/v1",
"ANTHROPIC_MODEL": "你部署的模型名称",
"ANTHROPIC_SMALL_FAST_MODEL": "你部署的模型名称",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
}
配置说明:
| 字段 | 说明 |
|---|---|
ANTHROPIC_AUTH_TOKEN |
GPUStack 填完整 API Key;Ollama 等无认证服务随意填写即可 |
ANTHROPIC_BASE_URL |
本地模型 API 地址,Ollama 默认 http://localhost:11434/v1 |
ANTHROPIC_MODEL |
必须与本地部署的模型名称完全一致(大小写也要一样) |
CLAUDE_CODE_ATTRIBUTION_HEADER |
必须设为 "0",否则本地模型推理速度会大幅下降 |
4.2 创建 ~/.claude.json
文件路径为 C:\Users\你的用户名\.claude.json,用于跳过首次登录检查:
json
{
"hasCompletedOnboarding": true
}
第五步:启动使用
打开 CMD,切换到你的项目目录,直接运行:
bash
claude
或者指定模型启动:
bash
claude --model 你的模型名称
启动后可以用 /status 命令查看当前连接的模型。
常见问题
Q: 启动报错 "Unable to connect to Anthropic services"
A: 检查 ANTHROPIC_BASE_URL 是否正确,确认本地模型服务正在运行。
Q: 提示模型不存在
A: 用 GPUStack 的 API 查询准确模型名:
bash
curl http://你的地址:端口/v1-openai/models -H "Authorization: Bearer 你的API Key"
复制返回结果中 id 字段的值,填入 ANTHROPIC_MODEL。
Q: 模型回复很慢
A: 确认 settings.json 中已设置 CLAUDE_CODE_ATTRIBUTION_HEADER 为 "0"。
总结
整个流程的核心就是三句话:有网装好 → 打包拷贝 → 配置变量 。不需要 npm ls 分析依赖,不需要写下载脚本,node_modules 文件夹本身就包含了 Claude Code 运行所需的全部文件。