Skip to content

Home

Jump to bottom
JeffChen edited this page Apr 11, 2026 · 1 revision

模組 1：Slash Commands（斜線命令）

斜線命令是在互動 session 中最快速控制 Claude Code 行為的方式。在提示列輸入 /，就會出現所有可用命令的選單。

命令分為四大類：

情境管理（Context Management）：/context 用視覺化的格子顯示目前情境使用量；/compact 壓縮對話歷史（可附加指示保留重要部分，例如 /compact keep the migration plan）；/clear 完全清空重新開始。

Session 工具：/rename 幫 session 命名；/resume 繼續之前的 session；/branch 建立平行對話分支；/rewind 回滾到更早的時間點；/export 匯出 session。

設定調整：/model 切換模型（Sonnet、Opus、Haiku 等）；/effort 設定推理深度（low/medium/high/max）；/permissions 管理 Claude 的操作權限。

診斷工具：/cost 顯示費用、token 使用量；/status 查看版本與帳號資訊；/doctor 檢查安裝健康狀態；/diff 開啟互動式 diff 檢視器。

模組 2：Memory & CLAUDE.md（記憶與記憶檔案）

Claude Code 的「記憶」是指跨 session 持久保存的情境。與每次重設的對話視窗不同，記憶檔案在 Claude Code 每次啟動時會自動載入。

記憶階層（由高到低優先順序）：

  1. Managed Policy（組織層級，由管理員控制）
  2. Project memory（專案根目錄的 CLAUDE.md，提交至 git 與團隊共享，最常用）
  3. User memory（~/.claude/CLAUDE.md，個人偏好，套用到所有專案）
  4. Local memory（./CLAUDE.local.md，個人專案設定，被 git 忽略）

大型專案可把規則拆成 .claude/rules/*.md，並使用路徑過濾，例如 paths: src/api/**/*.ts 只在處理 API 檔案時才啟用該規則。

Auto Memory（自動記憶）：Claude 會自動在 ~/.claude/projects/<project>/memory/MEMORY.md 記錄它發現的模式與洞察，前 200 行會在每次 session 開始時自動載入。

模組 3：Project Setup（專案設定）

為 Claude Code 做好專案設定大約需要十分鐘。效益是從第一條訊息開始 Claude 就理解你的規範，有正確的權限做有用的工作，並在團隊間保持一致的行為。

初始化：執行 /init，Claude 會掃描你的程式碼庫（讀取 package.json、目錄結構等）並生成 CLAUDE.md。好的 CLAUDE.md 應精簡（每個檔案建議 200 行以內），包含技術堆疊、開發指令、命名慣例、常見陷阱。

權限設定：.claude/settings.json 提交至 git 供團隊共享；.claude/settings.local.json 被 git 忽略，用於個人設定。可預先批准常用操作（例如 Bash(git *) 允許所有 git 指令）或明確拒絕危險操作。

設定優先順序（由高到低）：managed settings → 命令列參數 → settings.local.json → settings.json → ~/.claude/settings.json

模組 4：Commands Deep Dive（命令深入）

這個模組涵蓋更進階的命令技巧：

情境與 Session 管理：/context 可視化情境；/compact 壓縮時可指定保留方向；/branch 平行探索兩種方案；/rewind 可還原檔案變更（等同「程式碼與對話的 undo」）。

內建技能命令：/simplify 對最近修改的檔案做程式碼品質審查（並行使用多個 review agent）；/batch <instruction> 用於大規模跨多檔案的修改；/loop 5m check deploy status 週期性執行命令。

鍵盤快捷鍵：Shift+Tab 切換權限模式（default → acceptEdits → plan → auto）；Option+T / Alt+T 切換延伸思考模式；Ctrl+O 進入詳細模式；/btw your question 問側邊問題而不寫入對話歷史；Ctrl+B 讓 subagent 在背景執行。

模組 5：Skills（技能）

技能是 Claude 根據情境自動發現並使用的可重用能力。它們比簡單命令更強大：支援漸進式載入（保持輕量）、動態 Shell 情境注入、subagent 隔離，以及調用控制。

