内网没有外网也能汉化:claude-code-zh-cn 离线安装完整指南,无需全局 Node.js 一个压缩包搞定
内网没有外网也能汉化:claude-code-zh-cn 离线安装完整指南,无需全局 Node.js 一个压缩包搞定
claude-code-zh-cn 是 Claude Code CLI 的简体中文本地化插件,覆盖 187 个等待动词、41 条中文提示与 2000 多条界面文案。如果你的服务器只有内网、连不上外网,远程安装脚本就跑不动——本文介绍它的离线安装方法:在联网机器上打好一个压缩包,拷进内网解压运行即可,无需全局安装 Node.js,也不需要管理员权限。
离线安装前先确认:你的服务器属于哪种情况?
| 内网服务器条件 | 离线安装能否完成 |
|---|---|
| 没有预装 Node.js,但允许携入可执行文件 | ✅ 本文方案:便携 Node.js + 本地源码 |
| 禁止运行 Node.js | ❌ 安装器、Hook、诊断与界面补丁都依赖 Node.js |
| 没有外网,但能访问内部模型网关 | ✅ 离线安装后沿用原有网关配置 |
| 完全没有可访问的模型服务 | ✅ 中文插件可安装,但不提供离线模型推理 |
完整的边界说明见官方文档 docs/offline-install.md。
离线包里装什么:一个目录,三样东西
把便携运行环境和插件源码打成同一个压缩包,目录结构如下:
cczh-offline/
node/ # Node.js 24 LTS 解压内容,含 bin/node、bin/npm
source/ # 插件完整源码,含 install.sh 与隐藏的 .claude-plugin 目录
deps/ # node-lief 二进制依赖(原生版界面补丁必需)
- node/:不需要全局安装,安装时把 PATH 指过去就能用;
- source/:必须是完整源码(不能只复制
plugin/),内网安装通过它走官方支持的本地插件市场,全程不访问 GitHub 或 npm; - deps/:node-lief 用于给原生版 Claude Code 打界面补丁。
第一步:在联网机器上打离线包(3 个动作)
- 先确认目标机环境:在目标服务器执行
uname -s、uname -m、claude --version。准备机必须与目标机的系统、CPU 架构、libc 兼容(可用同配置的虚拟机或容器),不要把 macOS 的依赖拷给 Linux ARM64 机器; - 下载两份文件:从 Node.js 官网下载目标平台的 Node.js 24 LTS 二进制压缩包(按官方说明校验 SHA-256),再下载本项目的完整源码压缩包(包含隐藏的
.claude-plugin目录); - 准备依赖并打包:
export PATH="$PWD/cczh-offline/node/bin:$PATH"
npm install --prefix "$PWD/cczh-offline/deps" node-lief@1.3.2
NODE_PATH="$PWD/cczh-offline/deps/node_modules" \
node -e 'require("node-lief"); console.log("node-lief OK")'
tar -czf cczh-offline.tar.gz cczh-offline
sha256sum cczh-offline.tar.gz > cczh-offline.tar.gz.sha256
💡 轻量替代:node-lief 的 npm 包是自包含的(无依赖、预编译二进制已内置)。也可以用 npm pack node-lief@1.3.2 只带一个 node-lief-1.3.2.tgz,放进 source/ 或 source/deps/——内网安装时 install.sh 会自动检测到它并完成离线安装,连 deps/ 目录都不用准备。Windows 的 install.ps1 同样支持。
第二步:在内网服务器一键安装
先关闭所有 Claude Code 会话,把压缩包和校验文件通过合规方式传入内网,然后解压安装:
sha256sum -c cczh-offline.tar.gz.sha256
tar -xzf cczh-offline.tar.gz -C "$HOME"
export PATH="$HOME/cczh-offline/node/bin:$PATH"
export NODE_PATH="$HOME/cczh-offline/deps/node_modules${NODE_PATH:+:$NODE_PATH}"
# 明确使用本地市场目录,无需访问 GitHub 或 npm
ZH_CN_MARKETPLACE_SOURCE="$HOME/cczh-offline/source" \
bash "$HOME/cczh-offline/source/install.sh"
⚠️ 两条 export 要写进你实际使用的 shell 启动配置:Hook 每次会话都要调用 node,本地市场的更新也要源码目录,装完不要删掉便携 Node.js。
第三步:验证安装与后续更新
claude plugin marketplace list --json
claude plugin list --json
bash "$HOME/cczh-offline/source/doctor.sh" --json
确认三件事:插件已启用、市场源指向本地目录、诊断中 layer4Status 为 ok(需要完整界面补丁时必须看它,不能只看总退出码)。随后重启 Claude Code,看到"光合作用中..."即大功告成。
🔄 内网更新方法:上游升级后,先在联网准备机验证同一版本,再把新版本的完整源码换进 source/、重跑本地安装命令即可。不要指望内网自动从 GitHub / npm 拉取更新;各平台已验证的版本窗口见 docs/support-matrix.md。
常见问题(FAQ)
Q:想改等待动词或提示语,怎么办? 直接编辑 verbs/zh-CN.json(动词)或 tips/zh-CN.json(提示),把改动换回内网重跑安装即可。
Q:装了插件后 AI 回复还是英文?
在会话输入框输入 /chinese 一键切中文、/english 切回,毫秒级生效且不消耗 token。
Q:补丁失败会不会搞坏 Claude Code? 不会。补丁、重打包或启动自检任一步失败,都会保留或恢复原文件,最坏情况只是中文覆盖降级为英文,Claude Code 本体永远可用。

