Claude Code 内网离线极简部署指南

不需要复杂的依赖分析，不用编写下载脚本，只需在有网环境装好、打包、拷贝，三步搞定。

适用场景

• 内网开发环境，无法直接访问互联网
• 已在内网部署了本地大模型（如 Ollama、GPUStack 等）
• Windows x64 操作系统（其他平台同理，替换对应包名即可）

前置条件

环境	要求
有网机器	Node.js 18+、npm 9+
内网机器	Node.js 18+、已部署本地大模型服务

第一步：在有网机器上安装并打包

新建一个空文件夹，打开 CMD，依次执行以下命令：

mkdir claude-offline
cd claude-offline
npm init -y
npm install @anthropic-ai/claude-code

安装完成后，当前目录下会生成 node_modules 文件夹。Claude Code 及其平台二进制包都在里面。

将整个 node_modules 文件夹打包压缩：

# PowerShell 命令
Compress-Archive -Path .\node_modules -DestinationPath .\node_modules.zip

第二步：拷贝到内网机器并解压

将 node_modules.zip 拷贝到内网目标机器上，解压到某个目录，例如：

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 文件所在路径：

D:\claude-offline\node_modules@anthropic-ai\claude-code-win32-x64

将此路径添加到系统环境变量 Path 中：

1. 打开"系统属性" → "高级" → "环境变量"
2. 在"系统变量"中找到 Path，点击编辑
3. 新建一条，填入上述完整路径
4. 确定保存

3.2 验证可执行文件

打开一个新的 CMD 窗口，执行：

claude --version

如果输出版本号，说明 PATH 配置成功。

第四步：配置本地大模型

在用户目录下创建或编辑 .claude 文件夹中的配置文件。

4.1 创建 ~/.claude/settings.json

文件路径为 C:\Users\你的用户名\.claude\settings.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，用于跳过首次登录检查：

{
  "hasCompletedOnboarding": true
}

第五步：启动使用

打开 CMD，切换到你的项目目录，直接运行：

claude

或者指定模型启动：

claude --model 你的模型名称

启动后可以用 /status 命令查看当前连接的模型。

常见问题

Q: 启动报错 "Unable to connect to Anthropic services"

A: 检查 ANTHROPIC_BASE_URL 是否正确，确认本地模型服务正在运行。

Q: 提示模型不存在

A: 用 GPUStack 的 API 查询准确模型名：

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 运行所需的全部文件。