安裝 - Nomo

每台電腦只需安裝一次。需要 bun 或 node 18 以上版本 — 這個外掛程式沒有任何 npm 相依套件，只用 Node 內建模組執行。

手動安裝

Claude Code
Codex
OpenCode

終端機
桌面應用程式

在 Claude Code session 裡執行：

/plugin marketplace add KarrixLee/nomo
/plugin install nomo-cc@nomo

依序進入 Settings → Plugins → Add → Add marketplace，在 URL 填入儲存庫：

KarrixLee/nomo

接著按 Sync，在清單裡安裝 Nomo — Claude Code。

Claude 桌面應用程式的 Add marketplace 對話框，URL 填的是 KarrixLee/nomo — 填 GitHub 的 owner/repo 就夠了 — Nomo 的儲存庫本身就是市集。

之後請重新啟動 Claude Code，讓外掛程式的 hooks 載入。確認它已經裝好：

/nomo-cc:status

Claude Code 裡所有 Nomo 指令都在 nomo-cc: 命名空間下 — 輸入 /nomo-cc: 就會列出全部。

Codex 0.142 以上版本內建自己的外掛程式系統，因此 Nomo 是以獨立的 Codex 外掛程式安裝，不需要 Claude Code。

安裝外掛程式

終端機
桌面應用程式

codex plugin marketplace add KarrixLee/nomo
codex plugin add nomo@nomo

如果你比較習慣打字，桌面應用程式的內建終端機也可以。

依序進入 外掛程式 → 新增 → 新增市集，在 Source 填入儲存庫：

KarrixLee/nomo

Git ref 和 Sparse paths 維持原樣就好 — 裡面的灰字是佔位符，不是你要填的值。接著按 新增市集，在清單裡安裝 nomo。

Codex 桌面應用程式的新增市集對話框，Source 填的是 KarrixLee/nomo — Nomo 的儲存庫本身就是市集，沒有清單可以瀏覽，也不需要送審。

這裡說的「市集」不是可以逛的商店，而是指向 GitHub 儲存庫的登錄檔 — 也就是 Nomo 自己的儲存庫。所以要先加入儲存庫，再從裡面安裝外掛程式。

信任 hooks — 必要步驟

終端機
桌面應用程式

/hooks

信任那七個 Nomo 項目。終端機裡顯示為英文的「trust」。

別跳過這一步。Nomo 的 hooks 會隨外掛程式一起安裝，但在你信任之前都不會運作。在那之前，外掛程式雖然裝好了卻什麼也沒做 — 沒有任何 session 會送到你的手機，也不會有任何錯誤訊息。

這是 Codex 自己的安全關卡，Nomo 無法代為預先核准。hook 的指令行在各版本之間逐位元組保持不變，所以信任一次就能延續到後續更新 — 只有指令行變動時才會重新要求審核。

確認

$nomo-status

這會回報配對、watchdog、hook 信任狀態與最後一次傳送的健康狀況 — 所以也可以用它來確認信任那一步真的生效了。

Codex 的 skills 使用 $ 前綴而不是斜線 — $nomo-pair、$nomo-status、$nomo-reset、$nomo-unpair。

OpenCode 沒有市集，也沒有安裝外掛程式的指令 — 它只會撿取自己設定資料夾裡找得到的東西。所以 Nomo 是從一份 clone 安裝的，再由一個 script 把檔案放進 OpenCode 本來就會去看的位置。

Clone 下來並執行安裝 script

git clone https://github.com/KarrixLee/nomo.git ~/.nomo
~/.nomo/plugin/scripts/opencode-install.sh

你想 clone 到哪裡都可以 — script 會自己算出所在位置，所以沒有路徑要查，也沒有東西要手動編輯。它會明確印出自己寫了什麼：

~/.config/opencode/plugins/nomo.js — 一行指回那份 clone 的 stub。
~/.config/opencode/commands/nomo-*.md — 那六個指令。

已經為 Claude Code 或 Codex 裝過 Nomo 了嗎？把 script 指向那一份就好，不用再 clone 第二份 — claude plugin list 或 codex plugin list 會印出它放在哪裡。

--project 會裝進 ./.opencode，只作用於一個儲存庫而不是全域。重複執行是安全的，而且要搬動那份 clone 時也是這樣做：從新位置再執行一次。

