Cursor CLI 非互動模式:讓 AI 在腳本和 CI 裡自己跑

3 min read
Cursor CLI 非互動模式:讓 AI 在腳本和 CI 裡自己跑

互動模式是「AI 問你、你按 Y/N」,適合開發時邊確認邊做。但如果你想把 Cursor CLI 放進 CI 或寫成腳本定期跑——沒有人在旁邊按鍵,這套流程就卡住了。

非互動模式解決的就是這件事:給一個指令,AI 自己跑完,不等人。

加上 --no-interactive

cursor agent "幫專案加上 .editorconfig" --no-interactive

簡寫也可以:-n。AI 會直接執行,不會停下來問你,跑完就結束。

這個模式適合的任務有共同特徵——結果可預期、可重複跑,例如加 .editorconfig、修 lint、照規範整理格式之類的事,不適合那種「還沒想清楚要做什麼」的需求。

放進腳本裡

#!/bin/bash
cd /path/to/project
cursor agent "依照 CONTRIBUTING.md 跑 linter 並修復" --no-interactive

CI 環境要特別注意:機器上要有 Cursor 授權,先跑過 cursor auth login 或設好 token,不然 AI 沒辦法上工——這個被忘掉的機率蠻高的。

指定模型(可選)

想固定用某個模型跑:

cursor agent "重寫這段註解" --model claude-3-5-sonnet --no-interactive

實際可用的模型名稱以官方文件為準,別自己猜型號。

長任務交給雲端跑:-c

任務很重、不想佔著終端機等它跑完:

cursor agent "分析整個 repo 並產出架構文件" -c

-c 會把這輪對話交給雲端 Agent 繼續執行——你可以關掉終端機去做別的事,之後用 --resume 接回來看結果。等於「背景執行」,差在是 AI 在背景幫你做事,不是你的 shell process。


模式 參數 適合
非互動(本地) --no-interactive / -n 腳本、CI、結果可預期的任務
指定模型 --model 模型名 需要特定模型品質的任務
雲端背景執行 -c 長時間任務、關機也能繼續

腳本寫好之前先手動跑一次確認行為,別直接就扔進 CI——這個教訓最好不要親身學到。

下一步:05-tips — 幾個實用技巧加上大家最常問的問題,少踩幾個雷。