精選 Fundamentals Claude Code Tutorial

Claude Code 完整指南：從安裝到進階工作流程

精簡版 Claude Code 入門導覽，已對照 2.1.305 核實。涵蓋安裝、第一次工作階段、CLAUDE.md、Hooks、MCP 與自訂 Agents，並連結到更深入的 2026 版完整指南。

• 更新於 • 15 分鐘閱讀 • 作者：Claude World

2026 年 10 月 21 日更新： 依 Claude Code 2.1.305 校正系統需求、安裝方式與登入流程，將 $CLAUDE_FILE_PATHS hook 與不存在的 memory MCP 套件改為可運作的範例，更新 subagent 與 skill 的檔案格式，補上 session 現在預設以 auto 權限模式啟動，並把模型建議更新為 Haiku 5.5／Sonnet 5.5／Opus 5.5／Fable 5.1。

建議先讀這篇：Claude Code 完整指南 2026 是這份教學的最新、更深入版本，完整涵蓋 Hooks、MCP、Director Mode 與成本章節。本頁保留為簡短的入門導覽，需要深入內容時請循下方連結前往。

這是一份精簡的 Claude Code 入門導覽。無論你是 AI 輔助開發的新手，還是想精通進階功能，本指南都能帶你快速上手，並指向各主題的深入說明。

什麼是 Claude Code？

Claude Code 是 Anthropic 官方推出的 AI 程式設計助理。它與其他工具的差異在於：

  • 終端機原生：在終端機中運行，也支援 VS Code、桌面應用程式與網頁版
  • 專案級理解：依任務需要讀取程式碼庫中的檔案，而非只看開啟中的檔案
  • Agent 架構：能自主執行任務，不只是回答問題

為何選擇 Claude Code？

功能Claude CodeCursorGitHub Copilot
介面終端機IDE編輯器外掛
自主性高（Agent）中低
客製化程度非常高中低
最適合複雜任務、自動化偏好 GUI簡單補全

如果你熱愛終端機、追求最大控制權，且需要處理複雜任務，Claude Code 是你的最佳選擇。

安裝與設定

系統需求

  • macOS：13.0 以上
  • Windows：Windows 10 1809+ 或 Windows Server 2019+（建議但非必要安裝 Git for Windows）
  • Linux：Ubuntu 20.04+ / Debian 10+ / Alpine Linux 3.19+
  • 硬體：4 GB 以上記憶體，x64 或 ARM64
  • 方案：Claude Pro、Max、Team 或 Enterprise 訂閱、Claude Console 帳號，或透過支援的雲端供應商存取

安裝方式

方式一：原生安裝程式（建議）

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

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

原生安裝會在背景自動更新。

方式二：Homebrew、WinGet 或 npm

# Homebrew（macOS/Linux）- 不會自動更新
brew install --cask claude-code

# WinGet（Windows）- 不會自動更新
winget install Anthropic.ClaudeCode

# npm - 需要 Node.js 22+，請勿使用 sudo
npm install -g @anthropic-ai/claude-code

初次設定

安裝完成後，執行：

claude

首次執行會引導你完成以下步驟：

  1. 身份驗證：在瀏覽器中以 Claude 訂閱或 Claude Console 帳號登入（也可執行 claude auth login）
  2. 權限設定：決定 Claude 可以執行哪些操作

Claude.ai 免費方案不含 Claude Code。若要改用 API 計費，請執行 claude auth login --console 或設定 ANTHROPIC_API_KEY。

驗證安裝

claude --version
# 顯示已安裝的版本，例如 2.1.305

claude doctor
# 唯讀的安裝與設定診斷，不會啟動 session

基本使用

開始對話

在任意專案目錄執行：

cd /path/to/your/project
claude

Claude Code 不會預先索引整個儲存庫，而是載入你的 CLAUDE.md（或 AGENTS.md）與 git 狀態，再依任務需要讀取檔案。

基本指令

指令功能
claude啟動互動式對話
claude "做某件事"以初始提示啟動 session
claude -p "做某件事"單次執行（print 模式）後結束
claude --help查看所有選項
/help對話中取得說明
/clear清除對話歷史
Ctrl+C中斷目前操作；在空白提示列再按一次即可離開
/exit退出 Claude

對話模式

在對話中，用自然語言描述任務：

你：在 src/utils/ 建立一個日期格式化工具函式

Claude：我來建立那個工具函式...
[Claude 顯示要建立的檔案與內容，等待確認]

未設定權限模式時，終端機與 VS Code 的互動式 session 會以 auto 模式啟動，由分類器審查多數動作，不再每次詢問你。若要改變，請在設定中指定 permissions.defaultMode。

Plan Mode

按 Shift+Tab 循環切換權限模式直到進入 plan mode，或直接輸入 /plan：

你：/plan 實作使用者登入功能

Claude：讓我分析需求並規劃實作方式...
[Claude 研究程式碼庫、提出計劃，但不修改任何檔案]

Plan Mode 適合：複雜功能、不確定如何進行時

CLAUDE.md 設定

CLAUDE.md 是 Claude Code 最重要的設定檔。它告訴 Claude 你的專案規則。

建立 CLAUDE.md

在專案根目錄建立 CLAUDE.md：

# 專案名稱

## 技術棧
- Node.js + TypeScript
- React + Tailwind CSS
- PostgreSQL

## 開發規範
- 使用 pnpm 作為套件管理器
- 所有程式碼必須有 TypeScript 型別
- 提交前執行 `pnpm lint && pnpm test`

## 目錄結構
- `src/` - 主要原始碼
- `tests/` - 測試檔案
- `docs/` - 文件

## 禁止事項
- 不使用 any 型別
- 不刪除現有測試
- 不直接推送到 main 分支

快速初始化

使用內建指令自動產生：

claude
/init

Claude 會分析專案結構並產生適合的 CLAUDE.md。之後可用 /memory 調整，並以 /doctor prompt-audit 找出為舊模型撰寫的指示。

CLAUDE.md 位置

位置用途
project-root/CLAUDE.md專案專屬規則
~/.claude/CLAUDE.md個人全域規則
project-root/AGENTS.md專案沒有 CLAUDE.md 時改讀這個檔案

進階功能

1. Hooks（自動化觸發器）

Hooks 讓你在 Claude 生命週期的固定時點自動執行自己的指令。設定寫在 settings.json，每個 hook 會從 stdin 收到 JSON 格式的事件。

常見應用場景：

  • 編輯檔案後自動格式化
  • 每次修改後執行測試
  • 封鎖危險指令

設定範例（.claude/settings.json）：

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs pnpm lint --fix"
          }
        ]
      }
    ]
  }
}

在 session 中執行 /hooks 可查看已註冊的 hooks。

詳細指南：Claude Code Hooks 完整指南 · 更深入的範例見2026 年版

2. MCP（Model Context Protocol）

MCP 讓 Claude 連接外部工具與資料來源。

安裝範例：

# 遠端 HTTP 伺服器
claude mcp add --transport http notion https://mcp.notion.com/mcp

# 本機 stdio 伺服器
claude mcp add my-server -- node ./my-mcp-server/index.js

沒有 claude mcp install 這個指令。在 session 中執行 /mcp，或執行 claude mcp list，即可確認各伺服器是否連線成功。

詳細指南：Claude Code MCP 設定指南

3. 自訂 Agents

建立針對特定任務的專用 subagents。

建立方式：請 Claude 幫你寫，或自己建立檔案。/agents 現在只會提示你這麼做。

<!-- .claude/agents/code-reviewer.md -->
---
name: code-reviewer
description: Reviews code for bugs, security, and maintainability. Use after writing or modifying code.
tools: Read, Grep, Glob
model: sonnet
---

審查變更內容，回報正確性、安全性與可維護性問題。