重新啟動 OpenCode — 必要步驟

OpenCode 只在伺服器啟動時匯入外掛程式一次，而且沒有熱重載。在你結束並重新開啟它之前，這個外掛程式雖然裝好了卻什麼也沒做。桌面應用程式跑的是同一個伺服器，所以同樣需要這次重新啟動。

確認

/nomo-status

這一次安裝同時也涵蓋 OpenCode 桌面應用程式：它跑的是 OpenCode 自己的伺服器，讀的是同一個外掛程式資料夾。

之後要更新，在 OpenCode 裡一個指令就好：/nomo-update 會先檢查，再拉取並重新執行這個安裝 script — 它做什麼，以及什麼時候會拒絕。

OpenCode 的指令名稱是扁平而且全域的，所以 Nomo 的指令完全不帶前綴：是 /nomo-pair，不是 /nomo-cc:pair 或 $nomo-pair。六個都在指令裡。

到你手機上會不一樣的部分寫在搭配 OpenCode 使用。

一鍵安裝

安裝工具會找出這台電腦上有哪些 Claude Code、Codex 和 OpenCode，再把 Nomo 裝進你挑的那幾個：

bunx nomo-ai

npx nomo-ai

一開始一個都沒勾選：方向鍵（或 k、j）移動，空白鍵勾選，Enter 安裝所有勾選的。接著它就去跑每個代理本來的安裝流程 — 也就是上面那三套。它不會在全域裝任何東西，也不會留下套件。寫指令碼或在 CI 裡使用時：

選項
`--claude` `--codex` `--opencode`	只裝這幾個 — 只要指定其中任何一個，就會略過選擇畫面
`--all`	三個全裝，不管有沒有找到
`-y`、`--yes`	不出選擇畫面，找到多少裝多少
`-n`、`--dry-run`	把要執行的指令印出來，什麼都不執行

它不會替你配對手機。之後就照上面的步驟收尾：重新啟動代理，如果是 Codex 就信任那些 hook，然後配對 — /nomo-pair，在 Claude Code 裡是 /nomo-cc:pair，在 Codex 裡是 $nomo-pair。

更新

同一個指令也負責更新：已經裝了 Nomo 的代理，會顯示成更新而不是安裝。真正會執行的只有 OpenCode 那一份，另外兩個只是印出來給你。

Claude Code
Codex
OpenCode

claude plugin update nomo-cc@nomo

自動更新對第三方市集預設是關閉的，所以安裝不會自己動。要打開：/plugin → Marketplaces → Nomo 那個 → Enable auto-update。

通常沒有什麼要執行。Codex 直接從外掛程式所在路徑即時讀取，所以在那份 clone 裡拉取更新就是全部的更新 — 而且根本沒有 codex plugin update 這個動詞。如果你這個市集是從 git 加入的，那 Codex 存著一份快照，更新它就是更新：

codex plugin marketplace upgrade <市集名稱>

名稱是你當初加入時用的那個，未必是 nomo。

這一份由安裝工具代勞。在 OpenCode 裡執行 /nomo-update 也一樣。兩種方式之後都要重新啟動 OpenCode — 外掛程式只在伺服器啟動時匯入一次。

外掛程式做的事

它會監看 session，並把狀態變化回報到你的手機：代理正在處理什麼、什麼時候停下來，以及什麼時候需要你授予權限。在你配對手機之前，它不會送出任何東西；而所有送出的內容都會先在這台電腦上加密。這個外掛程式是開源的 — 你可以在安裝之前，確切讀到它收集與送出的內容：

KarrixLee/nomo

完整的外掛程式原始碼，採用 MIT 授權。從 marketplace 安裝就只是單純複製這個儲存庫。

下一步

配對你的電腦

掃描 QR code；如果無法開啟瀏覽器，也可以手動輸入一次性代碼。

設定

在手機上

在電腦上

說明

安裝

手動安裝

一鍵安裝

更新

外掛程式做的事

KarrixLee/nomo

下一步

配對你的電腦

​手動安裝

​一鍵安裝

​更新

​外掛程式做的事

KarrixLee/nomo

​下一步

配對你的電腦

手動安裝

一鍵安裝

更新

外掛程式做的事

下一步