KernelHub 快速上手
十分钟，把整条路走一遍。走完你会已经从手机发过一条任务，并看着它在自己的机器上跑完。
开始之前
- 必需：那台机器上先装好 Node.js LTS（自带 npm），要在装 KernelHub 之前。Runtime 是通过 npm 装的，而 KernelHub 安装器不会替你装 Node。
- 一台放着你要改的代码的机器 —— macOS、Linux 或 Windows。
- 那台机器上已经装好一个 CLI 编码 Agent，比如 Claude Code 或 Codex。KernelHub 驱动它，但不包含它。
- 一部手机或第二台电脑，用来驱动。
1 · 先有 Node.js，再装上 执行体
先确认 Node.js 和 npm 都在 —— 这是必需的。跑这两条，两条都打出版本号再往下：
有一条报「command not found」？先去 nodejs.org 装 Node.js LTS（自带 npm），或者照 Windows 从 0 开始 · Mac 从 0 开始 · Linux 从 0 开始 一步一行装。原因：Runtime 是通过 npm 装的，而 KernelHub 安装器不会替你装 Node。
然后，在放着你代码的那台机器上：
Windows PowerShell：irm https://icloser.xyz/install.ps1 | iex。macOS / Linux 装到 ~/.local/bin，不需要 sudo；Windows 装到 %LOCALAPPDATA%\Programs\icloser，不需要管理员，装完还会核一遍新开的终端里敲 icloser 拿到的是不是刚装的这一份（机器上有同名的别的工具时，改用 icli）。SHA-256 核不了的时候它会明说，不会静默跳过。
先照「从 0 开始」一步一行走一遍，它把 Node、PATH、登录 Runtime、配对、发第一条任务都写成了能复制的命令：Windows 从 0 开始 · Mac 从 0 开始 · Linux 从 0 开始
2 · 首次启动
进到你想让 KernelHub 干活的那个目录里：
那个目录就成了一个工作区。进程留在前台，每几秒轮询一次有没有活。它打印的头几行会说清自己加入了哪个工作区、选了哪家 Runtime —— 读那几行，后面绝大多数困惑的答案都在里面。
3 · 配对设备
在同一台机器上打开 KernelHub Desktop，点「连接手机」，然后用手机扫码。用加入链接也一样。细节以及「扫了没反应」怎么办，见配对。
4 · 选 Runtime
KernelHub 会自己找机器上有的 Runtime。要指定某一家：
换哪一家，授权都在同一个地方核：写、改、执行经 KernelHub 内建的 Tool Server。各家的区别见 Runtime。
5 · 逐档授权
你不说它能做什么，它什么都不做。在机器上授权：
读和写足够改文件了。要它跑构建和测试才加 exec。删除 / 迁移数据永远不走远程授权。见权限。
6 · 发一条任务
在手机或桌面的输入框里打一句话发出去。知道文件名就写上 —— 指名道姓的任务，事后你自己也好核：
7 · 看实时工作区
任务卡会变成一个实时视图：读了哪些文件、跑了哪些命令、改了哪些文件。它一动手改东西，diff 就出来了 —— 那时它还在跑。见实时工作区。
8 · 读改动
点卡片上的「改动」逐行看。文件清单是按这条任务归因的 —— 任务开始前就已经改过的文件不会混进来。见改动。
9 · 需要时批准
任务缺一档权限时，它会在动手之前停下来挂一张卡。批准只对那一条任务生效，任务结束即失效。见批准。
10 · 读结果
跑完的任务会说它做了什么、改了什么、以及有什么没做成。结果单薄的话用「要求修改」—— 那是让同一条任务接着做，不是重开一条。见结果。
先装：Node.js 与 npm（必需）
在下面任何一步之前，先装好 Node.js LTS（自带 npm），再确认下面两条都打出版本号。Runtime 是通过 npm 装的，而 KernelHub 安装器不会替你装 Node。
两条都有版本号 → 往下走。有一条报 command not found → 先装 Node.js LTS；全新电脑照帮助里 Windows / Mac / Linux「从 0 开始」一步一行做。
装它
每个平台一行。脚本自己去读发布清单，所以版本号、文件名、校验和一个都不写在你敲的这条命令里。SHA-256 对不上它不装。
装到 ~/.local/bin，不要 sudo。要换地方用 KERNELHUB_BIN_DIR。旧名 icli / kernelhub-cli / devnexus-cli 继续可用。
落下来的是 icloser_darwin_amd64 · icloser_darwin_arm64
装到 ~/.local/bin，不要 sudo。要换地方用 KERNELHUB_BIN_DIR。旧名 icli / kernelhub-cli / devnexus-cli 继续可用。
落下来的是 icloser_linux_amd64 · icloser_linux_arm64
同时写用户级 PATH 和当前会话，所以下一条命令直接就能敲，不用先开个新窗口。它不碰系统级 PATH。
落下来的是 icloser_windows_amd64.exe · icloser_windows_arm64.exe
装完当场核对构建号与清单 ——「文件放上去了」不等于「装好了」。想自己核的话，每个二进制的体积与 SHA-256 都在下载页上。 1.0.2 · build 202609161352
装完之后的第一条命令
在你的项目目录下敲。pair 只跑一次：建工作区、写本机配置、在终端里画出二维码。run 是之后一直开着的那条。
我装到的到底是哪一版 —— 报障时第一句话说它
每个项目一次：建工作区 + 问一次权限 + 出二维码
保持开着。真正去接活、去干活的就是它。
icloser qr，别再跑一次 pair。再 pair 一次会新建一个空工作区，原来的任务一个都不在里面。Desktop 从哪儿打开
管理台是独立进程，它不随 icloser run 启动，要单独起：kernelhub-desktop（Mac 上也可以直接打开 KernelHub Desktop.app）。下面两条告诉你它在不在跑、在哪，并在它跑着的时候帮你打开；第二条在非交互环境里只把地址打出来，不弹窗。
现在什么状态、管理台在哪、下一步做什么 —— 还没有工作区时也能跑
在默认浏览器里打开它
| 地址 | http://127.0.0.1:18092 |
| macOS | kernelhub-desktop_darwin_amd64 · kernelhub-desktop_darwin_arm64 |
| Linux | kernelhub-desktop_linux_amd64 · kernelhub-desktop_linux_arm64 |
| Windows | kernelhub-desktop_windows_amd64.exe · kernelhub-desktop_windows_arm64.exe |
只绑在回环地址上。这台机器之外的任何东西都够不着它 —— 这也是它自己不需要一套登录的原因。