技能載入機制（三層漸進式）：Level 1 只載入名稱與描述（知道技能存在）；Level 2 在技能被觸發時才載入完整的 SKILL.md；Level 3 需要時才讀取輔助檔案（templates、scripts）。這樣可安裝很多技能而不會塞爆情境視窗。

技能位置：.claude/skills/<name>/SKILL.md（專案範圍）或 ~/.claude/skills/<name>/SKILL.md（個人範圍）。

關鍵 frontmatter 欄位：

  • description：最重要，控制 Claude 何時自動觸發技能（需要具體、包含觸發詞）
  • disable-model-invocation: true：只有用戶能手動觸發，Claude 不會自動觸發（用於有副作用的技能，如部署）
  • context: fork：在隔離的 subagent 中執行，主對話保持乾淨
  • paths:：限定在特定路徑才啟用
  • effort:：設定技能的推理深度
  • !command``：動態執行 Shell 指令並將結果注入技能內容（用於取得即時情境）
  • $ARGUMENTS、$0、$1：接收命令參數

模組 6：Hooks（鉤子）

Hooks 是在 Claude Code session 中特定事件發生時自動執行的腳本。它們透過 stdin 接收 JSON 輸入，並透過 exit code 和 JSON 輸出溝通結果。

主要事件類型：

  • PreToolUse：工具執行前（可阻擋，exit code 2 = 阻擋）
  • PostToolUse：工具執行後（觀察或反應）
  • UserPromptSubmit：用戶輸入送出前
  • Stop：Claude 完成回應時
  • SubagentStart/Stop：subagent 生命週期
  • FileChanged：檔案被更改時
  • CwdChanged：工作目錄改變時（自動載入環境變數）

Hook 類型：command（執行 Shell 指令）、prompt（用 LLM 評估）、agent（啟動 subagent 做多步驟驗證）、http（POST 到 webhook）。

常見用途：存檔後自動格式化（PostToolUse + prettier/black）、偵測寫入的敏感資訊、阻擋危險命令（rm -rf /）、commit 前自動執行 lint 和測試。

Exit code 意義：0 = 成功；2 = 阻擋性錯誤（Claude 停止並顯示訊息）；其他 = 非阻擋性警告。

模組 7：MCP Servers（模型情境協定伺服器）

MCP（Model Context Protocol）讓 Claude 能即時存取外部服務。與儲存靜態情境的記憶檔案不同，MCP 連線讓 Claude 能查詢即時資料——你的 GitHub issues、生產資料庫、Slack 頻道，或任何有 MCP 伺服器的服務。

新增伺服器：

claude mcp add --transport http notion https://mcp.notion.com/mcp
claude mcp add --transport stdio github -- npx @modelcontextprotocol/server-github

傳輸方式：http（遠端伺服器）、stdio（本地 process）、sse（舊版遠端）。

三種範圍：Local（私人，當前專案）、Project（.mcp.json 提交 git，團隊共享）、User（個人，所有專案）。

實用功能：MCP prompts 以 /mcp__servername__promptname 形式作為斜線命令；MCP resources 用 @server:protocol://resource/path 引用；工具搜尋（Tool Search）預設啟用，減少情境佔用。

安全最佳實踐：憑證永遠用環境變數，不提交 token 到 git，只需要讀取時用唯讀 token。

模組 8：Subagents（子代理人）

Subagents 讓 Claude 能把工作委託給專門的 AI 助手，每個有自己的情境視窗、工具集和系統提示。它們防止長任務污染情境，支援並行執行，並讓你把領域專業知識封裝成可重用的代理人。

定義方式：Markdown 檔案加 YAML frontmatter，放在 .claude/agents/（專案範圍）或 ~/.claude/agents/（個人範圍）。

重要 frontmatter 欄位：

  • tools：限制代理人能使用的工具（提高安全性）
  • model：指定模型（haiku 快、sonnet 均衡、opus 強推理）
  • effort：推理深度
  • maxTurns：限制執行輪數
  • isolation: worktree：在獨立的 git worktree 中工作，不影響主工作樹
  • background: true：總是在背景執行
  • memory：持久記憶跨 session

內建代理人：general-purpose（通用）、Explore（快速唯讀分析）、Plan（先研究再提計畫）、claude-code-guide（解答 Claude Code 問題）。

