Claude Code 完整教學 2026——從安裝到進階技巧的實戰指南

Claude Code 教學涵蓋安裝設定、基礎指令、CLAUDE.md 配置、Multi-Agent 協作、MCP 串接與記憶管理，台灣工程師實戰整理。

早上開 Claude Code，花 10 分鐘跟它解釋專案背景。下午換另一個專案，又花 10 分鐘。隔天回來，昨天討論的架構決策？全忘了。再解釋一次。

如果你用 Claude Code 做過任何超過一天的開發工作，你一定經歷過這個循環。

這篇教學從安裝開始，一路走到 CLAUDE.md 配置、Multi-Agent 協作、MCP 外掛串接，最後解決這個「每次都從頭來」的問題。全程用台灣開發者熟悉的語境和工具鏈來說明。

---

Claude Code 是什麼？跟其他 AI 程式工具有什麼不同

Claude Code 是 Anthropic 官方推出的命令列介面工具。你在終端機裡輸入自然語言指令，它直接讀取你的程式碼、執行指令、修改檔案。

跟 GitHub Copilot 或 Cursor 不同的地方在於：

• 原生 CLI：不需要特定 IDE，任何終端機都能用
• 完整檔案存取：它能讀取整個專案結構，不只是當前開啟的檔案
• 指令執行能力：能直接跑 git、npm、pytest 等指令
• MCP 協定支援：透過 Model Context Protocol 串接外部工具和資料來源

簡單說，Copilot 是你的自動補全助手，Cursor 是你的 AI IDE，而 Claude Code 是一個住在終端機裡、能操作你整個開發環境的 AI agent。

對台灣開發者來說，這意味著你不需要換掉現有的 VS Code 或 Vim 工作流程。Claude Code 是疊加上去的，不是取代。

---

安裝與環境設定

系統需求

• macOS、Linux 或 Windows（透過 WSL2）
• Node.js 18 以上
• Anthropic API key（或透過 Amazon Bedrock / Google Vertex AI）

安裝步驟

# 用 npm 全域安裝
npm install -g @anthropic-ai/claude-code

# 確認安裝成功
claude --version

第一次執行 claude 時，它會引導你完成 API key 設定。如果你已經有 Anthropic 帳號，直接貼上 API key 就好。

API Key 設定

# 方法一：環境變數（推薦）
export ANTHROPIC_API_KEY="sk-ant-your-key-here"

# 方法二：第一次啟動時互動式設定
claude
# 跟著提示輸入 API key

建議把環境變數加到你的 ~/.zshrc 或 ~/.bashrc，這樣每次開終端機都不用重新設定。

驗證安裝

# 進入你的專案目錄
cd ~/projects/my-app

# 啟動 Claude Code
claude

# 試一個簡單指令
> 這個專案的結構是什麼？幫我列出主要的目錄和檔案

如果它能正確讀取你的專案結構並回應，安裝就完成了。

---

基礎用法——從第一個指令開始

互動模式 vs 單次指令

Claude Code 有兩種使用方式：

# 互動模式——開啟持續對話
claude

# 單次指令——執行完就結束
claude -p "幫我寫一個 Express.js 的健康檢查 endpoint"

互動模式適合持續開發，單次指令適合自動化腳本或 CI/CD 整合。

日常開發常用指令

以下是台灣工程師日常開發中最常用的幾種操作：

程式碼理解

> 解釋 src/auth/middleware.ts 這個檔案在做什麼
> 這個 useEffect 為什麼會觸發無限迴圈？
> 找出所有呼叫 paymentService 的地方

程式碼修改

> 把 src/api/users.ts 的錯誤處理改成用 try-catch 包起來
> 幫這個函式加上 TypeScript 型別
> 把這個 class component 重構成 functional component

測試與除錯

> 幫 src/utils/format.ts 寫單元測試
> 跑一下測試，看哪些失敗了
> 這個 TypeError 是怎麼回事？幫我修

Git 操作

> 看一下目前的 git 狀態
> 幫我 commit，訊息要描述這次改了什麼
> 建一個 PR，標題和描述都幫我寫好

權限控制

Claude Code 在執行檔案修改或指令前會先問你。你可以設定不同的權限等級：

• Ask（預設）：每次都問
• Auto-accept：自動接受特定類型的操作
• Deny：禁止特定操作

# 在 settings 中調整
claude /settings

這對資安敏感的台灣企業環境特別重要——你可以確保 AI 不會在未經同意的情況下執行任何破壞性操作。

---

進階技巧——讓 Claude Code 真正好用

CLAUDE.md：你的專案說明書

CLAUDE.md 是 Claude Code 的專案配置檔。放在專案根目錄，Claude 每次啟動都會讀取它。

# CLAUDE.md

## 專案概述
這是一個 Next.js 14 電商平台，使用 TypeScript + Prisma + PostgreSQL。

