2026-05-18 更正聲明： 本文原版（2026-05-15 發佈）內容有重大事實錯誤，誤把課程數寫成「18 堂、分初級/中級/進階三階段」，實際是 10 堂、無分階段。錯誤原因是憑印象寫沒查 binary。本次（2026-05-18）整篇用本機 binary（/Users/yanchen/.local/share/claude/versions/2.1.143）的strings輸出做為 source of truth 重新寫過。對誤導讀者致歉。事故詳情寫進 blog-create skill 當作未來事故記憶（commit 在~/.claude/skills/ig-create/skill.md）。
TL;DR
- 本文解決：想系統把 Claude Code 進階功能學完一輪、但又懶得翻官方文件的工程師，到底該從哪 10 堂課切入
- 推薦給：已裝 Claude Code（v2.1+）、用過幾次但不確定還能玩什麼的人
- 讀完你會知道：/powerup 的 10 堂課實際在教什麼、每堂搭配什麼快捷鍵 / slash command、跑完一輪大約需要 30 分鐘
📌 目錄
🎯 /powerup 是什麼
/powerup 是 Claude Code CLI 內建的互動教學命令。在 Claude Code session 裡輸入 /powerup，會打開一個互動式選單，列出 10 堂「Power-ups」——每一堂教 Claude Code 一個多數人沒注意到的功能。讀完、動手試、按 Enter 標記完成。
官方說明（取自 binary 內字串）：
Each power-up teaches one thing Claude Code can do that most people miss. Open one, read it, try it, mark it done.
UI 上方有個進度條顯示 X/10 unlocked，全部完成會跳一個「All powered up」的提示。
✅ 真實的 10 堂課清單（不是 18 堂）
直接從本機 binary 撈出來的 Zr 陣列（lesson 定義），順序就是 /powerup 選單顯示順序：
| # | id | 標題 | tagline |
|---|---|---|---|
| 1 | at-mentions | Talk to your codebase | @ files, line refs |
| 2 | modes | Steer with modes | shift+tab, plan, auto |
| 3 | undo | Undo anything | /rewind, Esc-Esc |
| 4 | background | Run in the background | tasks, /tasks |
| 5 | memory | Teach Claude your rules | CLAUDE.md, /memory |
| 6 | mcp | Extend with tools | MCP, /mcp |
| 7 | automate | Automate your workflow | skills, hooks |
| 8 | subagents | Multiply yourself | subagents, /agents |
| 9 | cross-device | Code from anywhere | /remote-control, /teleport |
| 10 | model-dial | Dial the model | /model, /effort |
/powerup 就全部可選，順序自由。每堂完成後會被打勾 ✓，但不影響後面能不能開。
📚 每堂課實際教什麼
下面是每堂課的 tagline 與核心動作。內容直接從 binary Zr 陣列的 body 欄位翻譯（不是我憑印象寫）。
第 1 堂：Talk to your codebase（@ 提及檔案）
在 prompt 裡任何位置輸入 @，會跳出 fuzzy-find 選單讓你選檔案。Claude 會在回答前先讀那個檔案——不用再貼 code 進對話。
Type @ anywhere in your prompt to fuzzy-find and attach a file. Claude reads it before answering — no more pasting code.
實際範例：> what does @parser.ts do? → Claude 自己打開 parser.ts 讀完再回。
第 2 堂：Steer with modes（用模式控制 Claude）
按 Shift+Tab 在四個權限模式間切換。每個模式決定 Claude 動手前要問幾次：
| 模式 | 行為 |
|---|---|
| default | 每次編輯前都問 |
| accept edits | 自由編輯，跑 shell 命令時才問 |
| plan | 只研究、提案，永不動檔 |
| auto | Claude 自己決定什麼安全 |
plan。長時間無人值守 → 用 auto。想免問就跑特定命令 → /permissions 預先放行。
第 3 堂：Undo anything（/rewind 還原）
Claude 在每次編輯前都會 checkpoint 你的檔案。連按兩次 Esc Esc 打開 /rewind，可以 roll back 到任何之前的狀態——code、對話、或兩者一起回。
Claude checkpoints your files before every edit. PressEsc Esc(double-tap) to open/rewindand roll back to any prior state — code, conversation, or both.
寫到一半路線錯了？不用 git stash 救，直接 Esc Esc。
第 4 堂：Run in the background（背景跑長任務）
長 build 跟測試套件不該卡住你。任何 bash 命令後面加 & 就會在背景跑——你繼續跟 Claude 對話，跑完 Claude 主動通知你。
/tasks 列出當前所有背景任務的狀態。
第 5 堂：Teach Claude your rules（用 CLAUDE.md 教規矩）
在你的 repo 根目錄放一個 CLAUDE.md，Claude 每次 session 啟動時都會讀一次。把你的慣例寫進去：測試命令、命名規則、不准動的目錄、套件版本、commit message 格式。
/memory 命令打開 memory 編輯介面。
第 6 堂：Extend with tools（MCP 接外部工具）
MCP（Model Context Protocol）servers 給 Claude 新工具：讀 Slack、查資料庫、控瀏覽器。/mcp 命令瀏覽與連接 server。
MCP servers give Claude new tools: read your Slack, query your database, control your browser. Run /mcp to browse and connect servers.
第 7 堂：Automate your workflow（skill 與 hook）
把一段 prompt 存成 .claude/skills/deploy/SKILL.md，它就變成 /deploy——輸入它，Claude 跑那個流程。/skills 看你已經有哪些。
Hook 則是「某事件觸發某 shell command」的機制——例如「每次 edit 完自動跑 prettier」。
第 8 堂：Multiply yourself（subagent 並行）
Claude 可以 spawn 自己的副本並行做事。叫它「用 subagent 同時搜這 5 個目錄」，它會 fan-out 出去並行跑。
/agents 看可用的 agent 類型（general-purpose、code-reviewer、planner...）。
第 9 堂：Code from anywhere（跨裝置接力）
/remote-control 把當前 session 接到手機 / 平板 / 其他電腦。在 Claude mobile app 開 Code 分頁，或瀏覽器開 claude.ai/code。Session 本身仍跑在這台機器上，其他裝置只是遙控介面——電腦不用搬，工作不用斷。
/teleport 是相關命令，binary 裡同段提到。
第 10 堂：Dial the model（切模型與 effort）
/model 切模型：Opus 解硬問題、Sonnet 處理多數工作、Haiku 快問快答。/effort 控 Claude 在回答前思考多久——high 給棘手 bug、low 給簡單 edit。順帶一提還有 /fast，切 fast mode（同模型、更快輸出）。
🤔 為什麼是 10 堂、沒分階段
我猜 Anthropic 設計 /powerup 時的決策：
- 10 堂剛好對應 Claude Code 最常被忽略的 10 個功能——@ 提及、模式、rewind、背景任務、CLAUDE.md、MCP、skill/hook、subagent、跨裝置、模型切換
- 不分階段因為這些功能彼此正交、沒有先後依賴。你可以先學 subagent 也可以先學 @ 提及
- 進度條設計不是「鎖門」，是「自我追蹤」——10 個都點過會給「All powered up」獎章
/powerup 字面意思腦補的，跟真實設計理念完全相反。
⚡ 從 0 開始：怎麼跑 /powerup
Prerequisites
| 項目 | 用途 | 怎麼裝 / 確認 | |
|---|---|---|---|
| Claude Code 2.1+ | 跑 /powerup | claude --version，沒裝跑 curl -fsSL claude.ai/install.sh \ | bash 或 npm install -g @anthropic-ai/claude-code |
| Anthropic 帳號 + API key 或 Pro/Max 訂閱 | Claude Code 認證 | 第一次跑會引導登入 | |
| 終端機（任何 OS） | session 跑在哪裡 | macOS Terminal / iTerm2 / Windows Terminal / WSL 都行 |
三步驟
# 1. 確認版本
claude --version
# 預期：2.1.x 以上
# 2. 進入任何專案目錄、開 session
cd ~/your-project
claude
# 3. 在 prompt 輸入
/powerup
打開後用 ↑↓ 選課程、Enter 進去、看內容、Enter 標記完成、Esc 回選單。全部 10 堂跑一輪大約 30 分鐘。
驗證跑完了
> /powerup
# 預期看到右上角：10/10 unlocked
# 完成所有後會跳「All powered up」訊息⚠️ 踩到的坑
坑 1：本文原版自己就是個坑
我寫原版時憑印象寫 18 堂三階段，跑到第二次發文才被使用者抓到。教訓：Claude Code 內建功能也是 Claude Code 自己最該查的——binary 在本機，strings 一個命令就拿到事實。寫工具教學時，本機原始檔（binary、source code、--help 輸出）永遠優先於我腦中的記憶。
# 查 binary 內的 lesson 清單
strings /Users/yanchen/.local/share/claude/versions/$(claude --version | awk '{print $1}') | \
grep -oE 'id:"[a-z-]+",title:"[^"]+",tagline:"[^"]+"'坑 2：版本差異會讓堂數變動
我這次寫的 10 堂是基於 v2.1.143 build 2026-05-15。如果未來 Anthropic 加課、改名、重排，跟本文對不起來是正常的。要看你本機真實清單，跑上面那個 strings 命令。
坑 3：/powerup 不是「Claude Code 課程平台」
很多人（包括我原版）會把 /powerup 想成「Claude Code 大學」——分階段、有測驗、有結業證明。實際上它就是 10 個 tip 卡。看完、試完、打勾，沒了。不要期待它教你「進階 prompt engineering」或「Spring Boot 整合」——那些 Anthropic 放在 docs 與 cookbook，不在 /powerup 裡。
⚖️ /powerup vs 看文件 vs 自己摸索
| 維度 | /powerup | docs.anthropic.com | 自己摸索 |
|---|---|---|---|
| 完整度 | △（10 個重點） | ✓（全部） | ✗ |
| 速度 | ✓（30 分鐘） | △（半天） | ✗（幾週） |
| 動手練習 | ✓（每堂自己跑） | △（要切視窗） | ✓ |
| 離線可用 | ✓（binary 內建） | ✗ | ✓ |
| 適合對象 | 已裝、想看「還能幹嘛」 | 想深掘特定主題 | 探索型學習者 |
/powerup 30 分鐘掃過全貌，挑 2-3 個最想深掘的（例如 MCP、skill）再去 docs 看細節。
💡 心法 / 時間成本
- 跑一輪
/powerup大約 30 分鐘——10 堂 × 3 分鐘看 + 自己手動試一下 - 動手才會記得——光看不練，三天後就忘
- 完成獎章只是糖——沒打勾不會少功能、沒影響使用權，不要為了「全綠」硬刷
- 回頭重看也行——Claude Code 升版加堂數時，重跑一次
/powerup即可掃到新內容
❓ 常見問題
/powerup 跟 Anthropic 官網的 Claude Code 教學文件有什麼不一樣？
/powerup 是 CLI 內建的 10 個互動課，總長 30 分鐘、強調「掃過全貌」。官網 docs.anthropic.com 是完整參考手冊，分主題深入。兩個是互補關係：先 /powerup 掃廣度，再 docs 鑽深度。
為什麼有些教學文章說 /powerup 是 18 堂？
那是錯的（包含我自己的原版）。本機跑 /powerup 看到 10 堂、binary strings 撈出來也是 10 堂。如果有教學寫 18 堂，作者很可能（像我一樣）憑印象寫沒查證。用 claude --version 確認版本、自己跑 /powerup 看真實清單。
跑 /powerup 要付錢嗎？
/powerup 命令本身免費（內建在 Claude Code CLI）。但要用 Claude Code 必須有 Anthropic API key（按 token 付費）或 Pro / Max 訂閱（月費吃到飽）。
跑完 10 堂 /powerup 還能做什麼？
/powerup 只是入門快速覽。看完想深掘的方向：寫自己的 skill（.claude/skills/）、串 MCP server（Slack / DB / browser）、用 subagent 並行任務、用 /remote-control 跨裝置工作流。
🔗 延伸資源
---我輩修行之人，以聖的標準要求自己，以凡的眼光理解別人。