Claude Code 完整教學 2026 最新

Claude Code 完整教學 2026：
進階 Prompt 技巧、費用最佳化、
MCP 配置台灣指南

你裝了 Claude Code，跑了幾次，覺得「還行」——但沒感受到傳說中的威力。問題通常不在工具，在用法。這篇從 CLAUDE.md 設計、進階 Prompt 架構、費用控制到 MCP 整合，把 Claude Code 2026 用到極致的方法全部拆開講。

📅 2026-05-23 ⏱ 閱讀約 12 分鐘 🏷 Claude Code・MCP・Prompt 工程・費用優化

🚀 安裝與基本設定（2026 最新版）

Claude Code 需要 Node.js 18+ 和有效的 Anthropic API Key。2026 年起，Claude Code 整合進 Anthropic Max 訂閱（$100/月 或 $200/月），訂閱者可直接使用無需另付 API 費用（有 rate limit）。

# 安裝 Claude Code
npm install -g @anthropic-ai/claude-code
# 設定 API Key（建議寫進 ~/.bashrc 或 ~/.zshrc）
export ANTHROPIC_API_KEY="sk-ant-xxxx"
# 啟動（在你的專案目錄下）
cd ~/your-project && claude
# 進入 Max 訂閱模式（不消耗 API Token）
claude --login
💡 2026 新功能： Claude Code 支援 --model 指定模型（claude-opus-4-6、claude-sonnet-4-6、claude-haiku-4）。日常開發推薦用 Sonnet 4.6（速度快、成本低）；複雜重構再切換 Opus 4.6。

📄 CLAUDE.md 進階設計：讓 AI 真正懂你的專案

CLAUDE.md 是 Claude Code 的靈魂文件。放在專案根目錄，每次啟動 Session 都自動載入。寫得好，Claude 就像接手你兩年的同事；寫得差，每次都要從頭解釋。

完整 CLAUDE.md 範本（後端 API 專案）

# CLAUDE.md — 專案指引

## 專案背景
台灣電商訂單管理 API，Node.js + Express + PostgreSQL 16。
服務 3 家連鎖藥局，每日約 50,000 次 API 請求。

## 技術棧
- Runtime: Node.js 22 LTS
- Framework: Express 5.x
- DB: PostgreSQL 16（TypeORM 0.3）
- Auth: JWT + Redis Session
- Test: Jest + Supertest
- CI/CD: GitHub Actions → Fly.io

## 程式碼規範
- TypeScript strict mode，所有函式需有型別標注
- 每個 API endpoint 必須有對應的 Jest 整合測試
- 錯誤處理：統一使用 AppError class，不 throw 裸字串
- DB query：一律透過 Repository 層，不在 Controller 直接操作