Agent Teams（實驗性）：多個 Claude 實例並行協作，透過共享任務列表與信箱協調。

模組 9：Advanced Features（進階功能）

Planning Mode（計畫模式）：把「思考」和「執行」分開。Claude 先研究程式碼庫並提出詳細計畫，你審查（可修改）後才執行。啟用方式：/plan <description>、--permission-mode plan、或 Shift+Tab 切換。opusplan 模型別名會用 Opus 做計畫、Sonnet 做執行。

Extended Thinking（延伸思考）：給 Claude 更多推理時間。用 Option+T 切換，或 /effort 設定深度（ultrathink 關鍵字可觸發最深層推理）。

Auto Mode（自動模式）：使用背景安全分類器決定工具調用是否安全，不需每次詢問。對看起來像資料外洩、危險 Shell 或影響生產的操作仍保守處理。

權限模式光譜：default → acceptEdits（自動批准檔案編輯）→ plan（先計畫）→ auto（分類器判斷）→ dontAsk→ bypassPermissions（跳過所有安全檢查，適合 CI/CD）。

程式化執行：claude -p "your prompt" 非互動執行，結合 --output-format json 可做自動化整合。

Sandbox（沙箱）：OS 層級隔離，限制檔案系統和網路存取，適合執行不可信任的程式碼。

模組 10：Workflows（工作流程）

這個模組教如何把 Claude Code 整合進自動化基礎設施：

CI/CD 整合：claude -p 搭配 --output-format json 和 --permission-mode bypassPermissions 可在 GitHub Actions 中自動執行程式碼審查，解析 JSON 結果並寫入 PR summary。

排程任務：

  • /loop 5m check if the build succeeded：session 範圍內的週期性檢查
  • /schedule "run a security audit at 2am"：雲端排程持久任務

多步驟工作流程模式：

  • 開發與驗證模式：Stop hook 用 prompt 評估任務是否真正完成，未完成則繼續
  • 平行審查模式：Agent Teams 讓安全、效能、測試覆蓋率的審查同時進行
  • 批次修改：/batch 拆分工作給多個在隔離 worktree 的背景代理人

模組 11：Plugins（插件）

插件是 Claude Code 最高層級的擴充機制。它們把技能、subagent、hooks、MCP 伺服器和 LSP 設定打包成單一可安裝的套件。團隊安裝一個插件就能立刻獲得所有設定——不需為每個元件個別手動設定。

插件結構：唯一必須的檔案是 .claude-plugin/plugin.json（manifest）。其他可選：skills/、agents/、hooks/hooks.json、.mcp.json、.lsp.json、settings.json。

Plugin 命名空間：插件的技能和命令以 plugin-name:skill-name 命名，避免衝突。

Manifest 進階功能：

  • userConfig：宣告用戶可設定的選項（sensitive: true 的欄位存在系統鑰匙圈）
  • ${CLAUDE_PLUGIN_DATA}：插件的持久資料目錄
  • ${CLAUDE_PLUGIN_ROOT}：插件安裝目錄的相對路徑
  • LSP 支援：.lsp.json 設定語言伺服器，提供即時診斷

開發流程：用 --plugin-dir ./my-plugin 本地測試；用 /reload-plugins 熱重載；用 /plugin install plugin-name 從 marketplace 安裝。

企業管理：管理員可透過 managed-mcp.json 和 deniedPlugins 等設定控制組織內允許的插件和 marketplace。

整體學習路徑總結

入門（Beginner）
  ├── 模組1：斜線命令 — 日常操作基礎
  ├── 模組2：記憶系統 — 讓 Claude 記住你的偏好
  ├── 模組3：專案設定 — 初始化和權限管理
  └── 模組4：命令深入 — 進階操作技巧

中級（Intermediate）
  ├── 模組5：技能 — 建立可重用的自訂能力
  ├── 模組6：Hooks — 事件驅動的自動化
  ├── 模組7：MCP 伺服器 — 連接外部服務
  └── 模組8：Subagents — 委託給專門代理人

進階（Advanced）
  ├── 模組9：進階功能 — Plan Mode、思考模式、沙箱
  ├── 模組10：工作流程 — CI/CD 整合和自動化
  └── 模組11：插件 — 打包和發佈完整擴充套件

Clone this wiki locally