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

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

适用场景

  • 内网开发环境,无法直接访问互联网
  • 已在内网部署了本地大模型(如 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 中:

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

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

相关推荐
大力财经1 小时前
智能体时代如何衡量“DAA“?百度新全栈AI云给出答案
人工智能·百度·dubbo
浔川python社1 小时前
浔川社团联合会关于 2026 年度重点项目入选公告
人工智能·浔川代码编辑器v4.1.0
夜影风1 小时前
LangGraph实战:搭建一个带人工介入的智能客服系统
人工智能·langchain·langgraph
测试员周周1 小时前
【Appium 系列】第04节-Page Object 模式 — BasePage 基类设计
开发语言·数据库·人工智能·python·语言模型·appium·web app
学习论之费曼学习法1 小时前
AI 入门 30 天挑战 - Day 29 - 面试准备指南
人工智能·面试·职场和发展
爱学习的徐徐1 小时前
监督学习核心算法:单变量线性回归
人工智能·机器学习
JavaGuide1 小时前
万字详解 Harness Engineering:六层架构、上下文管理与一线团队实战
人工智能·ai编程
java1234_小锋1 小时前
Spring AI 2.0 开发Java Agent智能体 - 工具调用(Function Calling / Tools)
java·人工智能·spring
nix.gnehc1 小时前
AI Agent 设计范式的演进之路:从工具调用到多智能体协作
人工智能·agent