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

這是目前最完整的 Claude Code 教學。無論你是 AI 輔助開發的新手，還是想精通進階功能，本指南都能滿足你的需求。

什麼是 Claude Code？

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

終端機原生：在終端機中運行，不受限於特定編輯器
專案級理解：理解整個程式碼庫，而非只針對單一檔案
Agent 架構：能自主執行任務，不只是回答問題

為何選擇 Claude Code？

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

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

安裝與設定

系統需求

macOS：10.15 以上
Linux：Ubuntu 20.04+ / Debian 10+
Windows：Windows 10+（需要 WSL 或 Git for Windows）

安裝方式

方式一：官方安裝腳本（建議）

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

方式二：npm 安裝

# 需要 Node.js 18+
npm install -g @anthropic-ai/claude-code

初次設定

安裝完成後，執行：

claude

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

身份驗證：登入 Anthropic 帳號或輸入 API Key
方案選擇：Free / Pro / Max
權限設定：決定 Claude 可以執行哪些操作

驗證安裝

claude --version
# 應顯示版本號，例如：claude-code version 2.1.12

基本使用

開始對話

在任意專案目錄執行：

cd /path/to/your/project
claude

Claude 會自動掃描專案結構並建立理解。

基本指令

指令	功能
`claude`	啟動互動式對話
`claude "做某件事"`	單次任務執行
`claude --help`	查看所有選項
`/help`	對話中取得說明
`/clear`	清除對話歷史
`Ctrl+C`	中斷目前操作
兩次 `Escape`	退出 Claude

對話模式

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

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

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

Plan Mode

按下 Shift+Tab 進入 Plan Mode：

你：[Shift+Tab] 實作使用者登入功能

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。

CLAUDE.md 位置

位置	用途
`project-root/CLAUDE.md`	專案專屬規則
`~/.claude/CLAUDE.md`	個人全域規則

進階功能

1. Hooks（自動化觸發器）

Hooks 讓你在特定事件時自動執行腳本。

常見應用場景：

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

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

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "pnpm lint --fix $CLAUDE_FILE_PATHS"
          }
        ]
      }
    ]
  }
}

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

2. MCP（Model Context Protocol）

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

常見 MCP 伺服器：

memory - 跨對話記憶
filesystem - 增強檔案操作
github - GitHub 整合

安裝範例：

# 安裝 memory 伺服器
claude mcp add memory -- npx -y @anthropic-ai/mcp-server-memory

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

3. 自訂 Agents

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

建立方式：

claude
/agents
# 選擇「Generate with Claude」
# 描述你想要的 agent

常見 Agent 類型：

Code Reviewer - 程式碼品質審查
Debugger - 錯誤分析
Test Writer - 測試建立

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

4. 自訂 Skills

Skills 是可重複使用的指令範本。

建立方式：

在 .claude/skills/ 建立 Markdown 檔案：

# my-deploy.md
---
name: deploy
description: "部署到正式環境"
user-invocable: true
---

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

使用方式：/deploy

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

最佳實踐

1. 保持 Context 乾淨

每完成一個任務後，使用 /clear 清除對話歷史

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

2. 善用 Plan Mode

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

3. 給予明確的指示

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

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

4. 採用測試驅動開發

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

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

5. 善用內建工具

指令	用途
`/init`	初始化 CLAUDE.md
`/cost`	查看 token 使用量
`/memory`	管理記憶
`/model`	切換模型

常見問題

Q：Claude 不執行我的指令？

A：檢查權限設定。Claude 可能正在等待你的確認。輸入 y 或 a（接受全部）。

Q：如何降低費用？

A：

使用 /clear 清除不需要的歷史
使用 Shift+Tab 先規劃再執行
簡單任務改用 Haiku 模型

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

A：

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

Q：如何在團隊中使用？

A：

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

Q：支援哪些程式語言？

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

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

下一步

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

Hooks 完整指南 - 建立自動化工作流程
MCP 設定指南 - 擴展 Claude 的能力
Agents 完整指南 - 建立自訂 agents
Director Mode 方法論 - 進階開發模式