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 只跑一次：建工作區、寫本機設定、在終端機裡畫出 QR Code。run 是之後一直開著的那條。
我裝到的到底是哪一版 —— 回報問題時第一句話說它
每個專案一次：建工作區 + 問一次權限 + 出 QR Code
保持開著。真正去接活、去做事的就是它。
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 |
只綁在回送位址上。這台機器之外的任何東西都搆不著它 —— 這也是它自己不需要一套登入的原因。