AI 编程工具内网离线部署方案

📅 2026/7/5 4:03:15
AI 编程工具内网离线部署方案
为什么需要这个在国内的金融、军工、政府、运营商等场景中内网开发是常态。机器物理隔离没有 GitHub 访问没有 npm registry甚至没有互联网连接。但 AI 编程工具——Claude Code、Codex CLI、Codex Desktop——默认都依赖联网安装npm install、GitHub Releases 下载、微软商店在线分发。这让内网用户望而却步。有没有一套方案能先在一台联网机上下载好所有材料拷进内网一条命令装好有。我把三个工具的内网部署脚本打包成了一个仓库。仓库地址github.com/Nemocccc/cc_codex-offline-installation整体思路所有三个工具遵循同一套四步走流程零学习成本联网机下载— 在一台能访问 GitHub / npm / Node.js 官网的机器上运行pack-online.bat自动下载所有依赖拷贝到内网— USB 或内部共享把整个目录拷进去内网安装— 右键setup.bat→ 以管理员身份运行一键装好配置内网 API— 设置环境变量指向内网 LLM 网关即刻使用一、Claude Code CLI离线部署全流程第 1 步 — 联网机下载cd cc-offline scripts\pack-online.bat这个脚本会从 GitHub、nodejs.org 等源头下载以下材料到本地目录下载项本地位置大小nvm-windowsnvm\16 MBNode.js 26.4.0 npmnode\115 MBclaude.exe 原生二进制claude-code-offline\225 MB总计~355 MB下载完成后整个cc-offline\目录就是可移植的离线包。第 2 步 — 拷贝到内网将cc-offline\目录完整复制到内网机器的任意位置比如D:\tools\cc-offline\。第 3 步 — 内网安装# 右键 → 以管理员身份运行 setup.batsetup.bat 会帮你做这些事安装 nvm-windows 到%USERPROFILE%\.nvm\用 nvm 安装 Node.js 26.4.0 npm 到%USERPROFILE%\.nvm\nodejs\将 claude.exe 放到%USERPROFILE%\claude-code\bin\claude.exe注册命令行入口到%USERPROFILE%\.nvm\claude.cmd修改 PATH 环境变量追加 nvm 目录设置ANTHROPIC_BASE_URL环境变量安装完成后关掉当前终端重新打开一个新终端。第 4 步 — 配置内网 API有两种方式方式 Asettings.json 预配置将 repo 根目录下的settings.json复制到内网机器的%USERPROFILE%\.claude\下{ hasCompletedOnboarding: true, ... }这个方式适合统一管理团队配置比如预设 model picker、禁用 telemetry 等。方式 Bcc-switch 代理用 cc-switch 配置代理指向内网 LLM 网关设置环境变量set ANTHROPIC_BASE_URLhttps://your-internal-gateway/api⚠️重要提醒方式 A 中的hasCompletedOnboarding: true和方式 B 的跳过首次登录是互斥的两者不能同时设置。验证安装claude二、Codex CLI离线部署全流程第 1 步 — 联网机下载cd codex-offline scripts\pack-online.bat相比 Claude CodeCodex CLI 的离线包更大因为包含了 Rust 编译的原生二进制约 308 MB。第 2 步 — 拷贝到内网将整个codex-offline\目录复制到内网机器。第 3 步 — 内网安装# 右键 → 以管理员身份运行 setup.bat安装内容组件安装到nvm-windows%USERPROFILE%\.nvm\Node.js npm%USERPROFILE%\.nvm\nodejs\codex.js native binary%USERPROFILE%\codex\命令行入口%USERPROFILE%\.nvm\codex.cmd环境变量PATH OPENAI_BASE_URL验证安装codex三、Codex Desktop离线部署全流程第 1 步 — 联网机下载cd codex-desktop-offline scripts\pack-online.bat下载项本地位置大小微软商店安装器 stubpkg\CodexDesktopInstaller.exe1.3 MB注意这里只下载了 stub 安装器1.3 MB。如果你的内网机器能够访问微软 CDN比如有白名单代理那直接用这个安装器即可。如果是完全断网的环境需要额外一步。第 2 步 — 拷贝到内网第 3 步 — 获取纯离线 MSIX完全断网环境如果内网完全断网连微软 CDN 也访问不了需要提前从一台已安装 Codex Desktop 的机器上提取完整安装包。在这台有网机器上已经装好 Codex Desktop以管理员身份运行scripts\extract-msix.bat这个脚本会自动扫描C:\Program Files\WindowsApps\目录找到 OpenAI.CodexDesktop 的安装文件夹完整复制到pkg\AppxPackage\目录将pkg\AppxPackage\拷回内网机器即可。第 4 步 — 内网安装# 右键 → 以管理员身份运行 setup.batsetup.bat 会按以下优先级尝试安装优先级安装方式条件①Add-AppxPackage -Register已有pkg\AppxPackage\目录②Add-AppxPackage -Path已有pkg\*.msix文件③Add-AppxProvisionedPackage已有pkg\AppxPackage\目录④DISM 命令安装已有pkg\AppxPackage\目录⑤运行安装器 stub需要能访问微软 CDN也就是说你只要准备了上述任意一种材料setup.bat 都能自动识别并使用最佳方式安装。仓库目录结构全貌pack/ ├── cc-offline/ Claude Code CLI 离线包 │ ├── settings.ini 版本号与 API 配置 │ ├── settings.json Claude Code 预配置放入 ~/.claude/ │ ├── setup.bat 内网安装脚本管理员运行 │ └── scripts/ │ ├── pack-online.bat 联网机下载脚本 │ └── verify.bat 安装后验证脚本 │ ├── codex-offline/ Codex CLI 离线包 │ ├── settings.ini │ ├── settings.json │ ├── setup.bat │ └── scripts/ │ ├── pack-online.bat │ └── verify.bat │ └── codex-desktop-offline/ Codex Desktop 离线包 ├── settings.ini ├── setup.bat └── scripts/ ├── pack-online.bat ├── extract-msix.bat 从已装机提取离线 MSIX 包 └── verify.bat常见问题Qsetup.bat 提示需要管理员权限A右键setup.bat→ 选择以管理员身份运行。安装 Node.js 和写系统 PATH 都需要管理员权限。Qpack-online.bat 下载失败A检查联网机的网络连接。需要能访问 GitHub Releases、nodejs.org、npmjs.org。如果公司网络有代理需要先配置好代理环境变量。Q安装后命令行找不到 claude / codexA关掉当前终端打开一个新终端。因为 setup.bat 修改的是系统 PATH 环境变量已经打开的终端不会感知到变化。重启 Windows 也可以解决。