claude -p 是什麼？
跟互動模式差在哪？

核心觀念：-p 不是「閹割版 Claude」、是「同一個 Claude、不開互動視窗」

這個觀念釐清很重要、因為很多 AI 整理的教學會跟你說「-p 不會載 memory」「-p 不執行 hook」「-p 是獨立計費」。這些都不對、稍後會逐一修正。

-p 全名是什麼？跟「Headless」「Non-interactive」是同一個東西嗎？

是同一個東西、官方說法是：

-p, --print     Print response and exit (useful for pipes).

所以三個常見稱呼指的都是這個模式：

• Print mode：因為 flag 全名叫 --print
• Headless mode：因為沒有「頭」（沒有互動介面）
• Non-interactive mode：因為不開互動 REPL

設計目的：讓 Claude Code 可以被腳本呼叫、被 cron 排程、被 pipe 串接。等於把 Claude 變成 Unix 工具鏈裡的一環、可以跟 grep、jq、curl 一樣 pipe 串接。

互動模式 vs -p 預設 vs -p --bare：完整差異

很多教學只比兩欄、漏掉 --bare 這個關鍵第三欄。其實這才是「真正的乾淨環境模式」、cron 跟 CI 應該用它。

2 個常見迷思 + 1 個你必須知道的計費變動

前兩個是網路教學常講錯的點、第三個是 Anthropic 2026-05-14 官方公告的計費政策、影響所有 -p 用戶。

-p 才有的 flag（互動模式用不了）

這些 flag 設計給「腳本 / 批次」場景、互動模式用不上、所以不會出現在你的日常。

什麼時候用 -p、什麼時候繼續用互動？

何時加 --bare？

當你在意「環境可預測性」、不希望被 ~/.claude/ 累積的雜訊污染。例如：

• CI 環境：跑在乾淨容器、沒有 user-level CLAUDE.md
• 真的非用外部 cron 不可的任務：明確只想用某幾個 skill、其他不載
• 給別人用的腳本：怕你的 memory 帶來不一致行為

五個直接複製就能跑的範例

範例 1：單次任務 + JSON 拿成本資訊

claude -p "整理今天 Discord #line-mirror 未回覆訊息" \
  --output-format json | jq '{result: .result, cost_usd: .total_cost_usd}'

範例 2：從 stdin pipe（Unix 工具鏈）

# 把諮詢逐字稿摘要成 3 段
cat consultation.txt | claude -p "整理諮詢逐字稿成 3 段摘要"

# 抓網頁標題
curl -s https://example.com | claude -p "幫我抽出 og:title 跟 description"

範例 3：批次處理 N 個項目（for loop）

# 批改 5 篇 BRAND 作業、設成本上限避免燒爆
for url in $(cat homework_urls.txt); do
  echo "處理 $url"
  claude -p "用 /brand-grade 批改這個學員作業：$url" \
    --max-budget-usd 0.5 \
    --output-format json >> grading_results.jsonl
done

範例 4：Cron 夜間批次（⚠️ 6/15 後會吃 Agent SDK Credit）

# 在 crontab 加一行、每天早上 7 點跑
# 注意：6/15 起這種寫法吃 Agent SDK Credit、不是訂閱額度
0 7 * * * cd /Users/kevinhuang/Developer/claude-workspace && \
  claude -p --bare \
    --add-dir . \
    --mcp-config ./mcp-config.json \
    --append-system-prompt-file ./skills/daily-ops.md \
    --max-budget-usd 0.5 \
    "執行 daily-ops 並寄結果到 Gmail"

更省錢的做法：開一個長駐的互動 claude session、用 ScheduleWakeup 機制讓 Claude 自己每天 7am 醒來跑任務。這樣計費走訂閱額度池、不吃 Agent SDK Credit。見 Section 7。

範例 5：接續上次對話（不開新 session）

# 用 -c 接續最近的 session
claude -p "剛剛那篇文章再加一段結論" --continue

# 用 -r <session-id> 指定 session
claude -p "繼續剛剛的話題" --resume abc-123-def

用「對話模式 + 自我喚醒」取代外部 -p cron

這是 6/15 計費變動後最大的省錢竅門、值得單獨講。

核心觀念：Claude Code 計費分兩個池、看你的 session 是「互動模式」還是「-p 模式」、不是看「有沒有人坐在電腦前」。

實作流程（不需要寫程式）

1. 找一台可以長時間開著的電腦或 VPS（不用很強、Mac mini / 舊筆電 / 月費 VPS 都行）
2. 登入後直接打 claude 開互動視窗（不是 -p）
3. 告訴 Claude 你要的排程：例如「每天早上 7 點幫我跑 /daily-ops、寄結果到 Gmail」
4. Claude 會用 ScheduleWakeup 工具排下次醒來、你不用做任何事
5. 視窗開著就好、Claude 會自己照排程跑、跑完繼續排下一次

這就是「對話模式跑 cron」的真實長相：不是外部 cron 呼叫 Claude、是 Claude 自己排自己。所以從 Claude Code 計費系統的視角這就是一個普通的長駐互動 session、繼續吃訂閱額度。

什麼時候還是該用 -p？

• 真的需要 pipe 串接 Unix 工具：echo url | claude -p ... 這種、長駐 session 做不到
• CI / GitHub Actions：每次觸發都是全新環境、沒有「長駐」可言
• 批次處理 N 個項目跑完就走：for loop 100 次、長駐 session 反而不好控
• 嵌入別人的 SaaS / 自動化流程：用 Agent SDK 整合進別的產品

其他「定期 / 重複 / 排程」需求、優先考慮長駐互動 + 自我喚醒。