Claude Code 完全攻略指南（2026 年 2 最新版）

Aiko · February 27, 2026, 9:17am

Claude Code 完全攻略指南（2026 年最新版）

從安裝到精通的一站式教學，涵蓋安裝、設定、CLAUDE.md、Plan Mode、MCP、Hooks、Agents、Plugins 等所有核心概念。

一、Claude Code 是什麼？

Claude Code 是 Anthropic 推出的終端原生 AI 編程助手，直接在你的終端機中運行，能夠理解你的整個程式碼庫並採取實際行動。它不是一般的程式碼補全工具，而是一個自主代理（Agent）系統，可以：

讀取檔案、撰寫程式碼、執行 shell 命令
管理 Git 工作流程（commit、branch、PR）
跨多檔案編輯與除錯
透過 MCP（Model Context Protocol）與外部工具整合
產生測試、撰寫文件、進行程式碼審查
啟動子代理進行平行處理

背後模型： Claude Code 目前運行於 Claude Opus 4.6 和 Sonnet 4.5/4.6，支援高達 100 萬 token 的上下文窗口（beta）。

二、方案與定價

方案	月費	說明
Pro	$20/月	有使用量限制，適合輕度使用
Max	$100/月	無限制使用，推薦日常開發者
Teams	按人計費	團隊協作功能
Enterprise	聯繫銷售	企業級部署
Console（API）	按用量計費	適合整合與自動化

Claude Code 不支援免費方案，至少需要 Pro 訂閱。也可透過 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 使用第三方 API。

三、系統需求

作業系統： macOS、Windows（原生或 WSL）、Linux
網路： 需要網際網路連線
Shell： Bash、Zsh、PowerShell 或 CMD
Windows 專屬： 需安裝 Git for Windows（內含 Git Bash）
Node.js： 原生安裝程式不需要 Node.js（npm 安裝已棄用）

四、安裝教學（2026 最新方法）

推薦方式：原生安裝程式（Native Installer）

這是官方推薦方式，無需 Node.js，自動更新。

macOS / Linux

curl -fsSL https://claude.ai/install.sh | bash

Windows（PowerShell）

irm https://claude.ai/install.ps1 | iex

Homebrew（macOS）

brew install anthropic/tap/claude-code

Windows Package Manager

winget install Anthropic.ClaudeCode

驗證安裝

claude --version

首次登入

claude

執行後會自動開啟瀏覽器進行 OAuth 認證，登入你的 Claude 帳號即可。

診斷工具

claude doctor

如果遇到任何問題，這個命令會檢測安裝類型、版本、PATH 設定等常見問題。

從 npm 遷移

如果你之前用 npm 安裝過，請遷移到原生安裝：

# 安裝原生版本
curl -fsSL https://claude.ai/install.sh | bash

# 移除舊的 npm 版本
npm uninstall -g @anthropic-ai/claude-code

Windows 常見問題

claude 不被識別為命令： 通常是 PATH 設定問題。關閉終端機重新開啟，或手動將 ~/.local/bin 加入 PATH。

Git Bash 找不到： 在 ~/.claude/settings.json 中設定 Git Bash 路徑。

五、三種使用介面

Claude Code 不只是 CLI 工具，你有三種使用方式：

介面	使用情境
CLI（終端）	深度編程、除錯、功能開發
Desktop App	獨立視窗，通用開發
Cloud（claude.ai）	瀏覽器或手機 App，構思與討論架構

三者共用同一個訂閱帳號。

六、CLAUDE.md — 你的專案指令檔

CLAUDE.md 是 Claude Code 最重要的功能之一。它是一個 Markdown 檔案，讓 Claude 了解你的專案脈絡、編碼規範和偏好。

放置位置與作用範圍

路徑	作用範圍
`~/.claude/CLAUDE.md`	全域，所有專案適用
`專案根目錄/CLAUDE.md`	僅該專案適用
`子目錄/CLAUDE.md`	僅在該目錄工作時載入

CLAUDE.md 範本

# 專案：我的電商平台

## 技術棧
- 前端：Astro + React
- 後端：Shopify Storefront API
- 部署：Cloudflare Workers
- 樣式：Tailwind CSS

## 編碼規範
- 使用 TypeScript，嚴格模式
- 元件使用函數式寫法，不用 class
- 所有 API 呼叫需要 try/catch 錯誤處理
- commit message 使用 conventional commits 格式

