Claude Code /powerup 互動式教學與 April 2026 重點更新完整指南

打開 Claude Code 輸入 /powerup，終端機裡跑出一段互動式動畫教學。不用開瀏覽器、不用翻文件，在你寫程式的地方直接學怎麼用這個工具。這是 v2.1.89 加進來的新功能，搭配同一時期的 MCP 500K 上限、headless defer 機制和 /cost 增強，四月的第一週就塞了四個版本更新。

/powerup：終端機裡的互動教學

/powerup 的設計哲學很明確——新手不需要離開終端機就能學會 Claude Code 的核心功能。每個 lesson 都有動畫示範，不是只給你看文字說明，而是實際在終端機裡播放操作過程。

# 啟動 Claude Code 後直接打
/powerup

# 會看到課程選單，選你想學的功能
# 每個課程有互動式的 step-by-step 引導

跟一般文件的差別在哪？文件告訴你「你可以用 /loop 設定排程」，/powerup 則是在終端機裡示範整個設定流程，讓你跟著操作。學習曲線直接壓平一截。

對比一下其他 AI coding 工具的新手引導：Cursor 靠的是 GUI 裡的 tooltip 和官網教學影片，Kiro CLI 在 v1.25 加了 Help Agent 用對話方式解答問題，Copilot 則是內建在 IDE 的 inline suggestion。Claude Code 選擇在 CLI 裡做互動教學是很合理的——你的使用者本來就在終端機裡，幹嘛要他切到瀏覽器？

MCP 500K：工具回傳上限大幅提升

之前 MCP tool result 的大小限制一直是個痛點。如果你的 MCP server 回傳的資料量比較大——例如資料庫查詢結果、長文件內容、API 批次回應——常常會被截斷。

v2.1.90 把這個上限拉到 500,000 字元，透過 _meta annotation 指定：

{
  "content": [{"type": "text", "text": "...大量資料..."}],
  "_meta": {"maxCharacters": 500000}
}

500K 字元大概是什麼概念？一篇 5,000 字的中文文章大約 5,000 字元，所以 500K 大概可以塞 100 篇文章的量。對於資料庫查詢結果或 API 批次回應來說，這個空間相當充裕。

不過要注意，塞越多資料進 context 就吃越多 token。不是所有情境都適合開到最大，合理設定才是正途。

Defer Permission：Headless 模式的權限暫停機制

這個功能改變了 headless 模式（-p flag）的權限處理邏輯。之前 headless session 碰到需要權限的工具呼叫時，要嘛自動允許要嘛直接拒絕，沒有中間地帶。

現在 PreToolUse hook 多了一個 defer 選項。當 hook 回傳 defer 時，headless session 會暫停在那個工具呼叫上，等你用 -p --resume 重新連上後再決定要不要放行。

# 啟動 headless session
claude -p "幫我重構這個模組"

# session 碰到需要權限的操作時暫停
# 你可以之後再接回去
claude -p --resume <session-id>

搭配另一個新功能——PreToolUse hook 現在可以透過 updatedInput 回應 AskUserQuestion，讓 headless 整合自己的 UI 來收集使用者答案。如果你在做 Claude Code 的自動化管線（CI/CD、排程任務等），這兩個功能讓你不用再在「全開放」和「全拒絕」之間二選一。

/cost 增強：看清楚錢花在哪裡

/cost 指令之前只顯示總花費，現在多了兩個維度：

Per-model split——如果你的 session 用到多個模型（例如主模型 + sub-agent 用不同模型），現在可以看到每個模型各花了多少。

Cache-hit split——顯示 prompt caching 幫你省了多少錢。如果你的工作流會重複送類似的 prompt（例如同一個 CLAUDE.md 被反覆載入），cache hit 率高的話省的錢不少。

/cost
# 輸出範例：
# Total: $2.45
# ├─ claude-opus-4-6:  $2.10 (85.7%)
# ├─ claude-haiku-4-5: $0.35 (14.3%)
# └─ Cache savings:    $0.82 (25.1% hit rate)

知道錢花在哪裡才能針對性優化。如果 Haiku 能處理的子任務卻用了 Opus，切一下模型就能省不少。

其他值得注意的更新

Bedrock 互動式設定精靈——從登入畫面選「3rd-party platform」就能進入，引導你完成 AWS 認證、region 設定、credential 驗證和 model pinning。之前這些全要手動改設定檔。

Headless 啟動效能改善——-p 模式現在延遲載入 Yoga WASM 和 UI 元件，加上 MCP_CONNECTION_NONBLOCKING=true 可以跳過 MCP 連線等待。如果你的 MCP server 啟動很慢，headless session 不用再被拖著等。MCP server 連線也加了 5 秒上限，不會因為一個 server 卡住而影響整個 session。

記憶體洩漏修復——修了好幾個：大 JSON 輸入被 LRU cache 留住的問題、Edit tool 操作超大檔案（>1 GiB）可能 OOM 的問題、remote session 裡 tool use ID 無限累積的問題。長時間跑的 session 穩定性應該會好很多。

四月第一週版本總覽

版本	重點
v2.1.89	/powerup 互動式教學
v2.1.90	MCP 500K 上限、Defer permission
v2.1.91	/cost per-model split、cache-hit 顯示
v2.1.92	Bedrock 設定精靈、記憶體修復、效能優化