Windows 从 0 开始

给从没装过 KernelHub 的 Windows 电脑。照着做，每一步都能复制、都知道成功长什么样：先装 Node，再一行装 KernelHub，登录 Runtime，配对手机，发一条真任务，看它交付。

1 · 开始之前：这台电脑缺什么

一台从没装过 KernelHub 的 Windows 10 / 11，要走到「手机上派活、这台电脑上干活」。先搞清楚它自带什么、缺什么：

怎么打开 PowerShell

按键盘上的 Win + R，输入 powershell，回车。弹出蓝色（或黑色）窗口就对了。本页只有两处要「以管理员身份运行」，到了会单独说。

2 · 能上网：最短主路径（推荐，共 13 步）

一步一行，复制即用。遇到被堵、没网，跳到对应小节。

第 1 步 · 看看这台电脑有没有 Node

成功长这样：打出两行版本号（比如 v24.21.0 和一串 npm 版本）—— 说明已经装过 Node，直接跳到第 4 步。

全新电脑上会看到：一段红字，里面有「无法将“node”项识别为 cmdlet」（英文系统是 “is not recognized as the name of a cmdlet”）—— 说明没装，做第 2 步。

第 2 步 · 装 Node.js（它自带 npm）

两条路选一条。当前 LTS 版本是 Node v24.21.0（取自 nodejs.org 官方版本清单）。

路 A：一条命令（需要 winget，Windows 11 和较新的 Windows 10 都有）

中途可能弹「是否允许此应用对你的设备进行更改」，点是。winget 源里的版本号可能比 nodejs.org 慢几个小版本，不影响使用。

路 B：不依赖 winget —— 指定版本，下载后先核官方 SHA-256，对不上就停

核对通过才会弹出 Node 安装向导，一路「下一步」即可（同样可能弹管理员确认，点是）。想静默安装，把结尾的 msiexec /i $f 换成 msiexec /i $f /qn。

那串 bb0eaee1… 是 nodejs.org 官方 SHASUMS256.txt 里 node-v24.21.0-x64.msi 那一行的值，本站写页面时逐字核过。看到红字 “SHA-256 不一致，已中止，未安装”：说明下载坏了或被换了，重跑一次；还不行就换路 A 或走第 5 节的代理。

第 3 步 · 关掉 PowerShell，重新打开一个

Node 装完之后，老窗口不认识新装的 node。关掉，按第 1 节的办法重开一个，再跑一次：

成功：两行版本号。还是红字：注销或重启一次电脑再试。

第 4 步 · 一行装 KernelHub

它按顺序做这些事，你不用管，看着就行：

成功时屏幕上会出现这几行（install.ps1 源码里写死的原句，不是 Windows 真机实录；v 开头是绿色）：