## 專案結構
- src/components/ — React 元件
- src/pages/ — Astro 頁面
- src/lib/ — 共用工具函式
- src/styles/ — 全域樣式

## 重要注意事項
- 不要修改 src/generated/ 目錄中的檔案
- 資料庫 migration 必須是可逆的
- 環境變數在 .env.example 中有範例

進階技巧

使用 @ 引用檔案（例如 @README.md#installation）
保持簡潔，Claude 會在每次對話中載入這些內容，佔用 context window
隨專案演進持續更新

七、Plan Mode — 先規劃再執行

Plan Mode 讓 Claude 在動手之前先思考與規劃，適合複雜任務。

啟動方式

在對話中輸入 /plan
啟動時加上參數：claude --permission-mode plan
使用快捷鍵 Shift+Tab 在 Plan Mode 和 Act Mode 之間切換

最佳實踐

複雜重構： 先用 Plan Mode 讓 Claude 分析影響範圍，確認方案後再切換到 Act Mode
架構設計： 讓 Claude 先產出設計文件，你審核後再開始實作
除錯： 先讓 Claude 分析問題根因，而非直接開始修改

八、常用斜線命令

命令	功能
`/help`	查看所有可用命令
`/plan`	進入計劃模式
`/compact`	壓縮對話，釋放 context window
`/resume`	恢復之前的對話
`/model`	切換模型
`/clear`	清除當前對話
`/bug`	回報問題給 Anthropic
`/rename`	重新命名對話（無參數自動產生名稱）
`/terminal-setup`	設定終端快捷鍵（如 Shift+Enter 換行）
`/config`	配置設定
`/plugin`	管理外掛
`/agents`	管理自訂代理
`/fast`	啟用快速模式（Opus 4.6 可用）
`/teleport`	遠端連線（claude.ai 訂閱者）

快捷鍵

快捷鍵	功能
`Shift+Tab`	切換 Plan / Act Mode
`Alt+P` (Mac: `Option+P`)	在提示中切換模型
`Esc`	中斷當前操作
`ALT+V`	在 Windows 貼上圖片

九、模型選擇

Claude Code 支援多種模型，可按需選擇：

模型	適用場景	特點
Sonnet 4.6（預設）	日常開發、功能實作、Bug 修復	速度快、性價比高、支援 100 萬 token
Opus 4.6	複雜推理、架構決策、安全分析	最強推理能力、最高品質
Haiku	快速探索、簡單任務	最快速度、最低成本

切換模型

# 啟動時指定
claude --model claude-opus-4-6
claude --model claude-sonnet-4-6

# 對話中切換
/model

# 使用別名
claude --model opus
claude --model sonnet

十、MCP（Model Context Protocol）— 擴展 Claude 的能力

MCP 是讓 Claude Code 連接外部工具和服務的協議。透過 MCP Server，Claude 可以存取資料庫、搜尋文件、操作瀏覽器等。

配置 MCP Server

在 ~/.claude/settings.json 中添加：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-filesystem-server", "/path/to/project"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-github"]
    }
  }
}

專案級 MCP 配置

在專案根目錄的 .claude/settings.json 中配置，團隊成員共享：

{
  "mcpServers": {
    "project-db": {
      "command": "npx",
      "args": ["-y", "mcp-server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

十一、Hooks — 自動化工作流程

Hooks 是在 Claude Code 生命週期特定時刻自動執行的 shell 命令或 LLM 提示。

Hook 事件類型

事件	觸發時機
`SessionStart`	新對話或恢復對話時
`PreToolUse`	工具執行前（可攔截）
`PostToolUse`	工具執行後
`PostToolUseFailure`	工具執行失敗後
`Stop`	代理停止回應時
`PermissionRequest`	請求權限時

配置範例

在 ~/.claude/settings.json 中：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 ~/.claude/hooks/validate-bash.py"
          }
        ]
      }
    ],
    "SessionStart": [
      {
        "matcher": ".*",
        "hooks": [
          {
            "type": "command",
            "command": "echo '載入最新 Git 狀態...' && git log --oneline -5"
          }
        ]
      }
    ]
  }
}

實用 Hook 範例

防止提交敏感檔案：

#!/bin/bash
# .claude/hooks/pre-commit.sh
if git diff --cached --name-only | grep -qE '\.(env|key|pem)$|creds\.md'; then
  echo "⛔ 偵測到敏感檔案，已攔截提交"
  exit 1