## 禁止觸碰（除非我明確說「修改 X 檔案」）
- src/migrations/* — 資料庫 migration 檔
- .env.production — 正式環境變數
- src/types/global.d.ts — 全域型別定義

## 常用指令
- npm run dev — 啟動開發伺服器（port 3000）
- npm test — 執行所有測試
- npm run migrate — 執行待處理 migrations

## 架構決策（ADR）
- 選用 TypeORM 而非 Prisma：因需動態查詢建構
- 不用 GraphQL：客戶端（藥局 POS 系統）不支援
- Redis 快取策略：訂單狀態 TTL 30s，產品資料 TTL 5min
🎯 進階技巧：多層 CLAUDE.md

子目錄也可以放 CLAUDE.md。例如 src/payments/CLAUDE.md 專門說明金流模組的規範。Claude Code 進入該目錄時，會同時載入根目錄和子目錄的 CLAUDE.md，讓指引更精準。

🧠 進階 Prompt 技巧：10 個讓輸出品質飛升的方法

技巧 1：「先想再做」——強制規劃階段

在複雜任務前加上 「先列出你要修改哪些檔案、為什麼，等我確認再動手」。這能防止 Claude 直接衝進去改了一大堆你不想動的地方。

❌ 壞：「重構 UserService」
✅ 好：「分析 UserService 的設計問題，列出你計劃改動的檔案和理由，等我確認才動手。」
技巧 2：指定輸出格式

明確告訴 Claude 你要什麼格式的輸出。對程式碼修改說「只輸出需要改動的函式，不要輸出整個檔案」；對分析說「用條列式，每項不超過 20 字」。

「找出 src/auth/ 下所有沒有錯誤處理的 async 函式，
只列出檔案名稱 + 行號 + 函式名稱，不需要其他解釋。」
技巧 3：角色扮演設定（一次性 System Prompt）

用 /system 指令設定當前 Session 的角色，比在每個 Prompt 重複說明更省 Token。

/system 你是一個台灣電商後端高級工程師，
熟悉 Node.js/PostgreSQL，回覆用繁體中文，
程式碼遵循 CLAUDE.md 的規範。
技巧 4：Context 注入——把相關程式碼餵進去

用 @filename 語法快速帶入檔案內容，或用 $(cat file.ts) 手動注入。不要讓 Claude 自己去猜檔案結構。

「參考 @src/orders/order.service.ts 的實作風格，
為 src/payments/ 寫一個類似的 payment.service.ts。」
技巧 5：增量確認工作流（防止「暴走」）

大型任務切成小步驟，每步確認再繼續。用「完成後跟我說，等我說 OK 再繼續下一步」來控制節奏，避免一次改太多導致難以審查。

技巧 6：TDD 驅動——先測試再實作

先叫 Claude 寫測試案例（你審查測試），再叫它「實作剛才那些測試」。這樣 Claude 的實作目標明確，輸出品質遠優於直接說「幫我實作功能 X」。

Step 1：「為退款功能寫 Jest 測試，包含：正常退款、金額超過原始訂單、重複退款三個 cases。先只寫測試，不實作。」
Step 2：（審查測試後）「OK，現在實作讓這些測試通過。」
技巧 7：要求解釋決策（加深理解）

在 Prompt 結尾加「並解釋你為什麼選擇這個方案，而不是其他替代方案」。不只讓你學習，也讓你發現 Claude 的假設是否符合你的需求。

技巧 8：負面指示（告訴 Claude 不要做什麼）

「不要用 any 型別」、「不要改測試檔」、「不要安裝新的套件」——這些負面指示往往比正面指示更有效，能排除你最常遇到的問題。

技巧 9：Bash Tool 搭配使用——讓 Claude 執行後驗證

允許 Claude Code 使用 Bash Tool，讓它自己跑 npm test 驗證修改是否通過。失敗時 Claude 會自動嘗試修正，形成「修改→測試→修正」的自動迴圈。

「修復 payment.service.ts 的型別錯誤，修完後跑 npm test，
確認所有測試通過，如果沒有自己修到通過為止。」
技巧 10：Compact 模式——管理長 Session 的 Context

長時間工作後，用 /compact 指令壓縮 Context，或用 /clear 清空重新開始。Context 過長會導致回應品質下降且費用暴增，定期清理是關鍵習慣。

📊

想系統學習 AI / Python / 機器學習？

DataCamp 提供最完整的數據科學與 AI 課程路徑，從 Python 基礎到 LLM 應用開發，台灣學習者最多選擇。

🚀 立即開始 DataCamp 免費試用 →

💰 費用最佳化：ccusage 監控 + 省錢策略

Claude Code 費用的最大殺手是：1. Context 窗口被塞滿後每次都帶著大量歷史；2. 不必要的長輸出；3. 用 Opus 做簡單任務。掌握這三點，費用可以砍半。

方案選擇：API vs Max 訂閱

方案 月費 適合誰 Cost/台幣
API Pay-as-you-go 依用量 輕度用戶，每月 < $30 彈性
Claude Pro $20 $20/月 Claude.ai 網頁使用者，不含 Claude Code API NT$650
Anthropic Max $100 $100/月 每月 API 消費約 $80-150，含 5x 用量 NT$3,250
Anthropic Max $200 $200/月 重度 Vibe Coding，每月 > $200 API 用量 NT$6,500

用 ccusage 監控費用

ccusage 是開源的 Claude Code 費用追蹤工具，讀取本地 Session 記錄，無需額外 API 就能看到每次對話的 Token 消耗和費用。

# 安裝 ccusage
npm install -g ccusage

# 查看今日費用
ccusage today

# 查看本週費用報表
ccusage week

# 設定每日費用警報（超過 $5 發出警告）
ccusage limit --daily 5

5 個省錢技巧

🔌 MCP 整合配置：GitHub、DB、Puppeteer 完整教學

MCP（Model Context Protocol）是 Claude Code 的超能力來源。透過 MCP 伺服器，Claude 可以直接操作 GitHub、查詢資料庫、控制瀏覽器，而不需要你複製貼上資料。

設定檔位置

# 全域設定（所有專案都能用）
~/.claude/claude_desktop_config.json

# 專案級設定（只有這個專案用）
./.claude/claude_desktop_config.json

常用 MCP 伺服器配置範本

{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxx"}
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres",
       "postgresql://user:pass@localhost:5432/mydb"]
},
"puppeteer": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-puppeteer"]
},
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem",
       "/Users/you/projects"]
}
}
}
🐙 GitHub MCP 用途
  • 直接讀取 PR / Issue 內容
  • 讓 Claude 自動建立 PR 草稿
  • 分析 commit 歷史找 bug 來源
  • 批次更新 Issue labels
🐘 PostgreSQL MCP 用途
  • Claude 直接查詢 schema 了解資料結構
  • 協助撰寫複雜 SQL 並驗證
  • Performance 分析與索引建議
  • 資料遷移腳本驗證
🎭 Puppeteer MCP 用途
  • E2E 測試自動撰寫與執行
  • 截圖比對 UI 回歸測試
  • 讓 Claude 視覺化驗證前端改動
  • Web scraping 腳本生成
☁️

部署 MCP 伺服器需要穩定雲端主機？

DigitalOcean Droplet 從 $6/月起，適合架設 Claude Code MCP Server、私有 AI 工具、n8n 自動化工作流。新戶享 $200 免費點數（60 天）。

🚀 獲得 $200 DigitalOcean 免費點數 →

⚙️ 進階工作流：Git Hooks、CI/CD、多 Agent 協作

Git Hooks 自動化

在 .git/hooks/pre-commit 加入 Claude Code，讓每次 commit 前自動審查：

#!/bin/bash
# .git/hooks/pre-commit

STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(ts|tsx|js|jsx)$')

if [ -n "$STAGED_FILES" ]; then
echo "$STAGED_FILES" | xargs claude --no-stream --print \
-p "快速審查這些檔案的變更，只回報：型別錯誤、明顯 bug、缺少錯誤處理。格式：[嚴重度] 檔案:行號 — 問題描述"
fi

GitHub Actions 整合

# .github/workflows/claude-review.yml
name: Claude Code Review
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm install -g @anthropic-ai/claude-code
- run: |
git diff origin/main...HEAD -- '*.ts' | claude --print \
-p "審查這個 PR 的 TypeScript 變更，提供改善建議"
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

多 Agent 並行工作流

2026 年的 Claude Code 支援 Sub-Agent 模式。讓一個 Claude 做「協調者」，同時派出多個 Claude 執行任務：

# 協調者 Prompt 範例
「我需要同時完成以下三件事：
1. 為 OrderService 撰寫單元測試
2. 為 PaymentService 補充 TypeDoc 文件
3. 分析 UserController 的效能瓶頸
請用 Task 工具平行執行這三件事，
完成後彙整結果報告給我。」

🇹🇼 台灣開發者 5 個實戰場景

🏥
場景 1：醫療 SaaS ─ HIPAA 合規程式碼審查
台北某醫療資訊新創，Node.js + PostgreSQL

問題：後端 API 有個人健康資訊（PHI），但工程師不熟悉 HIPAA 的程式碼合規要求。

「審查 src/patients/ 目錄下所有 API endpoints，
找出所有可能違反 HIPAA 的程式碼（logging PHI、
未加密傳輸、缺少存取控制），
給出具體修正建議和程式碼範例。」

成效：2 小時完成原本需要 2 天的合規審查，找出 7 個潛在違規點。

🛒
場景 2：電商平台 ─ LINE Bot 訂單自動化
台中某連鎖零售商，整合 LINE Pay + 訂單管理

需求：讓 LINE Bot 能接受訂單、查詢狀態、觸發退款，整合現有的 PostgreSQL 訂單資料庫。

MCP 配置：postgres（讀訂單 DB）+ GitHub（管 PR）
「根據 orders 和 products schema，
設計一個 LINE Webhook handler，
支援：查詢最近 5 筆訂單、更新訂單狀態、
觸發退款流程。用 TypeScript + Express 實作。」

成效：Claude 直接讀取 DB schema 建構精確 TypeScript 型別，省去文件翻譯時間，3 天完成原本 2 週的開發量。

🎮
場景 3：獨立遊戲開發 ─ Unity 腳本重構
台南獨立遊戲開發者，Unity C# 手機遊戲

問題：遊戲 MonoBehaviour 腳本爆炸性成長到 5,000 行，效能問題明顯，需要拆分重構。

「分析 Assets/Scripts/GameManager.cs，
識別違反單一責任原則的程式碼區塊，
提出重構計劃（不要直接改），
說明如何拆成 4-6 個職責清晰的腳本，
並預測對效能的改善幅度。」

成效：重構後幀率從平均 38FPS 提升到 58FPS，iOS 崩潰率下降 80%。

💳
場景 4：金融科技 ─ 自動化測試補全
新竹某 FinTech 新創，支付清算後端

需求：金管會要求測試覆蓋率達 85%，現有覆蓋率只有 42%，要在 1 週內補全。

「執行 npm run test:coverage 取得覆蓋率報告，
找出覆蓋率最低的 10 個函式，
為每個函式寫至少 3 個 Jest 測試（正常流、
邊界案例、錯誤案例），
目標讓整體覆蓋率提升到 85%。」

成效：4 天（而非 1 週）達成 87% 覆蓋率，通過金管會審查。

📚
場景 5：EdTech 新創 ─ 全端 Feature 快速開發
台北 EdTech，Next.js 14 + Supabase

需求：1 名工程師需要在 3 天內完成「學習進度追蹤 + 排行榜」功能，含前後端。

「根據現有的 Supabase schema（透過 postgres MCP），
設計並實作學習進度追蹤功能：
1. Supabase Edge Function 記錄課程完成事件
2. Next.js Server Component 顯示個人進度
3. Real-time 排行榜（用 Supabase Realtime）
先列計劃再動手，每個步驟完成後告訴我。」

成效：2.5 天完成，含完整測試。原本估算需要 2 週。

🎓

想系統學習 AI 開發與 Prompt 工程？

Hahow 好學校有台灣最多 AI 應用與程式設計課程，繁體中文授課，台灣講師，符合本地需求。

🚀 瀏覽 Hahow AI 課程 →

📊 vs Cursor / Windsurf / Gemini CLI 比較表

功能/工具 Claude Code Cursor Windsurf Gemini CLI
介面 Terminal CLI IDE IDE + Plugin Terminal CLI
免費方案 ❌（需 API Key） ✅ 有限制 ✅ 有限制 ✅ 1000次/日
MCP 整合 ⭐⭐⭐⭐⭐ ⭐⭐⭐⭐ ⭐⭐⭐ ⭐⭐⭐
CI/CD 整合 ⭐⭐⭐⭐⭐ ⭐⭐ ⭐⭐ ⭐⭐⭐⭐
GUI 視覺化 ❌ ✅ 完整 ✅ Codemaps ❌
Tab 自動補全 ❌ ✅ 最強 ✅ 良好 ❌
Context 長度 200K tokens 模型依賴 模型依賴 1M tokens
最低月費 按量計費 $20/月 $20/月 免費
最適合誰 後端/DevOps/腳本化 全端/IDE 重度用戶 多 IDE 工程師 Google 生態用戶
🏆 AI Tools TW 建議

不必二選一。最常見的組合是：Cursor（日常開發 + Tab 補全）+ Claude Code（複雜重構、CI/CD 整合、MCP 自動化）。Cursor 負責寫，Claude Code 負責查、測、審、自動化。兩者配合，效益遠超單用一個。

🖥️

需要高效能雲端主機跑 AI 工作流？

Cloudways 托管雲端主機，按需擴容、SSD 高速存取，適合跑 n8n、Claude Code MCP Server、Dify 等 AI 服務。新用戶首 3 個月享優惠。

🚀 查看 Cloudways 方案 →

❓ 常見問題 FAQ

Claude Code 每個月費用大概多少？ +

費用視用量而定：輕度使用（每日 20-50 次互動）約 $20-40/月；中度使用約 $50-100/月；重度 Vibe Coding 可達 $150-300/月。Anthropic Max $200/月訂閱提供 5 倍 API 用量，適合重度使用者。建議用 ccusage 或 claudoscope 監控每日消耗，設定 --max-tokens 上限控制成本。

CLAUDE.md 要怎麼寫？有沒有範本？ +

CLAUDE.md 放在專案根目錄，讓 Claude Code 每次 Session 自動載入。建議包含：專案背景、技術棧與版本、程式碼風格規範、禁止觸碰的檔案清單、常用指令、測試規範、架構決策說明。越具體越好，避免模糊指示。本文第二節有完整範本可以直接複製使用。

Claude Code 支援哪些 MCP 伺服器？ +

Claude Code 支援任何遵循 MCP 協議的伺服器。常用的有：GitHub MCP（讀寫 issue/PR）、Filesystem MCP（安全檔案存取）、PostgreSQL MCP（直接查 DB）、Puppeteer MCP（瀏覽器自動化）、Slack/Notion MCP（工作流整合）。設定放在 ~/.claude/claude_desktop_config.json 的 mcpServers 區塊。

Claude Code 和 Cursor / Windsurf 有什麼不同？ +

Claude Code 是純終端機 CLI 工具，無 GUI，適合喜歡 Terminal 工作流、需要腳本化或自動化的開發者。Cursor/Windsurf 是 IDE，提供視覺化介面、Tab 補全、Diff 預覽。Claude Code 的優勢是：任何編輯器都能配合使用、可整合進 CI/CD 管線、Git Hooks 自動化、MCP 生態最成熟。

Claude Code 可以在 Windows 上用嗎？ +

Claude Code 官方支援 macOS 和 Linux。Windows 用戶需透過 WSL2（Windows Subsystem for Linux）使用，體驗與 Linux 相近。建議安裝 Ubuntu 22.04 LTS WSL2 環境，再依官方文件安裝 Node.js 18+ 和 Claude Code npm 套件。

🎁

Claude Code 進階 Prompt 模板包 — 立即可用

50+ 個經過實戰驗證的 Claude Code Prompt 模板，涵蓋重構、測試、Code Review、MCP 設定。台灣工程師設計，直接套用。

🛍 取得 Claude Code Pack ($29) →

📚 延伸閱讀

💰 ccusage + Claudoscope 費用追蹤工具評測 🔓 OpenCode：153K⭐ 開源 Claude Code 替代方案 🤖 Gemini CLI 評測：免費 1M Context 終端機 AI ⚙️ n8n + Claude Code 進階教學 🏄 Windsurf Cascade 深度評測 2026 ☁️ Cursor Cloud Agents 評測 2026
← 所有評測
© 2026 AI Tools TW — 台灣 AI 工具評測站