放在 .claude/agents/ 代表只用於該專案，放在 ~/.claude/agents/ 則所有專案皆可使用。

詳細指南：Claude Code Agents 完整指南

4. 自訂 Skills

Skills 是可重複使用的指示，Claude 會在相關時自動載入，你也可以用 /名稱 直接呼叫。自訂 commands 已合併進 skills：.claude/commands/deploy.md 與 .claude/skills/deploy/SKILL.md 都會產生 /deploy。

建立方式：

建立 .claude/skills/deploy/SKILL.md：

---
description: Deploys to production. Use when the user asks to ship, release, or deploy.
---

執行以下部署步驟：
1. 執行測試
2. 建置專案
3. 部署到 Cloudflare Pages

使用方式：/deploy

詳細指南：Claude Code Skills 完整指南

最佳實踐

1. 保持 Context 乾淨

用 /context 查看是什麼佔滿了視窗，再用 /compact 或 /clear

舊的對話歷史會消耗 token，也可能讓 Claude 感到困惑。

2. 善用 Plan Mode

面對複雜任務，先進入 plan mode（/plan 或 Shift+Tab）
讓 Claude 充分研究後再採取行動

3. 給予明確的指示

不好的做法：「改善這個函式」

好的做法：「重構 calculateTotal 函式，改用 reduce 取代 for 迴圈，並加上 TypeScript 型別」

4. 採用測試驅動開發

你：先寫測試，確認測試失敗後，再實作功能讓測試通過

Claude 在有明確測試目標時表現最佳。

5. 善用內建工具

指令用途
/init初始化 CLAUDE.md
/context查看是什麼佔滿了 context 視窗
/usage查看 session 花費與方案額度（/cost 是別名）
/memory管理記憶
/model切換模型
/effort調整模型投入的推理程度

常見問題

Q：Claude 不執行我的指令？

A：檢查權限提示。Claude 會停在一個對話框，選項包括 Yes、Yes, and don’t ask again、Yes, and switch to auto mode 與 No。用方向鍵選擇後按 Enter。

Q：如何降低費用？

A：

  1. 用 /context 查看後，以 /compact 或 /clear 清掉不再需要的歷史
  2. 先規劃再執行（/plan）
  3. 簡單、機械性的任務改用 Haiku 5.5，任務不需要深度推理時調低 /effort

Q：Claude 產生的程式碼有錯誤？

A：

  1. 提供更多 context（相關檔案）
  2. 採用測試驅動開發
  3. 明確指出錯誤，讓 Claude 修復

Q：如何在團隊中使用？

A：

  1. 將 CLAUDE.md 納入版本控制
  2. 將 .claude/ 目錄納入版本控制（排除 settings.local.json）
  3. MCP 設定改用 project 範圍

Q：該選哪一個模型？

A：在 Anthropic API 上，haiku、sonnet、opus、fable 分別對應 Haiku 5.5、Sonnet 5.5、Opus 5.5 與 Fable 5.1。Opus 5.5 是 Pro、Max、Team 與 Enterprise 方案的預設模型；Fable 5.1 是能力最強的層級，但從不是預設。Opus 5.5、Sonnet 5.5 與 Haiku 5.5 預設以 medium effort 運作。其他供應商的部分別名仍指向較舊的模型。

Q：支援哪些程式語言？

A：Claude Code 支援所有主流程式語言，包括但不限於：

  • JavaScript/TypeScript
  • Python
  • Go
  • Rust
  • Java/Kotlin
  • C/C++
  • Swift
  • PHP
  • Ruby

下一步

恭喜完成 Claude Code 基礎學習！推薦延伸閱讀：

  1. Claude Code 完整指南 2026 - 這份教學的最新、更深入版本
  2. Hooks 完整指南 - 建立自動化工作流程
  3. MCP 設定指南 - 擴展 Claude 的能力
  4. Agents 完整指南 - 建立自訂 agents
  5. Director Mode 方法論 - 進階開發模式

相關資源

最後更新：2026-10-21