需在与内网完全一致的OS、CPU架构和Node版本的联网机上,下载Node二进制包、完整package-lock.json依赖树、npm缓存、Python 3.11及推理wheel包,并同步配置环境变量与config.json。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

需要提前下载的 Node.js 运行时与 npm 包清单
离线部署 Claude Code(当前实际可用版本基于 Claude Fable 5.1 的 CLI 工具链)不是只下几个 .tgz 就完事。核心矛盾在于:它依赖的包里混着跨平台二进制(比如 @img/sharp-win32-x64、esbuild),这些不能靠 npm pack 或简单复制 node_modules 安全搬运。
必须在与目标内网机器**完全一致的 OS + CPU 架构 + Node 版本**的联网机上操作,否则搬进去就报 Cannot find module './binding.node' 或 spawn ENOENT。
-
Node.js二进制安装包(非源码):例如node-v20.18.0-win-x64.zip(Windows)、node-v20.18.0-linux-x64.tar.xz(Linux)。注意不是node-v20.18.0.tar.gz—— 那是源码,内网没编译环境 - 完整
package-lock.json锁定的依赖树:执行npm install后生成,不能省略 - 所有
resolved字段指向的.tgz文件:从package-lock.json解析出 URL,用wget或curl下载。常见坑是某些包(如sharp)的resolved指向 CDN,需替换为内网制品库地址再重跑npm install -
npm自身的离线镜像缓存(可选但推荐):运行npm config get cache查路径,打包整个缓存目录,避免内网首次npm install时反复失败重试
Python 依赖和推理层二进制不能漏
Claude Code 在本地做轻量推理或文档解析时,会调用 Python 子进程(尤其启用 --local 或 --offline-rag 模式时)。这部分不装,命令能启动,但一触发分析就卡住或报 python: command not found 或 ModuleNotFoundError: No module named 'transformers'。
将 Claude Agent SDK 与 You.com HTTP MCP 服务器集成,支持 Python 和 TypeScript。当开发者提及 Claude Agent SDK、Anthropic Agent SDK 或将 Claude 与 MCP 工具集成时使用。
- 匹配的
Python解释器:建议Python 3.11(Claude Fable 5.1工具链测试最稳),带pip,打包成python-3.11.9-embed-amd64.zip(Windows)或Python-3.11.9.tgz(Linux) -
requirements.txt及其全部离线 wheel:用pip download -d ./wheels -r requirements.txt --no-deps,再补下载依赖项(pip download -d ./wheels -r ./wheels/*.dist-info/METADATA不现实,直接pip download -d ./wheels -r requirements.txt更可靠) - 关键推理库的预编译 wheel:特别是
torch(CPU 版)、transformers、tokenizers、onnxruntime。注意区分manylinux_2_17和manylinux_2_28,内网机器 GLIBC 版本低会导致ImportError: GLIBC_2.28 not found
环境变量和配置文件要同步写死
离线环境下没有 ~/.anthropic/credentials 自动创建机制,也没有 API Endpoint 自动 fallback。所有外部依赖必须显式指向内网地址,否则启动就报 fetch failed 或 ENOTFOUND api.anthropic.com。
-
ANTHROPIC_API_KEY:必须设,哪怕只是占位符(内网走网关时可能校验格式) -
ANTHROPIC_BASE_URL:强制设为内网 AI 网关地址,例如https://claude-gateway.internal/api,不能留空或默认值 -
NODE_OPTIONS:若内网 DNS 不通,加--dns-result-order=ipv4first防止getaddrinfo ENOTFOUND - 配置文件
~/.claude/config.json:提前建好,写入"base_url"、"model"("claude-fable-5-1")、"max_tokens"等字段,避免首次运行交互式提问
最容易被忽略的点:PowerShell 执行策略和文件权限
Windows 内网机器常禁用脚本执行,Linux 内网机器常锁死 /usr/local/bin 权限。这时候你把包拷进去,npm install -g 会静默失败,或者 claude-code 命令根本找不到。
- Windows:提前在内网机运行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser,否则npm脚本(如postinstall)直接被拦截 - Linux:
npm install -g默认写/usr/local/lib/node_modules,普通用户无权写。要么用npm config set prefix ~/.local改全局路径,要么用sudo(不推荐),要么改用npx方式局部运行 - 所有
.sh和.ps1脚本要检查是否带 BOM 或 DOS 换行符,内网 Linux 机器bash读到^M会报syntax error near unexpected token `$'do\r''

















