Claude Code 怎麼用？AI 程式開發助理新手入門完整教學

Claude Code 是 Anthropic 推出的 AI 程式開發工具，讓開發者可以直接在終端機中與 Claude 協作寫程式。它不是一個 IDE，而是一個以終端機為核心的程式助手，能理解你的整個程式碼庫並協助完成各種開發任務；官方也提供 VS Code、JetBrains 擴充與桌面 App。

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

一句話定義： Claude Code 是 Anthropic 的代理式（agentic）程式開發工具，讓開發者用自然語言完成跨檔案程式碼修改、執行終端指令與自動化開發工作流。取得方式包括 API 按量計費（Claude Sonnet 5.5 每百萬 token 輸入 2 美元）、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 的設計出發點是以終端機為核心的開發工作流。官方文件也寫明，功能最完整的是 CLI 版本，腳本化與 Agent SDK 都只在 CLI 提供。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)，可以連接外部工具和服務。官方文件舉的例子包括 Linear、Notion、Google Drive，以及你自己的內部 API；另外也有官方的 Chrome 整合，讓 Claude 透過你已登入的瀏覽器測試網頁、填表單、讀取 console log。

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

多模態支援

Claude Code 支援圖片輸入：在終端機裡用 Ctrl+V（iTerm2 為 Cmd+V，Windows 與 WSL 為 Alt+V）貼上剪貼簿裡的圖片，提示裡會出現 [Image #N] 標記。這在前端開發中特別實用。你可以：

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

如何安裝 Claude Code

系統需求

官方列出的系統需求：

• 作業系統：macOS 13.0 以上、Windows 10 1809 以上或 Windows Server 2019 以上、Ubuntu 20.04 以上、Debian 10 以上、Alpine Linux 3.19 以上
• 硬體：4GB 以上記憶體，x64 或 ARM64 處理器
• 網路：需要網路連線
• 帳號：付費的 Claude 方案（Pro、Max、Team、Enterprise）或 Anthropic Console 帳號

原生安裝程式不需要另外準備 Node.js。

安裝步驟

# macOS、Linux、WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# 進入你的專案目錄
cd your-project

# 啟動 Claude Code
claude

也可以用 Homebrew（brew install --cask claude-code）或 WinGet（winget install Anthropic.ClaudeCode）安裝。習慣用 npm 的話，npm install -g @anthropic-ai/claude-code 也能裝，但需要 Node.js 22 以上，而且官方提醒不要用 sudo npm install -g。

安裝完成後，第一次執行 claude 時會提示你登入。你可以選擇：

1. 使用 Claude 帳號登入：如果你有 Pro、Max、Team 或 Enterprise 方案
2. 使用 API 金鑰：在 Claude Console 建立金鑰並設定為 ANTHROPIC_API_KEY 環境變數，Claude Code 詢問是否使用時同意即可

驗證安裝

# 確認安裝成功
claude --version

# 啟動互動模式
claude

# 或直接執行單次指令
claude -p "列出這個目錄的所有 TypeScript 檔案"

設定 CLAUDE.md

這是許多人忽略但非常重要的步驟。在你的專案根目錄建立 CLAUDE.md 檔案（也可以在 Claude Code 裡執行 /init 自動產生），告訴 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 按量計費

• 在 Claude Console 使用 Anthropic API
• 適合：需要整合到腳本、CI/CD 的開發者
• 費用：依 token 使用量計算（Claude Sonnet 5.5 每百萬 token 輸入 2 美元、輸出 10 美元）
• 彈性最高，但重度使用時費用要自己控管

Claude Pro（月繳每月 20 美元，年繳每月 17 美元）

• 包含 Claude 網頁版與 App，以及 Claude Code
• 適合：每天中度使用的個人開發者
• 達到用量上限時，可以等額度重置，或加購用量額度（usage credits）

Claude Max（每月 100 美元起）

• 可選擇 Pro 的 5 倍或 20 倍用量
• 適合：全職使用 Claude Code 的開發者
• 尖峰時段有優先存取

Team／Enterprise

• Team 方案適合 2 到 150 人，含集中帳務管理與 SSO
• Enterprise 另有 SCIM、稽核紀錄、角色權限等管理功能

費用控制建議

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

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

基礎使用教學

互動模式 vs 單次指令

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

互動模式（REPL）

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

單次指令模式

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

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

常用操作範例

修 Bug

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

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

建立新功能

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

Claude 會規劃架構、建立元件、串接 API、加入樣式。

Code Review

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

撰寫測試

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

重構程式碼

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

Slash Commands（斜線指令）

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

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

善用 CLAUDE.md 分層設定

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

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

官方文件說明，工作目錄以上各層的 CLAUDE.md 會在啟動時載入，子目錄裡的 CLAUDE.md 則在需要時才載入。這對大型單體應用（monorepo）特別有用——不同子模組可以有各自的開發規範和說明。另外，Claude Code 的 auto memory 會根據你的修正與偏好自己寫下筆記，可以用 /memory 查看與開關。

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 用「權限模式」決定哪些動作可以不經詢問直接執行，執行中按 Shift+Tab 就能切換：

Auto 模式：新版 Claude Code（v2.1.283 起）在終端機與 VS Code 啟動時的預設模式。由另一個分類模型在背景檢查每個動作，擋下超出你要求範圍、或看起來是被惡意內容誘導的操作。官方提醒它能減少確認提示，但不保證安全，敏感操作仍應自己審查。

Manual 模式（設定值為 default）：修改檔案、執行 shell 指令或連網前都會先問你，適合敏感工作。

Plan 模式：只讀檔案、探索專案並寫出計畫，不會修改原始碼，適合只想要程式碼解釋和建議的情境。

跳過所有確認：--dangerously-skip-permissions 等同 bypassPermissions 模式，官方建議只在隔離的容器或虛擬機中使用。

用 claude -p 或 Agent SDK 執行時，預設是 Manual 模式。

Hooks 自動化

Claude Code 支援 Hooks 機制，讓你可以在特定事件發生時自動執行腳本。在 ~/.claude/settings.json（套用到你所有專案）或專案的 .claude/settings.json（可提交進 repo）設定：

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

這個設定會在 Claude Code 編輯或寫入檔案成功後，自動執行 lint 修復。常見的 Hooks 應用：

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

與 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 支援 sub-agent：把專門的子任務交給另一個代理處理，再把結果帶回主對話。你可以這樣下指令：

> 幫我對這個專案做完整的 code review：
  1. 一個 agent 負責安全性審查（SQL injection、XSS 等）
  2. 一個 agent 負責效能問題
  3. 一個 agent 負責程式碼品質和可維護性

這樣可以把大型審查拆開處理。官方內建的 /simplify 也是用同樣的思路，讓四個審查代理平行檢查變更。

實際使用場景

場景一：日常開發工作流

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

早上：讓 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)
  
  幫我找出原因並修復，要確保不影響其他功能

