讲师中心 微信公众号
AI工具推荐 视频效率加速

ClaudeFable5.1 离线包部署需要提前下载哪些依赖文件

落宇小哥_7485

落宇小哥_7485

发布时间:2026-09-28 15:56:26

|

496人浏览过

|

来源于php中文网

原创

需在与内网完全一致的OS、CPU架构和Node版本的联网机上,下载Node二进制包、完整package-lock.json依赖树、npm缓存、Python 3.11及推理wheel包,并同步配置环境变量与config.json。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

claudefable5.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'。

Integrate Claude Agent SDK with You.com MCP server
Integrate Claude Agent SDK with You.com MCP server

将 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''
真正卡住人的往往不是“下哪些包”,而是“在哪下、用什么版本下、下了怎么验证”。内网部署的本质是版本对齐 + 路径可控 + 权限显式,任何环节模糊都会导致报错信息和真实原因完全不匹配。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

相关专题

更多
Claude 新手入门教程
Claude 新手入门教程

本专题围绕 Claude 的基础使用与实际应用展开,面向零基础用户与初学者,系统梳理从“认识工具”到“高效使用”的完整路径。

2511

2026.03.27

Claude 提示词使用指南
Claude 提示词使用指南

本专题聚焦 Claude 的提示词(Prompt)设计与优化方法,围绕“如何让 AI 更准确理解需求并输出高质量结果”这一核心问题展开。内容从基础结构入手,逐步深入到复杂场景下的提示词构建策略,帮助用户建立清晰、可复用的提示词体系。

394

2026.03.27

Claude 进阶使用指南
Claude 进阶使用指南

本专题面向已经具备基础使用经验的用户,深入解析 Claude 在复杂场景中的高阶应用方式,重点解决“如何让 AI 真正参与到实际工作流程中”的问题。让 Claude 成为日常工作中可持续复用的效率引擎,在内容创作、开发实践与信息处理等多个领域实现显著提效。

359

2026.03.27

AI Agent 实战指南:从评测到落地
AI Agent 实战指南:从评测到落地

全面评测 Manus AI 与 ChatGPT、Claude、OpenAI Operator 等 AI Agent 产品,分析自动化能力、工作流与实际生产力差异。

333

2026.05.29

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

160

2026.09.23

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

80

2026.09.23

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

80

2026.09.23

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

40

2026.09.22

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

60

2026.09.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Claude Code 快速上手核心指南
Claude Code 快速上手核心指南

共0课时 | 0人学习

Claude Code 官方文档
Claude Code 官方文档

共0课时 | 0人学习

Claude Code 官方中文文档
Claude Code 官方中文文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn