Claude Code 是 Anthropic 於 2025 年推出的命令列 AI 程式開發工具，讓開發者可以直接在終端機中與 Claude 協作寫程式。它不是一個 IDE，而是一個強大的終端機助手，能理解你的整個程式碼庫並協助完成各種開發任務。

這篇教學將從基礎安裝到進階技巧，帶你全面掌握 Claude Code 的使用方法。

一句話定義： Claude Code 是 Anthropic 於 2025 年推出的 agentic coding CLI 工具，讓開發者在終端機中以自然語言完成跨檔案程式碼修改、執行終端指令與自動化開發工作流，無需離開終端機環境。訂閱方案包括 API 按量計費（Claude Sonnet 約 $3/百萬 input tokens）、Pro（$20/月）與 Max（$100/月）三種選項。

什麼是 Claude Code？

Claude Code 是 Anthropic 推出的 CLI（命令列介面）工具，安裝後可以在終端機中直接與 Claude 互動。與 ChatGPT 網頁版不同，Claude Code 能夠：

• 直接讀取和修改你的本地檔案
• 理解整個專案的程式碼結構
• 執行終端機指令
• 自動化重複性的開發工作
• 透過 MCP 連接外部工具和服務

Claude Code 最大的特點是「agentic coding」——你只需要描述想做的事，Claude 會自動分析、規劃、執行。這讓它不只是一個「程式碼補全工具」，而是真正能幫你完成任務的 AI 夥伴。

Claude Code 的設計理念

Claude Code 的設計出發點是以終端機為核心的開發工作流。Anthropic 認為，最有生產力的開發者往往深度使用終端機。因此，Claude Code 不試圖取代 IDE，而是讓終端機本身變得更聰明。

與其他 AI 程式工具相比，Claude Code 強調三個核心特性：

1. 完整的專案理解：不只看當前開啟的檔案，而是理解整個 codebase 的結構和脈絡。
2. 真正的自主執行：可以自動規劃多個步驟並依序執行，不需要每一步都等你確認。
3. 安全的工具使用：所有涉及修改檔案或執行指令的操作，都會先向你確認。

Claude Code 的核心功能

智慧程式碼編輯

Claude Code 可以理解你的專案上下文，進行跨檔案的修改。例如你可以說「把所有 API 端點從 REST 改成 GraphQL」，Claude 會自動找到所有相關檔案並逐一修改。

這個能力在大型專案中特別有用。傳統的 IDE 搜尋替換只能處理文字層面的替換，但 Claude Code 理解程式碼的語意——它知道哪些部分需要改、哪些不需要改，並且會同步更新測試檔案和相關文件。

終端機整合

你可以請 Claude Code 執行任何終端機指令，包括：

1. 執行測試 npm test
2. 建置專案 npm run build
3. Git 操作 git commit、git push
4. 安裝套件 npm install
5. Docker 容器管理
6. 資料庫遷移指令

Claude Code 執行指令後，會讀取輸出結果並根據結果決定下一步。如果測試失敗，它會分析錯誤訊息、找出原因、修正程式碼，然後重新執行測試——這個循環會一直持續到測試通過為止。

MCP 整合

Claude Code 支援 Model Context Protocol (MCP)，可以連接外部工具和服務：

• 資料庫：直接查詢和修改 PostgreSQL、MySQL、SQLite
• 瀏覽器：透過 Playwright 進行網頁操作和測試
• API 服務：連接 Slack、GitHub、Jira 等平台
• 向量資料庫：搜尋大型知識庫

MCP 讓 Claude Code 的能力從「寫程式」延伸到「與整個開發生態系統互動」。

多模態支援

Claude Code 支援圖片輸入，這在前端開發中特別實用。你可以：

• 截圖一個設計稿，讓 Claude Code 幫你實作成 React 元件
• 拍下手繪的資料流程圖，讓它生成對應的程式碼架構
• 截圖 bug 的錯誤畫面，讓它分析問題所在

如何安裝 Claude Code

系統需求

在安裝 Claude Code 之前，確認你的系統符合以下要求：

• Node.js：版本 18 或以上
• 作業系統：macOS、Linux、Windows（WSL 環境建議）
• Anthropic 帳號：需要 API 金鑰或 Pro/Max 訂閱

安裝步驟

# 使用 npm 全域安裝
npm install -g @anthropic-ai/claude-code
進入你的專案目錄
cd your-project
啟動 Claude Code
claude

安裝完成後，第一次執行 claude 時，它會引導你完成 API 金鑰設定。你可以選擇：

1. 直接輸入 API 金鑰：前往 console.anthropic.com 取得
2. 使用 Claude.ai 帳號登入：如果你有 Pro 或 Max 方案

驗證安裝

# 確認安裝成功
claude --version
啟動互動模式
claude
或直接執行單次指令
claude -p "列出這個目錄的所有 TypeScript 檔案"