v SHA-256 verified
v Installed to C:\Users\<you>\AppData\Local\Programs\icloser\icloser.exe
v Aliases: icli (short name), kernelhub-cli / devnexus-cli (legacy, still work)
v Added C:\Users\<you>\AppData\Local\Programs\icloser to your user PATH
v Typing icloser / icli gets you this install (checked against a new terminal's PATH and PATHEXT)
v icloser 1.0.2 (build 202609161352, commit a4099c062543)
Installing runtime claude (npm install -g @anthropic-ai/claude-code) ...
v Installed runtime: claude (@anthropic-ai/claude-code)

如果看到下面这两行，说明第 2 步没做或没生效 —— KernelHub 本体已经装好，只是没装上 Runtime。回到第 2、3 步装好 Node，再把这一步的命令跑一遍（install.ps1 源码里的原句，不是 Windows 真机实录）：

  ! No npm on this machine, so no runtime was installed (KernelHub itself is installed)
     Install Node.js (it ships npm), then run this installer again.

第 5 步 · 核一下装到的是哪一版

成功：一行里同时有 1.0.2 和 202609161352（这一行的样子在 Windows 真机上核过）：

icloser 1.0.2 (build 202609161352, commit a4099c062543)

报「无法将“icloser”项识别为 cmdlet」：关掉窗口重开一个再试；还不行，把第 4 步再跑一遍。

第 6 步 · 让 Runtime 登录一次

第一次运行会带你登录（通常会打开浏览器）。按屏幕提示登录完，看到能对话的界面后，输入 /exit 或按 Ctrl + C 两次退出。

然后看看这台电脑认出了哪几家、登没登录：

成功：Claude Code 那一行不再是「未安装」，状态里没有 NOT_INSTALLED。还卡在登录态上时，状态会写成 STARTABLE_NOT_AUTHED 或「状态不明」（STARTABLE_AUTH_UNKNOWN）—— 回去再登录一次。

第 7 步 · 进到你的项目目录

把下面的 D:\你的项目 改成你真实的项目文件夹（放你要让 AI 员工改的代码的地方）：

别在「下载」文件夹、解压安装包的文件夹里做这一步：那个文件夹会整个变成 AI 员工的工作区。KernelHub 会拒绝看起来像安装包解压目录的地方。

第 8 步 · 配对手机

它会依次做三件事：

1. 在当前目录建工作区。
2. 问你「这台机器上，Agent 可以自己做到哪一步？」—— 直接回车就是第 3 档「读 + 写 + 执行」，能改文件、能跑构建和测试，多数人选它。
3. 在窗口里画一个二维码，下面还有一条「扫不了就手工粘这条」的链接。

打开手机上的 KernelHub App 扫这个码。最后它会说「下一步只有一件事——让手机说的话有人接：icloser run」。

也可以用图形界面：打开 KernelHub Desktop，点「连接手机」，用手机扫码。两种都行。

第 9 步 · 在手机 App 里输入邀请码

全新账户第一次 pair 时，窗口里会有这么一句（Mac / Linux 实测如此，Windows 是同一套 CLI）：

  账户 7a9e5014 还没有使用权 —— 在 iPhone 或 Android 上输入一次邀请码即可，
  这台机器会自动继承（CLI 上没有激活入口）

意思是：这个账户还没有使用权，激活只能在手机上做，电脑这边没有入口。打开手机上的 KernelHub App，照提示输入邀请码；兑换成功后，这台电脑自动继承，不用再敲任何命令。

• 一个码 30 天。
• 多个码天数累计：实测剩 29 天时再兑一个码，变成 59 天。
• 同一个码不能兑两次：第二次会被拒（invite_exhausted）。

没有码怎么要，见使用权限与激活。已经激活过的账户，pair 时会说「使用权已继承」，这一步跳过。

第 10 步 · 开始接活

这个窗口别关。它会一直开着，每隔几秒去看有没有新任务 —— 手机上发的任务就是它接的。开头几行会说它加入了哪个工作区、选了哪家 Runtime。

第 11 步 · 发一条真任务，看它交付

第 10 步那个窗口开着的时候，拿起手机：

1. 在 KernelHub App 里选中刚配对的工作区，在输入框里打一句话发出去。知道文件名就写上，比如「在 README.md 末尾加一行今天的日期，不要提交」。
2. 电脑上跑 icloser run 的窗口会滚出新的几行 —— 说明任务被接住了。手机上的任务卡会变成实时视图：读了哪些文件、跑了哪些命令、改了哪些文件。
3. 任务缺一档权限时，它会在动手之前停下来挂一张卡，点批准只对这一条任务生效。
4. 跑完之后，点卡片上的「改动」逐行看它改了什么，再读结果：做了什么、改了什么、有什么没做成。结果不满意就点「要求修改」，让同一条任务接着做。

成功：任务状态是完成，「改动」里能看到 README.md 多出的那一行，打开电脑上的文件也确实多了一行。

  ⓘ go：KernelHub Base（机器级，与这条任务无关）没装上 —— 不挂卡、不阻塞，这条任务照常往下跑。要补齐：在这台机器上跑 icloser env bootstrap go，或在设备权限里批 exec + web 后它会自动补上。

发出去一直没人接：回去看第 10 步那个窗口还在不在；还卡着就做下一步体检。

第 12 步 · 体检（另开一个 PowerShell）

第 10 步那个窗口在跑，所以另开一个 PowerShell，先 cd 到同一个项目目录，再跑：

服务、网关、队列、权限、Runtime 一次查完。哪一项不对，它会直接说下一步该敲什么。

第 13 步 · 关掉窗口也要接活：装成常驻

第 10 步那个窗口一关，手机上再发任务就没人接了。想让它登录 Windows 就自己起来，在项目目录下跑（不需要管理员，以你自己的账户运行）：

成功（CLI 源码里的原句）。2026-09-16 在 Windows 真机上装过：icloser daemon status 显示在跑，icloser doctor 报「✓ 常驻服务 已安装且正在运行」，一条任务由它接走并交付：

✓ 常驻已装好（计划任务：iCloser Agent）

之后随时用这一行看它在不在：

装了常驻之后，第 10 步那个手动开的 icloser run 就可以关掉了，两个同时开是多余的。

3 · 装完之后常用的

再装别的 Runtime（不用重跑整个安装）

默认只装了 claude。能用 npm 装的有：claude、codex、qwen、codebuddy、opencode、kimi、mimo、pi。下面这一行装的是 codex，换成其中任意一个即可：

或者用安装命令指定（同样把 codex 换成你要的）：

装完同样要登录一次（敲它的名字，比如 codex）。Google 这一家是 agy（Antigravity），不走 npm，要从 Google 官方渠道装。

本机管理台

管理台是单独的程序，icloser run 不会带起它。起它（这个窗口也会一直占着）：

然后在浏览器打开 http://127.0.0.1:18092。它只绑在本机回环地址，这台电脑之外够不着。看它现在在不在跑、地址是什么：

已经在跑的话，这一行帮你在默认浏览器里打开它：

4 · 完全离线：用离线整包（兜底，能上网就别用）

离线整包带齐了 Node、7-Zip、Python、Git、文档工具、各家 Runtime 的安装包和 KernelHub 三件套，装的过程不需要外网。

4.1 先核整包，再解压

下面默认包在「下载」文件夹里；不在就把命令里的路径改掉。

下载时把整包和它旁边那个 .sha256 文件一起下下来，放同一个文件夹。下面这一行自己读旁挂文件、自己算、自己比，不用你肉眼对：

成功：打出 OK 加那串哈希：

OK  <旁挂文件里的那串哈希>

对不上就别用 —— 传输坏了或被人动过，重新下一遍（两个文件都要重下）：

MISMATCH  期望 <旁挂文件里的那串>  实际 <这台机器上算出来的那串>

解压到 D:\kh-apps（后面的命令都默认在这里）：

成功：最后一行是 True：

解压完成：
True

下面每条命令都以 $P='D:\kh-apps\kernelhub-from-zero-windows-x64'; 开头，是为了每一行都能单独复制、单独跑。解压到别处的话，把每行开头这一小段路径改掉。

4.2 装机顺序（照这个顺序，别跳）

① 装 7-Zip（后面的 .7z 都靠它解开，会弹图形安装器）：

确认装好了（打出一个 7z 的路径即可）：

② 解开 Node.js 26.8.2（整条离线路线的前提，没有 npm 后面一个 Runtime 都装不上）：

找到 node.exe、临时加进当前窗口的 PATH 并自证（打出两行版本号即成功）：

写进用户级 PATH，以后每个新窗口都认得：

③ 装 KernelHub 三件套（不需要管理员）—— 这一行照安装脚本的做法：拷 CLI 与管理台到 %LOCALAPPDATA%\Programs\icloser、建三个旧名、写用户级 PATH、最后自证：

成功：最后一行打出 icloser 的版本行，版本号与构建号和整包里 winx64\stable.json 写的一致（整包是 2026-09-13 打的，里面是那时的版本，不是本页顶上的这一版）。另一条路（需要管理员）是装 MSI：

④ 装 Runtime —— 顺序很重要：先装「真身」，再装「壳包」

先装 4 个真身：

再装 8 个壳包（顶层 tgz）：

第 9 家 agy（Antigravity）不走 npm，跑包里的 Google 官方安装程序，再自证：

⑤ 逐个登录：每家都要在 PowerShell 里敲一次它的名字（claude、codex、qwen、codebuddy、opencode、kimi、mimo、pi、agy），按提示登录，否则不能跑任务。

⑥ 接上手机并开始接活：回到第 2 节，从第 7 步（进项目目录）做到第 13 步。项目目录不要选 D:\kh-apps 下面。

4.3 包里的基础工具（按需，不必都装）

落地目录 D:\tools\… 只是示例，换哪里都行，记得把它的 bin 加进 PATH。

Python 3.12.10（免安装、不写注册表、不需要管理员）：

Python 3.14.7（同目录另有，按项目选）：

Git 便携版（自解压；-o / -y 是 7z 自解压包的通用开关，底稿里标注未实测）：

uv（Python 包管理器）：

ripgrep（rg.exe）：

jq（单文件 exe）：

pandoc 3.11（文档转换）：

poppler（含 pdftotext.exe）：

Python 文档处理插件（这一条要联网；用哪个 Python 就换成哪个 exe）：

注意：pytesseract 还要另装 Tesseract 本体；pdf2image 依赖上面的 poppler。文档处理用到的 imagemagick 包里没有，需要时从 imagemagick.org 取 Windows 版并自己核哈希。

4.4 离线路线的三条限制（一定要知道）

5 · 网络被堵：把命令通到外面

先对照第 2 节开头那张表，搞清楚被堵的是哪一段。下面每条都能单独复制。

5.1 设代理（只对当前这个窗口生效）

把 端口 换成你自己的代理地址和端口（代理软件的设置里能看到，常见叫 mixed-port / HTTP 端口）。curl.exe 认 http_proxy / https_proxy，PowerShell 的 irm 走 .NET 的默认代理 —— 这一行两套一起设，最后自证：

成功：

install.ps1 -> HTTP 200

打不出 HTTP 200：代理地址或代理本身不对，先别往下走。通了之后，第 2 节的原命令不用改，照常在这个窗口里跑。

5.2 npm 换镜像

换成镜像并自证（会回显镜像地址）：

只这一次用镜像，不动全局设置：

有代理时把代理也写进 npm：

registry.npmmirror.com 是常见的公共镜像，换别的镜像把地址替换掉即可。

5.3 pip 换镜像

写进配置，以后都走清华镜像，并自证：

只这一次：

5.4 换 KernelHub 自己的下载源

公司内网有镜像时用（镜像要照原样镜像官方目录，清单里的 SHA-256 仍然会核）：

注意：这只换「清单与安装包」从哪下，安装脚本本身仍然从 icloser.xyz 取。

5.5 另外三个安装开关

换安装目录（默认 %LOCALAPPDATA%\Programs\icloser）：

一个 Runtime 都不装（只要 CLI）：

装指定的那一家（见第 3 节的 codex 那一行，把 codex 换掉即可）。

6 · 自己核一遍文件对不对

「文件放上去了」不等于「装好了」。下面这些校验不需要联网，用 Windows 自带的 certutil。

核已经装好的 icloser.exe（第 4 步线上装的：x64 和下表第一行比，ARM64 和第二行比）：

离线包里的三件套，一行自动和包内清单比对（打出 OK 开头即对）：

OK  icloser  <整包 winx64\stable.json 里记的那串哈希>

前四行是构建本页时从这一版的发布清单 stable.json 读进来的；离线整包里的文件不在这里印数字 —— 整包打于 2026-09-13，和这一版不是同一批，它们的哈希以整包自带的 stable.json 为准；Node 那一行来自 nodejs.org 的 SHASUMS256.txt；离线整包不在这里印哈希，理由见上面一行。

整包逐文件核对（可选，近 1 GB 会跑一会儿；全对逐行打印 ok）：

7 · 常见报错：症状 → 原因 → 那一行命令

8 · 卸载 / 清干净

① 装过常驻的，先卸常驻（在任意目录跑）：

② 先看清楚要删什么（只列，不删）：

③ 删数据目录。三个目录分别是配置与任务台账、身份凭据、受保护的根目录，三个都删掉才算清干净。删了就要重新配对：

④ 删程序本体：

最后可以在「设置 → 系统 → 关于 → 高级系统设置 → 环境变量」里，把用户 Path 里那条 …\Programs\icloser 删掉。Node 与各家 Runtime 是你自己装的，要删请用各自的卸载方式。