## 開發規範
- 使用 pnpm，不要用 npm
- 元件放在 src/components/，用 PascalCase 命名
- API routes 放在 src/app/api/
- 所有 API 回應用 { data, error, message } 格式

## 測試
- 用 Vitest 跑單元測試：pnpm test
- E2E 用 Playwright：pnpm test:e2e

## 注意事項
- 不要動 src/legacy/ 底下的檔案
- 資料庫 migration 要先跟團隊確認

有了 CLAUDE.md，你不用每次都跟 Claude 解釋「我們用 pnpm 不是 npm」或「測試框架是 Vitest」。它會自動遵守這些規範。

進階用法：多層 CLAUDE.md

project/
├── CLAUDE.md              # 全域規範
├── src/
│   ├── CLAUDE.md          # src 目錄特定規範
│   └── components/
│       └── CLAUDE.md      # 元件開發規範

Claude Code 會合併所有層級的 CLAUDE.md，越深層的優先度越高。

Multi-Agent 協作：Task 工具

Claude Code 支援多代理人協作。當任務複雜時，它會自動啟動子代理人（sub-agent）來處理不同部分。

你也可以主動觸發：

> 用 Task 工具幫我同時做這三件事：
> 1. 搜尋所有 deprecated 的 API 呼叫
> 2. 檢查 package.json 有沒有安全漏洞
> 3. 分析 src/utils/ 底下哪些函式沒被用到

每個子任務會由獨立的 agent 處理，結果彙整後回報給你。這在大型專案的重構或審查中特別有用。

MCP 串接：擴展 Claude Code 的能力

Model Context Protocol（MCP）是 Anthropic 推出的開放協定，讓 AI agent 能串接外部工具。

常見的 MCP 串接場景：

用途	MCP 伺服器	效果
資料庫查詢	PostgreSQL MCP	直接查詢資料庫，不用手動貼 SQL 結果
瀏覽器操作	Playwright MCP	自動化測試、截圖、爬取網頁
檔案搜尋	Filesystem MCP	更精確的檔案搜尋和內容分析
API 測試	HTTP MCP	直接發送 API 請求並分析回應

設定 MCP 伺服器：

# 在 Claude Code 中新增 MCP 伺服器
claude mcp add my-db-server npx @modelcontextprotocol/server-postgres postgresql://localhost:5432/mydb

設定完成後，Claude Code 就能直接查詢你的資料庫、操作瀏覽器、或呼叫外部 API——不需要你手動複製貼上任何東西。

Slash Commands：快速操作

Claude Code 內建了一些快捷指令：

/help          — 查看說明
/clear         — 清除對話歷史
/compact       — 壓縮對話，釋放 context window
/settings      — 調整設定
/cost          — 查看目前 session 的 API 用量

/compact 特別實用。當對話太長、Claude 開始「忘記」前面的內容時，用 /compact 可以壓縮歷史，保留重點。

---

記憶管理——跨 Session 不再從頭來

這是多數 Claude Code 使用者遲早會遇到的問題。

你花了一個小時跟 Claude 討論架構決策、確認了技術方案、寫了一半的程式碼。關掉終端機，隔天再開——一切歸零。Claude 不記得昨天的對話。

CLAUDE.md 能解決一部分問題：靜態的專案規範、開發慣例。但它處理不了動態的東西——「上週我們決定用 Redis 做快取」「這個 bug 的根因是 race condition，我們選了 optimistic locking」「目前進度到 API 層，前端還沒開始」。

這些活的、會變的專案脈絡，需要一個專門的記憶層。

問題的根源

Claude Code 的每個 session 是獨立的。它沒有內建的跨 session 記憶機制。你有幾個選擇：

1. 每次手動貼上下文——可行但痛苦，而且你一定會漏掉東西
2. 把所有東西寫進 CLAUDE.md——CLAUDE.md 會變得巨大且難以維護
3. 用專門的記憶工具——自動化管理專案脈絡

如果你只有一個專案，手動管理勉強可以。但如果你同時跑多個專案——接案者同時服務 3-5 個客戶、工程師同時維護多個微服務——手動管理就崩潰了。A 客戶的技術決策跑進 B 客戶的對話裡，上週確認的需求今天又得重新解釋。

用 MemClaw 解決跨 Session 記憶

MemClaw 是一個專案工作區工具，給每個專案一個獨立的記憶空間。安裝到 Claude Code 之後，每個專案有自己的工作區，切換專案就切換工作區——8 秒還原所有脈絡。

安裝：

# Step 1: 設定 API key
export FELO_API_KEY="your-api-key-here"
# 取得 API key：https://felo.ai/settings/api-keys

# Step 2: 安裝（擇一）

# Claude Code（推薦）：
/plugin marketplace add Felo-Inc/memclaw
/plugin install memclaw@memclaw

# OpenClaw：
bash <(curl -s https://raw.githubusercontent.com/Felo-Inc/memclaw/main/scripts/openclaw-install.sh)

# 手動安裝：
git clone https://github.com/Felo-Inc/memclaw.git
# 然後複製 memclaw/memclaw 到 ~/.claude/skills/ 或 ~/.gemini/skills/

基本使用：

# 建立工作區
> 建立一個叫做 ecommerce-api 的工作區

# 載入工作區（隔天回來時）
> 載入 ecommerce-api 工作區

# Claude 自動讀取工作區內容，8 秒後：
# "好的，我已經載入 ecommerce-api 工作區。目前進度：
#  API 層完成 80%，剩下 payment 和 notification 兩個 endpoint。
#  上次決定用 Stripe 做金流串接，webhook 驗證用 signature 比對。
#  待辦：前端購物車元件還沒開始。"

不用手動貼任何東西。工作區裡有 Living README（自動更新的專案摘要）、Artifacts（保存的文件和決策記錄）、Tasks（待辦事項追蹤）。

多專案切換：

> 載入 client-acme 工作區
# （處理 Acme 客戶的需求）

> 載入 client-beta 工作區
# （切換到 Beta 客戶，完全不同的脈絡）

> 載入 side-project 工作區
# （週末的 side project）

每個工作區完全隔離。Acme 的技術決策不會跑進 Beta 的對話裡。

而且 MemClaw 支援跨 agent 使用——如果你同時用 OpenClaw 和 Claude Code，兩邊共享同一個工作區。在 OpenClaw 做的研究，Claude Code 也看得到。

免費開始使用 MemClaw → memclaw.me

---

實戰工作流程：把所有技巧串起來

以下是一個結合上述所有技巧的日常開發流程：

1. Session 開始（2 分鐘）

cd ~/projects/ecommerce-api
claude

> 載入 ecommerce-api 工作區

Claude 讀取 CLAUDE.md（專案規範）+ MemClaw 工作區（動態脈絡）。你不用解釋任何背景。

2. 開發工作（主要時間）

> 接續上次的進度，幫我實作 payment endpoint
> 用 Stripe SDK，webhook 驗證用 signature 比對（這是上次決定的）

Claude 知道你上次決定用 Stripe，知道驗證方式，直接開始寫程式碼。

3. 測試與修正

> 跑一下 payment 相關的測試
> 這個測試失敗了，幫我看看是什麼問題

4. Session 結束（1 分鐘）

> 把今天的進度更新到工作區
> commit 今天的改動

MemClaw 自動記錄進度，下次回來時 Claude 就知道 payment endpoint 已經完成了。

---

常見問題與疑難排解

Claude Code 回應很慢怎麼辦？

• 確認網路連線穩定
• 用 /compact 壓縮過長的對話歷史
• 大型專案可以在 CLAUDE.md 中指定 Claude 不需要讀取的目錄（如 node_modules、dist）

API 用量太高怎麼控制？

> /cost

查看目前 session 的 token 用量。幾個省錢技巧：

• 用 /compact 定期壓縮對話
• 單次指令模式（claude -p）比互動模式省 token
• 在 CLAUDE.md 中寫清楚規範，減少來回溝通

Claude Code 可以用中文嗎？

可以。Claude Code 支援中文指令和回應。你可以用繁體中文跟它對話，它會用繁體中文回覆。程式碼註解也可以要求用中文撰寫。

跟 VS Code 怎麼搭配？

Claude Code 是獨立的 CLI 工具，跟 VS Code 不衝突。常見的搭配方式：

• VS Code 開著程式碼，Claude Code 在旁邊的終端機視窗
• 用 VS Code 的整合終端機直接跑 Claude Code
• Claude Code 修改檔案後，VS Code 會自動偵測變更

團隊裡其他人也想用怎麼辦？

每個人需要自己的 Anthropic API key。CLAUDE.md 可以 commit 到 git repo 裡，整個團隊共享同一份專案規範。如果需要共享專案記憶（決策記錄、進度追蹤），可以用 MemClaw 的團隊功能邀請隊友加入同一個工作區。（英文版，繁中版即將推出）

---

總結與下一步

Claude Code 不只是一個聊天機器人。它是一個能讀取你的程式碼、執行指令、修改檔案的 AI agent。搭配 CLAUDE.md 做靜態配置、MCP 串接外部工具、MemClaw 管理跨 session 記憶，它就是一個完整的 AI 開發工作流程。

從這裡開始：

1. 安裝 Claude Code 並設定 API key
2. 在專案根目錄建立 CLAUDE.md
3. 安裝 MemClaw 解決跨 session 記憶問題——兩分鐘搞定，免費開始

延伸閱讀：

• 內鏈: Claude Code 外掛生態完整指南——10 個提升開發效率的必裝外掛
• 內鏈: Cursor vs Claude Code：台灣開發者該選哪個？
• 為什麼 Claude Code 一直忘東忘西？台灣工程師花兩週搞清楚的這件事
• MemClaw 安裝完整教學——Claude Code / OpenClaw 5 分鐘啟動 AI 專案記憶