wesammustafa/Claude-Code-Everything-You-Need-to-Know

Claude Code – 實用指南

是什麼 – 本倉儲是 Anthropic 官方命令列介面 Claude Code 的逐步教學。此工具讓您能直接在終端機中執行 Claude（公司的大型語言模型）。本指南將引導您完成 CLI 安裝、認證、向 Claude 發送指令以讀取與編輯程式碼，並透過自訂 Skills、Hooks、Sub-agents、Workflows 和 MCP 伺服器來擴充工具。

適合對象 –

• 新手：從未使用過 Claude Code 的使用者可依照「設定 → 提示工程 → 第一個技能」路徑，在約 15 分鐘內上手。
• 資深使用者：可深入學習 Skills、Hooks 以及 Model-Context-Protocol（MCP）的進階內容。
• 團隊負責人 / 自動化工程師：可學習如何建構多代理團隊、動態工作流程，以及適用於大型專案的 BMAD 框架。

涵蓋的關鍵概念

功能	作用	檔案位置
Skills（斜線指令）	可重複使用的 Markdown 提示，可透過 /skill-name 呼叫 Claude。適用於重複性任務（如開啟 PR、執行測試）。	.claude/commands/*.md
Hooks	在會話啟動、工具使用或子代理終止等事件時自動執行的腳本。	.claude/settings.json（連結至 .claude/hooks/ 中的 Python 腳本）
Sub-agents	擁有獨立上下文的隔離 Claude 會話，適用於大型子任務。	.claude/agents/*.md
Workflows	JavaScript 檔案，用於協調多個代理與工具以解決複雜任務。	.claude/workflows/*.js
MCP（Model-Context-Protocol）伺服器	使 Claude 能夠從 CLI 呼叫外部服務（瀏覽器、資料庫、API 等）。依專案設定。	專案特定設定檔（無固定路徑）

本倉儲如何幫助您

• .claude/ 目錄 是一個可直接複製使用的範例專案，包含每種擴充點（7 個斜線技能、5 個子代理、動態工作流程、Python Hooks 等）各一個。
• 詳細的 Markdown 指南（docs/skills.md、docs/reference/effort-levels.md 等）解釋了 effort levels、提示工程 以及建構 AI 代理框架的 BMAD 方法背後的思維模型。
• 速查連結與表格可輕鬆選擇合適的模型（Sonnet 5、Opus 4.8、Fable 5 等）與適當的努力等級（low → ultracode）。

為何重要 – Claude Code 將 LLM 驅動的程式碼輔助引入開發者的原生 shell 工作流程，使模型能：

1. 讀取整個專案（檔案樹、匯入、grep 結果），而不僅僅是貼上的片段。
2. 就地編輯檔案 並自動執行測試套件，提供即時反饋。
3. 透過斜線指令、鈎子與外部 MCP 服務與您現有的工具鏈整合。

透過提供具體、可複製貼上的範例，本指南降低了團隊採用 AI 驅動自動化時的門檻，而無需鎖定在特定編輯器或 IDE 中。

---

快速開始

npm install -g @anthropic-ai/claude-code   # 安裝 CLI
claude                                    # 認證（開啟瀏覽器）
cd my-project && claude                    # 啟動 Claude 會話
/explain what this codebase does           # 範例提示