n8n CLI（@n8n/cli）是官方 2026 年 3 月推出的終端機工具：透過 API 連到你跑著的 n8n，不用開瀏覽器就能管理 workflow、execution、credential，還能讓 Claude Code 這類 AI 工具直接幫你操作 n8n。
想像你要把十幾個確定不用的 workflow 停用。
網頁上的流程是：打開列表、點進 workflow、關掉 Active、退回列表，
重複十幾次，大概要五分鐘。
n8n 官方在 2026 年 3 月推出了 CLI 工具，同樣的事一行指令、十幾秒跑完。
這個時候推出 CLI 的原因很明顯：結合 AI
你跟 Claude Code 說「幫我把所有 archive 的 workflow 全部刪掉」，
它會自己組指令、跑完、回報結果，這在 n8n 平台上需要一筆一筆刪除！
這篇是我用了兩個多月的實測整理：
快速導覽
適合對象： 已經有一個跑著的 n8n（Cloud 或自架都算），想更有效率管理它的朋友
這篇中後段都是終端機指令，比較適合至少開過終端機的讀者。
完全不碰指令的人
可以讓 AI 替你打指令，請直接跳到 AI 整合。
n8n CLI 是什麼？跟自架的 n8n 指令不一樣
先解決一個很多人會混淆的點。
有些人可能用過 n8n export:workflow、n8n import:credentials 這類指令，
那是裝在「伺服器上」的 n8n 本體指令，要登入主機才能跑。
這篇講的 n8n CLI 是 2026 年 3 月底隨 n8n 2.14 推出的新工具，
套件名稱叫 @n8n/cli，
官方文件也有獨立的頁面。
你可以把它想成遙控器：n8n CLI 則是從任何一台電腦遙控你的 n8n，只要有 API key、連得到網路。
| 比較 | n8n 本體指令 | n8n CLI（@n8n/cli） |
|---|---|---|
| 跑在哪 | n8n 所在的主機 | 任何一台電腦 |
| 連線方式 | 直接操作資料庫 | 透過 n8n API |
| n8n Cloud 能用嗎 | 不行 | 可以（付費方案） |
| 適合做什麼 | 搬家、匯出匯入、維運 | 日常管理、批次操作、接 AI 工具 |
本文基於 @n8n/cli 0.7.0（目前的 latest 版）撰寫，文中所有指令都實測過。
這個工具還掛著 beta 標籤、更新蠻快的，新版指令如果長不一樣，以 –help 為準。
安裝與連線設定
前置準備
需要的東西只有兩樣：
- 一個跑著的 n8n（Cloud 付費方案或自架都可以，還沒有的話可以先看部署方式比較這篇）
- n8n 的 API key：到 n8n 的 Settings → n8n API → Create an API key 建立，設個名稱跟過期時間就好
API key 建立後只會完整顯示一次，記得先複製起來。
安裝
不熟終端機也沒關係：Mac 開內建的「終端機」（Terminal）、Windows 開 PowerShell，
把下面的指令貼上去按 Enter 就好。
只是想試試看，可以用 npx 免安裝直接跑：
1 | npx @n8n/cli workflow list |
確定會常用的話，建議直接裝成全域指令：
1 | npm install -g @n8n/cli |
電腦沒有 npm 的話，代表還沒裝 Node.js，先裝它就有了
（裝完重開一個新的終端機視窗，回來接著跑就行）。
連上你的 n8n
跑 login，它會互動式地問你 URL 跟 API key：
1 | n8n-cli login |
URL 就是你平常開 n8n 網頁的那個網址（Cloud 是 https://xxxxxx.app.n8n.cloud，
自架就是你平常開 n8n 用的網域，像 Zeabur 部署的就是它配給你的 xxx.zeabur.app 網址）。
設定完用 config show 確認有連上：
1 | $ n8n-cli config show |
不用擔心設定很麻煩，整個流程大概 2-3 分鐘內搞定。
日常操作：workflow、execution、credential
查 workflow
1 | $ n8n-cli workflow list --limit 3 --format table |
常用的過濾參數：
--active：只看啟用中的--name：用名稱過濾--tag：用標籤過濾
輸出有三種格式：table、json、id-only。
有個貼心的設計：當你把輸出 pipe 給其他指令時，它會自動切成 JSON。
而且內建 --jq 過濾器，不用另外安裝 jq 就能直接撈欄位：
1 | n8n-cli workflow list --jq '.[].name' |
查 execution：debug 利器
這是我自己用最多的部分。
每次都要打開執行列表頁面查詢失敗的 execution
現在 AI 一下就把失敗的撈出來和幫你檢查為什麼出錯：
1 | n8n-cli execution list --status error --limit 10 |
--status 可以過濾 error、success、running、waiting、canceled，
--workflow 可以鎖定特定 workflow。
找到問題那筆之後：
execution get <id>：拿完整的執行細節 JSON，每個節點的輸出都在裡面execution retry <id>：把那筆失敗的執行重新跑一次（背後呼叫的是 n8n API 的 retry 端點）
對常常需要 debug 的人來說，光這功能就值得裝了。
credential：查得到、建得了，但拿不到裡面的憑證金鑰
credential list 列出所有憑證，credential create 可以建新的。
比較特別的是 credential schema：
1 | n8n-cli credential schema slackApi |
會回傳這種 credential 需要哪些欄位的 JSON 結構。
用指令建 credential 最卡的就是不知道格式長怎樣，這個指令直接給你規格書。
credential get 只會回傳 metadata，拿不到裡面存的 token 或密碼。
這是刻意的安全設計，不可能用 CLI 把憑證直接匯出。
AI 整合：讓 Claude Code 直接幫你管 n8n
這是我覺得最有趣的部分，也是不想學指令的人最該看的一段。
CLI 內建 skill install 指令，
會幫 Claude Code、Cursor、Windsurf 裝好一份「怎麼用 n8n-cli」的操作說明（skill）：
1 | n8n-cli skill install # 裝到目前專案 |
跑完後就會在你使用的 AI 工具裡面多一份關於 n8n-cli 的 skill 可以用
你可能或多或少聽過 skill 或是已經用的駕輕就熟
例如我用 Claude Code，我安裝好這個 Skill 後
Claude Code 就能透過這個 Skill (說明書) 去理解 n8n-cli 該怎麼使用
設定完成後的日常長這樣：
我平常 debug 就是直接跟 Claude Code 說「幫我看今天哪些 execution 失敗」，
它會自己組出 execution list --status error、讀結果、回報哪個 workflow 出事，
連 workflow JSON 都能直接撈出來分析是哪個節點設定有問題。
哪些指令能放心跑？
官方文件把這個工具定位在「實驗、本地開發、個人專案」。
白話翻譯是「指令語法還會變，別把它焊死在正式環境的流程裡」，
不是「用了會出事」。
其實照指令的性質分三級，就很好判斷：
| 分級 | 指令 | 建議 |
|---|---|---|
| 唯讀查詢 | list、get、schema、audit、config show | 隨便跑，自己的、公司的、客戶的 n8n 都安全 |
| 會動到資料 | create、update、delete、activate、deactivate、retry | 自己的 n8n 隨意；別人的環境先 list 確認範圍再動手 |
| 自動化排程 | 排進 cron / CI 的任何指令 | 鎖定版本安裝（@0.7.0），升版人工確認過語法再換 |
其他功能快速參考
上面講的是日常最常碰的部分，剩下的指令用表格整理：
| 指令 | 功能 | 誰用得到 |
|---|---|---|
| data-table | 管理 n8n 內建資料表，支援批次新增、更新、upsert、刪除 rows | 有用 Data Table 存資料的人 |
| project | 建立專案、管理成員、跨 project 搬移 workflow | 團隊協作的用戶 |
| tag | 建立、改名、刪除標籤 | 想整理 workflow 的人 |
| variable | 管理 instance 層級的變數 | 多環境部署的人 |
| user | 查使用者清單 | 管理員 |
| audit | 產出資安稽核報告，可挑 credentials、nodes 等五種類別 | 自架的人都該定期跑 |
| source-control | 從 Git 拉最新版本 | 有開 source control 的團隊 |
data-table 管的就是 Data Table 節點存的那些資料，
rows 的批次新增、更新、upsert 都能從終端機做。
要學 n8n cli 還是交給 AI Agent
在這個充滿 AI 的時代
如果你是個人用途，需要用 n8n 幫忙處理一些自動化
那會建議多先學會 n8n 後，再讓 AI 幫忙操控 n8n cli 即可
相當是你把一些無聊或是重複的 n8n 操作轉移給 AI 來幫忙
而你自已還是需要設計或是主導自動化流程的開發
但你如果是企業主或是商家
你沒有那麼多的時間跟人力來學習 n8n
而什麼都交給 AI Agent 又很浪費 token 時
還是建議可以找找相關的自動化顧問來做討論
例如報表的自動化就牽涉到要串接哪些資料，是否需要整理跟清理
這些或許 AI 都做得到，但每天重複跑，又伴隨大量的資料時
用 AI 所消耗的花費就很可觀，又完全是浪費的
建立好 n8n 等相關流程後，每天的運作都可以接近 0 token
相關服務參考 : n8n 顧問服務，需要的話可以聊聊。
目前限制
誠實說，它還在 beta，這些坑先知道再上：
- 指令還在變：
--id-only改版就是例子，舊教學的範例可能直接報錯。文中指令都以 0.7.0 實測為準 - 沒有 archive 指令： n8n 介面上的 workflow 封存功能，API 已經支援，CLI 還沒跟上
- 沒有 folder 操作： 資料夾的整理還是得回網頁拖拉
- 一次只能記一組連線： 設定檔只存一台 n8n，管多台的解法見下方
多台 n8n 怎麼切換
設定檔一次只能存一台，對同時管自己跟客戶 n8n 的人蠻不方便的。
目前最乾淨的解法是環境變數搭 shell alias，一鍵切換（實測過可用）：
1 | # 放進 ~/.zshrc 或 ~/.bashrc |
之後 n8n-home workflow list 查自己的、n8n-client execution list --status error 查客戶的，
互不打架，也不會動到 login 存的那組設定。
常見問題
@n8n/cli（注意有 @n8n 前綴），裝完之後指令名稱才是 n8n-cli。先 npm uninstall -g n8n-cli 再 npm install -g @n8n/cli 就好。credential get 只回傳名稱、類型這些 metadata，不會吐出 secrets，這是 n8n API 本身的安全設計。反過來要注意的是：API key 本身是全權限（非 Enterprise 沒有唯讀 key），所以 key 要當密碼保管。相關文章推薦
總結
n8n CLI 已經用了好幾個月，讓 AI 接手大部分的 n8n 管理工作，
尤其搭配 Claude Code 之後，調整 workflow 或是測試幾乎都可以讓 AI 代勞！
我們只要確認節點的設定是否合理，是否有用最佳的方式去做 workflow 就好
畢竟 AI 還是很常會亂作一通
結果可能都是對的，但 AI 拉出來的 workflow 很多時候非常繞路或是效能不佳
適合場景：
- workflow 多到網頁管理開始煩的人
- 已經在用 Claude Code 或 Cursor，想讓 AI 直接幫忙協助 n8n 的人