fi

自動批准文件檔讀取：

#!/usr/bin/env python3
import json, sys
input_data = json.load(sys.stdin)
tool_name = input_data.get("tool_name", "")
tool_input = input_data.get("tool_input", {})

if tool_name == "Read":
    file_path = tool_input.get("file_path", "")
    if file_path.endswith((".md", ".txt", ".json")):
        print(json.dumps({"decision": "approve", "reason": "文件檔自動批准"}))
        sys.exit(0)
sys.exit(0)

十二、自訂 Agents — 打造你的 AI 團隊

Agents 是自訂的 AI 角色，每個 Agent 可以有不同的指令、工具集和模型。

建立 Agent

在 .claude/agents/ 目錄中建立 .md 檔案：

---
name: code-reviewer
description: "程式碼審查專家"
model: opus
tools:
  - Read
  - Grep
  - Glob
  - WebSearch
permissionMode: default
---

你是一位嚴格的程式碼審查專家。請審查程式碼時注意：
1. 安全漏洞
2. 效能問題
3. 程式碼風格一致性
4. 測試覆蓋率
5. 邏輯錯誤

使用繁體中文回覆。

Agent Teams（多代理協作）

Agent Teams 是進階功能，允許多個 Agent 平行協作：

# 需要啟用實驗性功能
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

主代理可以分派任務給子代理，各自在獨立的上下文中工作。例如：

主代理接收需求，拆分任務
數據代理負責 SQL 查詢和資料處理
前端代理負責 UI 元件開發
測試代理負責撰寫測試案例

十三、Plugins — 擴展生態系

Plugins 是 2026 年新增的功能，可安裝 LSP、MCP、Skills、Agents 和自訂 Hooks。

管理 Plugins

/plugin                    # 瀏覽與安裝
/plugin install <name>     # 安裝指定 Plugin
/plugin enable/disable     # 啟用/停用
/plugin marketplace        # 瀏覽市集
/plugin validate           # 驗證 Plugin 結構

團隊共享

將 Plugin 設定寫入 settings.json 並提交到版本控制，團隊成員自動取得相同的 Plugin 配置。

十四、Skills — Markdown 指令集

Skills 是 ~/.claude/skills/ 目錄中的 .md 檔案，無需 SDK 或 API，Claude Code 會在相關時自動遵循。

# ~/.claude/skills/tw-content.md

# 繁體中文內容撰寫規範

## 語言風格
- 使用繁體中文（台灣用語）
- 技術術語保留英文，後方括號加中文說明
- 避免使用簡體中文用語（如「軟件」→「軟體」）

## 格式要求
- Markdown 標題使用半形 # 號
- 清單項目使用半形 - 號
- 程式碼區塊標明語言類型

十五、權限與安全

權限模式

模式	說明
`default`	預設，敏感操作需確認
`acceptEdits`	自動接受檔案編輯
`plan`	僅規劃不執行
`bypassPermissions`	跳過所有權限（危險⚠️）

Sandbox 模式

Linux 和 macOS 支援沙箱模式，在隔離環境中執行命令，保護系統安全。

最佳安全實踐

使用 Hooks 攔截敏感操作
在 .claude/settings.json 中設定禁止的命令
重要專案啟用 Sandbox 模式
定期執行 claude doctor 檢查配置

十六、Settings 配置參考

配置檔位置

檔案	作用範圍
`~/.claude/settings.json`	全域設定
`.claude/settings.json`（專案目錄）	專案設定

完整設定範例

{
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": ["Read", "Glob", "Grep", "WebSearch"],
    "deny": ["Bash(rm -rf *)"]
  },
  "mcpServers": {},
  "hooks": {},
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6"
  }
}

十七、高效使用技巧

1. 並行開發

同時開啟多個 Claude Code 實例，在不同的 Git 分支上工作：

# 使用 Git Worktree 建立隔離工作目錄
git worktree add ../feature-a feature-a
git worktree add ../feature-b feature-b

# 各自開啟 Claude Code
cd ../feature-a && claude
cd ../feature-b && claude

2. 上下文管理

對話過長時使用 /compact 壓縮
善用 @ 引用特定檔案
將大任務拆成小步驟

3. 有效提示技巧

明確描述目標：「在 src/api/auth.ts 中新增 Google OAuth 登入功能」
提供限制條件：「不要修改現有的測試檔案」
指定輸出格式：「用 TypeScript 寫，加上 JSDoc 註解」
參考現有程式碼：「仿照 @src/api/email.ts 的風格」