設定 CLAUDE.md

這是許多人忽略但非常重要的步驟。在你的專案根目錄建立 CLAUDE.md 檔案，告訴 Claude 這個專案的基本資訊：

# 專案名稱
技術棧

Next.js 15 + TypeScript
PostgreSQL + Prisma
Tailwind CSS

開發規範

使用 ES modules（import/export）
變數命名：camelCase
元件：PascalCase
API 路由：kebab-case

常用指令

npm run dev — 開發伺服器
npm run build — 建置
npm test — 執行測試

Claude Code 每次啟動時都會自動讀取 CLAUDE.md，確保它的行為符合你的專案需求。

Claude Code 定價：各方案比較

方案選項

Claude Code 有幾種使用方式，適合不同需求：

API 按量計費

• 直接使用 Anthropic API
• 適合：個人開發者、輕度使用者
• 費用：依 token 使用量計算（Claude Sonnet 4.5 約 $3/百萬 input token）
• 彈性最高，但重度使用費用不可控

Claude Pro（$20/月）

• 含 Claude.ai 網頁版 + Claude Code 使用額度
• 適合：每天中度使用的個人開發者
• 包含 Claude Code 的基本使用量
• 超過額度後需等待下個計費週期或升級

Claude Max（$100/月）

• 大幅提升的使用額度（約 5 倍 Pro 方案）
• 適合：全職使用 Claude Code 的開發者
• 包含 Projects 功能（長期記憶）
• 最適合需要處理大型專案的工程師

Teams/Enterprise

• 團隊協作功能
• 統一計費管理
• 企業級 SSO 和安全功能

費用控制建議

如果使用 API 計費，幾個省錢技巧：

1. 善用 --model 指定較便宜的模型執行簡單任務
2. 善用 CLAUDE.md 讓 Claude 少問問題，減少來回溝通
3. 一次描述清楚任務需求，避免多輪修正

基礎使用教學

互動模式 vs 單次指令

Claude Code 有兩種主要使用方式：

互動模式（REPL）

claude
進入互動介面，可以持續對話

單次指令模式

claude -p "解釋 auth.ts 這個檔案的作用"

互動模式適合需要來回溝通的複雜任務；單次指令模式適合整合到腳本或 CI/CD pipeline 中。

常用操作範例

修 Bug

> 幫我找出 login 頁面的 bug 並修復

Claude 會自動掃描相關檔案、找出問題、提出修復方案並直接修改。

建立新功能

> 幫我建立一個使用者儀表板頁面，包含最近活動和統計圖表

Claude 會規劃架構、建立元件、串接 API、加入樣式，一氣呵成。

Code Review

> 審查 PR #123 的改動，特別注意安全性和效能問題

撰寫測試

> 為 UserService 類別撰寫完整的單元測試

重構程式碼

> 把 utils.ts 裡重複的邏輯提取成可複用的 helper function

Slash Commands（斜線指令）

Claude Code 內建多個實用的斜線指令：

| 指令 | 功能 |

|------|------|

| /help | 查看所有可用指令 |

| /clear | 清除對話記錄，重新開始 |

| /compact | 壓縮對話記錄，節省 context 空間 |

| /status | 查看目前的 token 使用量 |

| /review | 審查當前的 Git diff |

| /commit | 自動生成 commit message 並 commit |

| /init | 初始化 CLAUDE.md 設定檔 |

| /fast | 切換到快速模式（速度更快，回應可能較簡短） |

進階技巧：讓 Claude Code 發揮最大效益

善用 CLAUDE.md 分層設定

CLAUDE.md 支援多層結構，你可以在不同目錄層級放置不同的設定：

專案根目錄/
├── CLAUDE.md          ← 整個專案的全局設定
├── src/
│   ├── CLAUDE.md      ← src 目錄的特定規範
│   └── api/
│       └── CLAUDE.md  ← API 模組的特定說明

Claude Code 會自動合併所有層級的 CLAUDE.md 內容。這對大型單體應用（monorepo）特別有用——不同子模組可以有各自的開發規範和說明。

CLAUDE.md 的黃金內容：

## 絕對不可以做的事

不可以直接修改 migrations/ 目錄
不可以刪除任何測試檔案
不可以 commit 包含 API 金鑰的檔案

環境說明

本地開發：localhost:3000
資料庫：PostgreSQL 15（本地 Docker）
環境變數在 .env.local（不 commit）

這個專案的特殊架構決策

我們用 Repository Pattern 隔離資料存取層
所有 API 回應都用 Result<T, E> 類型包裝
不使用 React Query，改用自製的 useFetch hook

權限模式設定

Claude Code 提供幾種權限模式，適合不同情境：

預設模式：每次修改檔案或執行指令前都會詢問你是否同意。

