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 是你自己裝的，要刪請用各自的解除安裝方式。