4. 模型策略

Sonnet 4.6 作為預設，處理 80% 的日常任務
Opus 4.6 用於複雜架構決策、深度除錯
使用 Alt+P 在提示中即時切換模型

5. 終端設定

/terminal-setup    # 啟用 Shift+Enter 換行

6. Effort 調整

Claude Code 支援調整思考力度（effort level），在速度和品質之間取得平衡。

十八、常見工作流程

Bug 修復流程

1. claude                           # 啟動
2. 「src/api/users.ts 在使用者登出時會拋出 TypeError，請找出原因」
3. Claude 分析程式碼 → 找出問題 → 提出修復方案
4. 確認方案 → Claude 修改程式碼
5. 「請撰寫這個修復的測試案例」
6. Claude 撰寫測試 → 執行測試 → 確認通過
7. 「建立 commit，message 使用 fix: resolve TypeError on user logout」

新功能開發流程

1. 先進入 Plan Mode：/plan
2. 「我要在現有的電商平台加入商品評論功能，需要 API、資料庫 schema、前端元件」
3. 審核 Claude 的規劃
4. 切換到 Act Mode（Shift+Tab）
5. 「按照計劃開始實作，先從資料庫 schema 開始」
6. 逐步審核與調整

程式碼審查流程

1. 「審查 feature/payment-gateway 分支的所有變更」
2. Claude 讀取 diff → 分析每個檔案 → 指出潛在問題
3. 「修復你發現的問題，並解釋每個修改」

十九、進階主題

Headless 模式（CI/CD 整合）

# 在 CI 中使用，自動執行後退出
claude -p "執行所有測試並產出覆蓋率報告"

# 帶備用模型
claude -p --fallback-model claude-haiku-20240307 "分析程式碼品質"

遠端控制

claude remote-control    # 開啟本地環境供遠端存取

IDE 整合

Claude Code 支援 VS Code 擴展，提供：

在 IDE 終端中直接使用
分支搜尋和對話管理
OAuth 使用者可從 claude.ai 瀏覽和恢復對話

Auto Memories

Claude Code 現在會自動記錄和回憶工作中的重要資訊，跨對話保持上下文。

二十、疑難排解

問題	解決方案
安裝後找不到 `claude` 命令	重新開啟終端，或手動將 `~/.local/bin` 加入 PATH
OAuth 認證失敗	執行 `claude auth login` 重新認證
MCP Server 無法連線	執行 `/mcp reconnect` 或檢查 settings.json
記憶體使用過高	使用 `/compact` 壓縮對話，長時間對話記得定期清理
Windows 中文輸入法問題	已在近期更新修復日文 IME，中文 IME 類似處理
貼上圖片不工作（Windows）	使用 `ALT+V` 而非 `Ctrl+V`
全面診斷	執行 `claude doctor`

二十一、官方資源

資源	連結
官方文件	code.claude.com/docs
GitHub 倉庫	github.com/anthropics/claude-code
npm 套件（已棄用）	npmjs.com/package/@anthropic-ai/claude-code
Discord 社群	Claude Developers Discord
Awesome Claude Code	github.com/hesreallyhim/awesome-claude-code
Boris 的使用技巧	howborisusesclaudecode.com
Changelog	claudefa.st/blog/guide/changelog

二十二、快速上手清單

安裝 Claude Code：curl -fsSL https://claude.ai/install.sh | bash
執行 claude 完成 OAuth 登入
執行 claude doctor 確認一切正常
在專案根目錄建立 CLAUDE.md，描述專案背景和規範
學會使用 /plan、/compact、/resume 等核心命令
設定至少一個 MCP Server（推薦 Context7）
根據需求建立自訂 Agents
探索 /plugin marketplace 安裝實用外掛
在 settings.json 中配置你的偏好
開始用 Claude Code 重塑你的開發流程！

本指南更新於 2026 年 2 月，基於 Claude Code 最新版本撰寫。Claude Code 持續快速迭代，請定期查閱官方文件以獲取最新資訊。

MCP Server	功能
Context7	即時文件查詢，取代過時的訓練資料
Serena	語意級程式碼理解與導航
Playwright	AI 驅動的瀏覽器自動化與測試
GitHub	搜尋倉庫、管理 Issue 和 PR
Filesystem	安全的檔案系統存取
Memory	持久化記憶存儲