自動接受模式：加上 --dangerously-skip-permissions 旗標可以跳過確認步驟（適合在 CI/CD 環境中使用，但要小心）。

唯讀模式：加上 --no-tools 旗標讓 Claude Code 只能閱讀和分析，不能修改任何東西——適合只想要程式碼解釋和建議的情境。

Hooks 自動化

Claude Code 支援 Hooks 機制，讓你可以在特定事件發生時自動執行腳本。在 ~/.claude/settings.json 設定：

{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit",
"hooks": [
{
"type": "command",
"command": "npm run lint --fix"
}
]
}
]
}
}

這個設定會在每次 Claude Code 修改檔案後，自動執行 lint 修復。常見的 Hooks 應用：

• 每次修改後自動格式化：prettier --write
• 每次新增檔案後自動更新索引：更新路由或 barrel file
• 每次 commit 前自動執行測試：確保不會 commit 壞掉的程式碼

與 Git 深度整合

Claude Code 對 Git 工作流有很好的支援：

# 讓 Claude 幫你寫 commit message
> 根據這次的改動寫一個清楚的 commit message 並 commit
讓 Claude 幫你 review PR
> 審查 git diff main..feature-branch 的所有改動，找出潛在問題
讓 Claude 幫你解決 merge conflict
> 幫我解決 src/auth.ts 的 merge conflict，保留最新的邏輯

使用 Sub-agents 處理複雜任務

Claude Code 內建 Agent 工具，可以把複雜任務拆分給多個子 agent 平行處理：

> 幫我對這個專案做完整的 code review：

一個 agent 負責安全性審查（SQL injection、XSS 等）
一個 agent 負責效能問題
一個 agent 負責程式碼品質和可維護性

這樣可以大幅縮短大型專案的審查時間。

實際使用場景

場景一：日常開發工作流

一個典型的使用日是這樣的：

早上：讓 Claude Code 回顧昨天的 commits，列出今天需要繼續的工作。

> 看一下最近三天的 git log，告訴我目前進行中的功能和未完成的 TODO

開發中：遇到不熟悉的 API 或框架，直接問。

> 我想在 Next.js 15 裡實作 Optimistic Updates，給我一個適合這個專案架構的實作方式

收尾時：讓 Claude 幫你整理當天的工作。

> 幫我整理今天所有的改動，寫成清楚的 commit 並 push

場景二：大型重構

重構是 Claude Code 最能發揮威力的場景之一。

範例：將 Callback 風格改成 Async/Await

> 把整個 src/services/ 目錄裡的 callback 風格全部改成 async/await，
確保錯誤處理也一併更新，並跑測試確認沒有 regression

Claude Code 會：

1. 掃描所有相關檔案
2. 識別需要修改的地方
3. 逐一修改並確保一致性
4. 執行測試確認無誤
5. 生成清楚的 commit message

範例：將舊版 API 升級

> 我們需要把 axios 全部換成原生 fetch API，同時保持所有現有功能正常

場景三：緊急 Bug 修復

線上出問題時，時間就是金錢。Claude Code 的快速診斷能力非常有用：

> 生產環境剛收到這個錯誤：
TypeError: Cannot read property 'userId' of undefined
at UserController.getProfile (controllers/user.js:45)
幫我找出原因並修復，要確保不影響其他功能

Claude Code 會追蹤程式碼流程、找出 null reference 的根本原因，而不是只加一個 if (obj) 的表面修復。

場景四：文件和測試補全

很多開發者最不喜歡寫的就是測試和文件。Claude Code 可以大幅降低這個痛苦：

補齊測試覆蓋率

> 分析 src/lib/ 目錄，找出測試覆蓋率低於 80% 的模組，
優先為最重要的函數補充單元測試

生成 API 文件

> 根據 routes/ 目錄的所有 API 端點，生成 OpenAPI 3.0 的 spec 文件

補充程式碼註解

> 為 algorithm/ 目錄裡的複雜演算法加入 JSDoc 註解，
說明時間複雜度和使用範例

場景五：學習新技術

Claude Code 是學習新框架的絕佳夥伴。你不需要在瀏覽器和 IDE 之間切換：

> 我剛開始學 Rust，幫我用 Rust 重寫這個 Python 腳本，
並在程式碼裡加入詳細的中文說明，讓我理解每個語言特性

常見問題與解決方法

問題：Claude Code 一直問我確認，很煩

Claude Code 預設對所有工具使用都需要確認。如果你已經信任 Claude 的判斷，可以：

1. 在對話中說「接下來的操作都可以直接執行，不用每次問我」
2. 在 settings.json 設定特定操作的自動批准規則
3. 使用 --dangerously-skip-permissions 旗標（謹慎使用）

問題：Context 不夠用，Claude 忘記之前說的事

