uclaude —— Claude Code 便携版启动器

把 Claude Code 整装进 U 盘，插到任何一台 Windows 电脑即可使用：无需安装 Node.js、无需管理员权限、不改系统环境变量。

API 凭据以 AES-256-GCM 加密落盘，启动时需通过密码门禁（scrypt 哈希），U 盘丢失也不至于泄露凭据。

本仓库只包含启动器源码（不到 20KB）。Claude Code 本体、便携 Node 运行时、会话历史均不入库——运行一次 install.bat 即可自动重建完整便携版。

---

首次部署

三步依次必做，缺任何一步都用不起来：

顺序	操作	作用	跳过会怎样
①	双击 install.bat	建 portable-node\、claude-code\、.claude\ 三个目录（约 350MB 下载）	没有运行时与本体，根本跑不起来
②	运行 config.bat	填 API 地址 / Token，并把默认密码 123456 改掉	启动后没有凭据，无法对话
③	双击 install-uclaude.cmd	给本机装 uclaude 命令	只能直接运行 claude.bat，且工作区会变成便携版自身

之后在任意项目文件夹打开终端，输入 uclaude 即可使用。

前置条件：构建机已装 Node.js，且能访问 registry.npmmirror.com。 注意区分——使用便携版不需要 Node.js，构建它需要。

---

目录结构

claude\
  claude.bat            ★ 启动入口（需输入访问密码）
  config.bat            ★ 配置工具：改 API / 改密码 / 查看配置
  install.bat           构建脚本：下载 Node + Claude Code，初始化便携环境
  install-uclaude.cmd   ★ 换电脑时双击一次，给本机装 uclaude 命令
  install-uclaude.ps1   上面脚本的真身（被 cmd 调用）
  core\
    _guard.js           密码校验 / 凭据加解密引擎
    .hash               ← 访问密码哈希（scrypt，不入库）
    .cred               ← 加密的 API 凭据（不入库）
  claude-code\          ← Claude Code 本体（install.bat 生成，不入库）
  portable-node\        ← 便携 Node（install.bat 生成，不入库）
  .claude\              ← 会话历史与配置（不入库）

使用步骤

第 1~3 步即上面「首次部署」的 ①②③，顺序不可跳；第 4 步起是日常用法。

1. 构建便携环境（需一台有 Node.js 的联网电脑，仅首次）

git clone https://github.com/mzy-embedded/uclaude.git X:\claude
cd /d X:\claude
install.bat

目录位置不限。X:\claude 是 U 盘场景的推荐做法；放 D:\tools\claude、桌面等任意路径也能用（见第 3 步的定位机制）。

脚本会自动下载便携 Node v24.15.0 与 @anthropic-ai/claude-code，完成后默认密码为 123456，并已预置引导完成标志——首次启动不会出现欢迎页/选主题的交互引导，直接进入会话界面。

install.bat 内部做了什么

首次构建需要生成 claude-code\、portable-node\、.claude\ 三个目录，全部由这个脚本自动完成，无需手动创建任何一个：

步	动作	产出
[1/4]	从 npmmirror 下载 Node v24.15.0 解压	portable-node\（约 103MB）
[2/4]	npm install --ignore-scripts @anthropic-ai/claude-code	claude-code\（约 242MB）
[3/4]	准备 .claude\ 配置，见下	.claude\
[4/4]	重置安全核心：删除已有凭据，密码置为 123456	core\.hash

前置条件：本机已装 Node.js（脚本第一件事就是 where npm）、能访问 registry.npmmirror.com。

[3/4] 内部有三个分支，按顺序执行：

1. .claude\settings.json 不存在 且 本机有 %USERPROFILE%\.claude → 把本机配置拷进来（对方没装过 Claude Code 就跳过）
2. .claude\ 仍不存在 → mkdir 补上
3. .claude\.claude.json 不存在 → 跑一次 claude.exe doctor 让它自举生成配置文件，再用便携 node 补上 hasCompletedOnboarding 标志

⚠️ 不要在已经配置好的盘上重跑 install.bat。 [2/4] 没有"已存在则跳过"的守卫，每次都会重新下载 Claude Code；[4/4] 会把访问密码重置回 123456 并清空 API 配置——重跑等于把配置清零。要只重建某个目录，请手动处理，别用这个脚本。

2. 配置 API 与密码

config.bat

菜单：1 改 API 配置 · 2 改访问密码 · 3 查看当前配置（Token 打码）。 首次运行会引导创建访问密码。

3. 给当前电脑装 uclaude 命令

双击 install-uclaude.cmd，看到 uclaude installed 即可。它会向 PowerShell 配置文件写入一个函数，定位 claude.bat 的顺序是：

1. 先找当前这一份（运行 install-uclaude.cmd 时所在目录）——所以放桌面、D:\tools\claude 等任意位置都能用
2. 找不到时回退到扫描盘符（X:\claude\claude.bat）——盘符从 F: 变 E: 也无需改动

注意：uclaude 指向你最后一次运行 install-uclaude.cmd 的那一份。若同时存在 U 盘和本地两份，想切换就重新运行目标那份的 install-uclaude.cmd。

4. 日常使用

在任意项目文件夹打开终端：

uclaude                 # 启动，工作区 = 当前文件夹
uclaude --continue      # 接续上次会话
uclaude -p "你的问题"    # 一次性提问

注意：工作区 = 打开终端时所在的目录。不要双击 claude.bat 启动，否则工作区会变成 U 盘自身。

跨电脑续会话

会话历史随 U 盘走（.claude\projects\）。换电脑后，在相同路径的项目目录里 uclaude --resume 即可接续。

安全说明

• 凭据加密存储于 core\.cred，无密码无法解密；密码哈希为 scrypt，抗暴力破解
• 密码校验全程在内存中完成，不写任何文件；明文 Token 不落盘
• 忘记密码：删除 core\.hash 与 core\.cred，重新运行 config.bat 配置
• 建议使用 8 位以上混合字符密码，并与 U 盘分开保管
• 已知限制：启动入口（claude.bat / uclaude）的密码输入为明文显示，防肩窥有限；修改密码、API 等敏感操作请在 config.bat 中进行（星号回显）

说明

Claude Code 是 Anthropic 的专有软件，本仓库不包含其任何二进制文件或源码，仅提供自动化安装与加密启动的封装脚本。使用时请遵守 Anthropic 服务条款。