在提示裡要求它找出根本原因、不要只加一個 if (obj) 的表面修復，Claude Code 會追蹤程式碼流程，找出 null reference 從哪裡來。

場景四：文件和測試補全

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

補齊測試覆蓋率

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

生成 API 文件

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

補充程式碼註解

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

場景五：學習新技術

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

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

常見問題與解決方法

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

你可能正在 Manual 模式。可以這樣處理：

1. 按 Shift+Tab 切換到 auto 或 acceptEdits 模式（acceptEdits 會自動放行檔案編輯與常見的檔案系統指令）
2. 用 /permissions 或 settings.json 設定特定操作的允許規則
3. 在隔離的容器或虛擬機中，才考慮使用 --dangerously-skip-permissions

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

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

• 使用 /compact 壓縮對話記錄，保留重要資訊
• 使用 /clear 開始新對話，但先用 CLAUDE.md 記錄重要背景
• 用 /context 查看上下文用量，找出佔空間的工具或記憶檔

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

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

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

CLAUDE.md 是給 Claude 的指示，要硬性禁止的話，可以再用 /permissions 設定拒絕規則。

問題：API 費用高於預期

幾個降低費用的方法：

1. 一次描述清楚：避免需要多輪修正的模糊指令
2. 使用較輕量的模型：簡單任務用 --model haiku，而不是預設的 Opus
3. 善用 /compact：定期壓縮對話，減少不必要的 context 傳輸
4. 用 /usage 追蹤：隨時查看工作階段的花費，再決定要不要改用固定月費的 Pro 或 Max 方案

問題：在 Windows 上要怎麼用？

Claude Code 可以直接在 Windows 上執行：

1. 在 PowerShell 或 CMD 執行官方安裝指令，不需要系統管理員權限
2. 沒有安裝 Git for Windows 時，Claude Code 會用 PowerShell 執行指令；安裝後則改用 Git Bash
3. 主要用 Linux 工具鏈，或需要沙盒功能時，改在 WSL 2 裡安裝與執行

Claude Code vs Cursor vs GitHub Copilot 深度比較

截至 2026 年 10 月，依各家官方方案頁與文件。

三個工具的最佳使用情境

選 Claude Code 如果你：

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

選 Cursor 如果你：

• 習慣在編輯器裡完成大部分工作
• 想要一個「全包」的 AI IDE 體驗
• 不熟悉 CLI 操作

選 GitHub Copilot 如果你：

• 想先用免費方案試試 AI 補全（Copilot Free 每月 2,000 次補全）
• 想留在原本的 IDE 裡
• 公司有統一規定使用的工具

可以同時使用嗎？

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

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

Claude Code 的 VS Code 擴充也能裝在 Cursor 裡，兩個工具是互補關係，不是競爭關係。

Claude Code 適合哪些人？

最適合

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

可能不適合

• 完全不熟悉 CLI 的開發者：可以先從桌面 App 或 VS Code 擴充開始
• 只需要即時程式碼補全：Claude Code 以任務為主，不是打字時的補全工具
• 輕度使用者：如果一週只用幾次，Copilot 的免費方案或每月 10 美元的 Pro 可能更划算

總結

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

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

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