對話記錄過長時，Claude Code 可能無法記住所有內容。解決方法：

• 使用 /compact 壓縮對話記錄，保留重要資訊
• 使用 /clear 開始新對話，但先用 CLAUDE.md 記錄重要背景
• 使用 Projects 功能（Claude Max 方案）建立持久的專案記憶

問題：Claude Code 修改了不該改的檔案

在 CLAUDE.md 明確列出禁止修改的目錄：

## 禁止修改的檔案

database/migrations/ — 只有 DBA 可以修改
config/production.json — 只在部署時修改
CHANGELOG.md — 由 CI/CD 自動更新

問題：API 費用高於預期

幾個降低費用的方法：

1. 一次描述清楚：避免需要多輪修正的模糊指令
2. 使用較輕量的模型：簡單任務用 --model claude-haiku-4-5 而不是 Sonnet
3. 善用 /compact：定期壓縮對話，減少不必要的 context 傳輸
4. 升級到 Max 方案：如果每月 API 費用超過 $100，Max 方案反而更划算

問題：在 Windows 上無法正常運作

Claude Code 對 Windows 原生支援有限，建議：

1. 使用 WSL 2（Windows Subsystem for Linux）
2. 在 WSL Ubuntu 環境中安裝和使用 Claude Code
3. 確保 Windows Terminal 設定使用 WSL 作為預設 shell

Claude Code vs Cursor vs GitHub Copilot 深度比較

| 功能 | Claude Code | Cursor | GitHub Copilot |

|------|------------|--------|----------------|

| 介面 | 終端機 CLI | 完整 IDE（VS Code 基礎） | IDE 外掛 |

| 自主性 | 高（agentic） | 中高 | 中 |

| 檔案操作 | 可直接修改多檔案 | 可直接修改 | 僅建議 |

| 終端機指令 | 可執行 | 可執行 | 不可 |

| MCP 支援 | 原生支援 | 有限支援 | 不支援 |

| 最強模型 | Claude Sonnet 4.6 / Opus 4.6 | GPT-4o / Claude | GPT-4o |

| 程式碼補全 | 無（需手動觸發） | 有（即時補全） | 有（即時補全） |

| 多檔案理解 | 極強 | 強 | 中 |

| 學習曲線 | 中（需熟悉 CLI） | 低（熟悉 VS Code 就會） | 低 |

| 價格 | API 計費 or $20/$100/月 | $20/月起 | $10/月起 |

| 最適合 | 終端機重度使用者 | 想要 AI IDE 的人 | 已有 IDE 使用者 |

三個工具的最佳使用情境

選 Claude Code 如果你：

• 大部分時間在終端機工作
• 需要大量的跨檔案重構
• 想要自動化複雜的開發工作流
• 有 MCP 整合需求
• 不喜歡被 GUI 工具綁定

選 Cursor 如果你：

• 習慣使用 VS Code 的視覺介面
• 需要即時程式碼補全（Claude Code 沒有這個功能）
• 想要一個「全包」的 AI IDE 體驗
• 不熟悉 CLI 操作

選 GitHub Copilot 如果你：

• 已有 GitHub Enterprise 訂閱（通常包含 Copilot）
• 使用 JetBrains IDE（不支援 Cursor）
• 只需要基本的程式碼補全和簡單問答
• 公司有統一規定使用的工具

可以同時使用嗎？

可以！很多開發者會同時使用 Claude Code 和 Cursor：

• Cursor：在 IDE 裡面做日常編輯和即時補全
• Claude Code：處理複雜的多步驟任務、重構、自動化腳本

這兩個工具是互補關係，不是競爭關係。

Claude Code 適合哪些人？

最適合

• 全端開發者：需要在前端、後端、資料庫之間頻繁切換
• DevOps 工程師：大量使用終端機和腳本
• 獨立開發者：需要用最少人力完成最多工作
• 技術 Lead：需要快速理解並審查他人的程式碼
• 新創團隊：用 AI 擴大小團隊的產出能力

可能不適合

• 完全不熟悉 CLI 的開發者：建議先從 Cursor 入門
• 需要即時程式碼補全：Claude Code 目前沒有這個功能
• 輕度使用者：如果一週只用幾次，Copilot 的 $10/月 可能更划算

總結

Claude Code 是目前 agentic coding 最成熟的工具之一。它的核心優勢在於真正理解整個專案並自主完成複雜任務，而不只是幫你補全下一行程式碼。

如果你願意花一點時間設定好 CLAUDE.md 並適應 CLI 工作流，Claude Code 能夠大幅提升你的開發效率——尤其是在處理重構、測試撰寫、和複雜 bug 追蹤等讓開發者最頭痛的任務上。

入門建議：先在一個小型側專案上試用一週，感受 agentic coding 的工作方式。一旦習慣了，你可能就回不去了。