Claude Code离线安装方案揭秘-北京尧图网络

在企业内网或完全无外网的环境下部署Claude Code其核心思路可以高度概括为在有网的环境中完成“准备”再将整个“运行时”搬运到内网。这通常有两种主流路径一是基于Node.js/npm的依赖打包方案二是利用社区提供的原生二进制或便携版方案。方案一基于 npm 的离线依赖打包 (通用性最强)这种方法的核心是node_modules文件夹本身就包含了所有运行所需文件。它的优势在于能完整保留官方npm包的所有依赖关系适配性最广。第一步在有网机器上准备环境1. 环境要求有网机器需安装 Node.js (v18) 和 npm操作系统应与目标内网机器保持一致如均为Windows x64因为npm install会自动下载适配当前平台的二进制文件。2. 新建项目并安装 Claude Code找一个空目录通过命令行执行以下操作即可将 Claude Code 及其所有依赖下载到本地bash# 1. 初始化一个空项目 mkdir claude-offline cd claude-offline npm init -y # 2. 安装 Claude Code npm install anthropic-ai/claude-code执行后node_modules文件夹便包含了 Claude Code 主程序及其依赖的所有包。3. (可选) 生成依赖清单用于审计如果需要清晰的依赖列表可以使用此命令导出为JSON文件方便查阅或编写下载脚本bashnpm ls --all --json deps-full.json4. 打包整个node_modules文件夹将整个文件夹压缩成一个文件方便传输Windows (PowerShell):Compress-Archive -Path .\node_modules -DestinationPath .\node_modules.zipLinux/macOS:zip -r node_modules.zip node_modules第二步在内网机器上部署1. 解压并放置文件将node_modules.zip拷贝到内网机器并解压例如解压到D:\claude-offline\node_modules。2. 配置环境变量 (至关重要)系统需要知道claude命令在哪里。将 Claude Code 的可执行文件所在路径添加到系统的PATH环境变量中。Windows: 可执行文件通常位于node_modules\anthropic-ai\claude-code-win32-x64将此路径添加到系统Path变量。Linux/macOS: 可执行文件通常是一个软链接位于node_modules/.bin/claude可以将其链接到系统已有路径如sudo ln -s $(pwd)/node_modules/.bin/claude /usr/local/bin/claude。配置完成后在新打开的终端中执行claude --version验证是否成功。第三步配置本地模型服务由于无法连接Anthropic官方API需要让Claude Code指向一个本地或内网部署的、兼容OpenAI API格式的模型服务例如 Ollama、LM Studio、GPUStack 等。在用户目录下创建配置文件~/.claude/settings.json(Windows路径为C:\Users\你的用户名\.claude\settings.json)内容如下json{ env: { ANTHROPIC_AUTH_TOKEN: 任意占位符, ANTHROPIC_BASE_URL: http://你的内网模型服务地址:端口/v1, ANTHROPIC_MODEL: 你部署的模型名称, CLAUDE_CODE_ATTRIBUTION_HEADER: 0 } }ANTHROPIC_BASE_URL最关键必须指向本地模型服务的API端点。ANTHROPIC_MODEL模型名称必须与服务商提供的完全一致可通过curl http://地址:端口/v1/models查询。CLAUDE_CODE_ATTRIBUTION_HEADER务必设为0否则本地模型推理速度会严重下降。为了跳过首次启动时的联网检查还需要创建~/.claude.json文件 (Windows路径C:\Users\你的用户名\.claude.json) 并填入json{ hasCompletedOnboarding: true }完成以上步骤后即可在内网终端中运行claude命令开始使用本地模型进行AI编程辅助。方案二直接使用编译好的二进制文件 (更简洁)社区提供了多种“开箱即用”的Claude Code版本它们将运行环境与代码打包在一起省去了Node.js环境配置的麻烦。原生二进制版 (ClaudeCage): 基于Bun运行时和Bubblewrap沙箱技术被打包成一个单文件可执行程序无任何外部依赖性能优越并自带文件系统访问隔离提升安全性。便携版 (ClaudeCodePortable): 专为Windows设计将Node.js、Git等依赖全部打包解压即用甚至支持集成到右键菜单非常方便。专用下载工具 (cc-download): 一个脚本工具支持带代理下载Claude Code的官方原生二进制包适用于Windows/Linux/macOS并提供离线安装包选项下载后可直接上传至内网服务器运行。⚠️ 注意事项平台一致性方案一尤其要注意有网机器和最终部署机器的操作系统及架构如x64/arm64必须一致否则拷贝过去的二进制文件无法运行。命令行环境在Windows上操作时建议使用PowerShell而非CMD因为CMD不支持*.tgz之类的通配符展开。模型服务性能本地模型的推理能力受硬件尤其是GPU显存限制。7B参数的模型是体验与性能的较好平衡点但推理深度和上下文长度与云端大模型仍有差距。

Claude Code离线安装方案揭秘

相关推荐

终极指南：用XUnity.AutoTranslator轻松实现Unity游戏本地化

计算机毕业设计之基于SSM的众筹管理系统的设计与实现

消防设施操作员理论高效备考方案，优题宝刷题工具功能详解

更多资讯

OpenClip 扩展商店使用教程：一键安装、自动更新与管理社区扩展

Bang Motion 视频图层技术详解：像 After Effects 一样把 MP4 嵌入 HTML 动画并锁定时间线的完整指南

4 步跑通 PyScript 配置与部署：从 make setup 到静态托管的实战清单

智慧地铁大屏 · 19 个组件完整操作手册

MySQL-数据库服务日志管理与数据闪回

供应链管理软件选型指南：WMS/OMS/TMS/BMS怎么选？（含主流厂商对比）

今日更新

猫狗目标检测数据集：VOC/COCO/YOLO三格式一体化实战包

HDU2017多校标程复现：算法竞赛工程化真题沙盒

Codex Sandbox 隔离环境拆解：AI Agent 的临时实验室如何运作

本周精选

防幻觉智能体架构：电源硬件设计中的大模型编排与工具化实践

OpenGL面试核心考点：渲染管线、矩阵变换与性能排查全解析

全国计算机二级C语言真题PDF高效刷题指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？