Slash Commands 完整指南
/init 初始化專案上下文
/init 是每個新專案的起點。執行後，Claude Code 會掃描當前工作目錄，自動讀取 CLAUDE.md、package.json、README.md 等設定檔，並在記憶體中建立專案輪廓。若尚未存在 CLAUDE.md，系統會提示你建立一份，讓後續每次啟動都能沿用相同的專案規則與慣例。
CLAUDE.md 中明列：語言與框架版本、測試指令、Lint 工具、禁止修改的目錄，以及你偏好的 Commit Message 格式。/init 讀取這些規則後，整個會話都會自動遵守。
# 典型的 CLAUDE.md 片段
Language: TypeScript 5.x
Test command: npm run test
Lint: npm run lint
Do NOT modify: dist/, .env*
Commit format: feat|fix|chore(scope): message/help 即時查閱可用功能
對任何指令或功能有疑問，直接輸入 /help 即可列出當前會話所有可用的 Slash Commands，包含內建指令與自訂指令。也可以加上關鍵字縮小範圍，例如 /help permissions 只顯示與權限相關的說明。
- 不需要離開終端機查閱文件
- 自訂指令（
.claude/commands/）也會一併列出 - 每次升級後第一件事就是執行 /help，確認新功能
/clear 何時清除對話上下文
/clear 會清除當前會話的全部對話歷史，釋放 Token 空間，讓 Claude Code 以「全新狀態」繼續工作。這個指令看似簡單，但「何時該清」是一門學問。
切換到完全不同的子任務時（例如從「修 Bug」切換到「寫文件」）、上下文視窗已接近上限導致回答品質下降時、或完成一個完整里程碑並想重新聚焦時，都適合執行 /clear。
CLAUDE.md 載入的規則，也不會清除已寫入磁碟的檔案。它只清除對話記憶，不影響實際工作成果。若想保留重要結論，可先用 /compact 壓縮摘要再清除。
/status 檢視當前工作狀態
/status 顯示當前會話的環境資訊，包含：已載入的 CLAUDE.md 路徑、當前使用的模型版本、Token 使用量與剩餘額度、以及已授予的工具權限清單。這是在執行高風險操作前的標準確認步驟。
- 確認
CLAUDE.md有被正確讀取 - 確認模型版本符合預期（避免使用舊版模型）
- 確認 Token 使用量，避免在關鍵時刻被截斷
- 確認工具權限是否過於寬鬆
/compact 壓縮上下文節省 Token
當對話歷史很長但你想繼續同一個任務時，/compact 會將目前所有對話濃縮成一份結構化摘要，保留關鍵決策與待辦事項，捨棄冗餘的來回對話。壓縮後的摘要會作為新的起點繼續工作，Token 消耗大幅降低。
# /compact 典型輸出結構
## 已完成
- 修正 auth.ts 中的 JWT 驗證邏輯
- 新增 /api/refresh 端點
## 進行中
- 撰寫對應的 Jest 測試（尚未完成）
## 待確認
- refresh token 的過期時間是否需要可設定？/doctor 環境診斷工具
/doctor 是安裝後或遇到異常時的第一線診斷工具。它會自動檢查：Node.js 版本、CLI 版本是否為最新、API Key 設定是否正確、網路連線狀態，以及常見的設定錯誤。
- 安裝完成後立即執行，確認環境正常
- 升級 CLI 後執行，確認無版本衝突
- 回應異常緩慢或出現奇怪錯誤時執行
- CI/CD 環境首次設定時執行
ANTHROPIC_API_KEY 已正確匯出，或在 ~/.claude/.env 中設定。
/permissions 管理工具存取權限
Claude Code 預設採用保守的權限模型：讀取檔案可以，執行 Shell 指令或寫入特定目錄需要明確授權。/permissions 讓你查看當前已授予的工具權限，並可在會話中動態調整。
# 查看目前權限
/permissions
# 授予執行 shell 指令的權限（本次會話有效）
/permissions allow shell
# 撤銷寫入權限
/permissions deny write:./config/CLAUDE.md 的 permissions 區塊。
/review 程式碼審查模式
/review 觸發 Claude Code 進入深度審查模式，對指定範圍的程式碼進行靜態分析，涵蓋：邏輯錯誤、安全漏洞、效能瓶頸、可讀性問題與測試覆蓋率缺口。審查結果會以結構化清單呈現，每項問題附帶嚴重程度與修正建議。
# 審查當前 git diff（未提交的變更）
/review
# 審查特定檔案
/review src/auth/jwt.ts
# 審查最近一個 commit
/review HEAD~1- 提交 Pull Request 前執行，作為自我審查
- 接手遺留程式碼時執行，快速掌握風險點
- 重構完成後執行，確認沒有引入新問題
/cost 查詢 Token 消耗費用
/cost 顯示當前會話的 Token 使用量與對應的 API 費用估算，讓你掌握成本節奏，避免超出預算。在長時間的自動化任務中，這個指令特別有用。
自訂 Slash Commands .claude/commands/
除了內建指令，你可以在專案根目錄的 .claude/commands/ 資料夾中建立 Markdown 檔案，定義專屬的 Slash Commands。每個 .md 檔案就是一個指令，檔名即為指令名稱。
# 建立自訂指令：/deploy-check
# 路徑：.claude/commands/deploy-check.md
## 指令說明
在部署前執行標準檢查清單。
## 步驟
1. 執行 `npm run lint` 並確認無錯誤
2. 執行 `npm run test` 並確認全部通過
3. 檢查 `CHANGELOG.md` 是否已更新版本號
4. 確認 `.env.example` 與實際 `.env` 欄位同步
5. 回報所有步驟的執行結果- 指令檔案使用 UTF-8 編碼，支援中文命名
- 可在指令中引用
$ARGUMENTS接收動態參數 - 團隊共用指令請提交至 Git，個人指令放
~/.claude/commands/ - 執行 /help 可看到所有自訂指令清單
各指令最佳使用時機對照表
| 指令 | 最佳使用時機 | 頻率建議 |
|---|---|---|
| /init | 開啟新專案 / 首次進入陌生 Repo | 每個新 Repo 一次 |
| /help | 忘記指令名稱 / 升級後確認新功能 | 按需使用 |
| /clear | 切換子任務 / 上下文品質下降 | 任務切換時 |
| /status | 執行高風險操作前 / 確認環境設定 | 高風險操作前 |
| /compact | 對話過長但不想中斷任務 | 每個功能模組後 |
| /doctor | 安裝後 / 升級後 / 環境異常時 | 環境變更後 |
| /permissions | 任務需要特殊工具存取 / 安全審計 | 按需調整 |
| /review | 提交 PR 前 / 接手遺留程式碼 | 每次 PR 前 |
| /cost | 長時間自動化任務 / 成本管控 | 每日結束時 |
| /自訂指令 | 重複性流程 / 團隊標準化作業 | 建立後頻繁複用 |