Claude Code 零基礎入門 — 上集：配置與核心觀念

描述	階段	下一步
偶爾問 ChatGPT 問題	Chat	試試用 AI 完成一個完整小任務
常用 AI 幫忙但還是自己做	Cowork	開始讓 AI 直接執行，你只 review
AI 幫你跑完整個工作流	Agent	開始寫 Skill，把成功流程固化

AI 三階段：Chat → Cowork → Code

⏱ 05:04 – 09:18

影片提出一個很有用的框架，把使用 AI 的成熟度分成三個階段：

階段一：Chat（對話） 把 AI 當搜尋引擎或問答機器。問問題、要解釋。效率提升有限。

階段二：Cowork（協作） 把 AI 當工作夥伴。你提需求，AI 給方案，你來決策。效率提升明顯，但仍需要大量人工介入。

階段三：Code / Agent（代理執行） AI 主動執行、自我修正、完成完整任務。你負責定義目標與品質標準，AI 負責執行細節。

安裝 Claude Code

⏱ 09:18 – 14:52

前置條件

09:18

Node.js v18+（建議用 nvm 管理）
有效的 Anthropic 帳號與 API Key
終端機（macOS Terminal / Windows Terminal / iTerm2）

安裝步驟

10:30

# 全域安裝 Claude Code
npm install -g @anthropic-ai/claude-code

# 確認安裝成功
claude --version

設定 API Key

11:45

# 方法一：設定環境變數（推薦）
export ANTHROPIC_API_KEY="sk-ant-xxxxxxx"

# 方法二：互動式設定（首次執行時會引導）
claude

首次啟動

13:20

# 進入你的專案目錄後執行
cd your-project
claude

Claude Code 會分析你的專案結構，然後等待你的指令。

macOS / Linux 補充：持久化 API Key

# 加入 ~/.zshrc 或 ~/.bashrc，讓每次開 terminal 都有效
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxxxx"' >> ~/.zshrc
source ~/.zshrc

Windows 補充：

# PowerShell — 設定使用者環境變數（永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY","sk-ant-xxxxxxx","User")
# 重開 terminal 後生效

CLAUDE.md：你的 AI 行為說明書

⏱ 14:52 – 20:11

CLAUDE.md 是 Claude Code 每次啟動都會自動讀取的設定檔，放在專案根目錄。它的作用是讓 AI 理解你的專案、你的偏好、以及它應該怎麼工作。

一個好的 CLAUDE.md 應該包含

15:30

# 專案說明
這是一個用 Next.js 14 + TypeScript 寫的電商後台...

# 技術棧
- Framework: Next.js 14 (App Router)
- 樣式: Tailwind CSS
- 資料庫: PostgreSQL + Prisma

# 開發守則
- 永遠用 TypeScript，不要用 any
- 測試用 Vitest，coverage 需要 > 80%
- commit message 用英文動詞起頭

# 禁止事項
- 不要動 /lib/legacy 底下的檔案
- 不要直接改 database schema，用 migration

全域 vs 專案 CLAUDE.md

18:45

類型	路徑	適用範圍
全域	`~/.claude/CLAUDE.md`	所有專案
專案	`專案根目錄/CLAUDE.md`	該專案
目錄	`子目錄/CLAUDE.md`	該目錄及以下

Claude Code 會把這三層的內容疊加起來，越深層的設定優先級越高。

MCP：讓 Claude Code 連接外部工具

⏱ 20:11 – 25:33

MCP（Model Context Protocol） 是 Anthropic 制定的開放協議，讓 AI 可以安全地使用外部工具。你可以把 MCP 想成是「AI 的插件系統」。

常見的 MCP 工具

20:30

Filesystem：讓 AI 讀寫特定目錄的檔案
GitHub：讓 AI 操作 GitHub PR、Issues、Repos
Firecrawl：讓 AI 抓取網頁內容
Puppeteer：讓 AI 操作瀏覽器
Postgres：讓 AI 查詢資料庫

設定 MCP

22:00

// 在 ~/.claude/mcp_settings.json 或互動式設定
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/your/path"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."
      }
    }
  }
}

MCP 設定檔路徑（依作業系統）：

系統	路徑
macOS	`~/.claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/claude/claude_desktop_config.json`

推薦的 MCP 入門順序：

Filesystem（最安全）：讓 AI 只能讀你指定的目錄
GitHub（開發必備）：讓 AI 幫你建 PR、查 Issue
Firecrawl（實用）：讓 AI 抓網頁資料，取代手動複製貼上

Slash Commands 與互動技巧

⏱ 25:33 – 30:17

Claude Code 在終端機裡支援一系列快捷指令（Slash Commands）：

指令	功能
`/help`	顯示所有可用指令
`/clear`	清除對話記錄，開始新 session
`/compact`	壓縮對話記錄以節省 context
`/cost`	顯示目前 session 的 token 使用量
`/doctor`	診斷環境設定問題
`/model`	切換使用的模型
`/permissions`	查看/修改檔案操作權限

有效的提示技巧

27:00

給任務而不是步驟

# ❌ 太細（步驟導向）
先建立 UserService 類別，然後加入 findById 方法，
方法要接受 string 型別的 id 參數，用 Prisma 查詢...

# ✅ 好（目標導向）
實作 UserService，需要 findById、findByEmail、
create、update、delete，用 Prisma，加上完整的錯誤處理
和 TypeScript 型別。

提供品質門檻

做完之後跑測試，確認所有現有測試還是通過的，
然後幫新功能補上測試，coverage 要到 80% 以上。

常用 Slash Commands 速查：

/help          → 查所有指令
/clear         → 開新 session（清除對話記憶）
/compact       → 壓縮 context（用量快到 80% 時用）
/cost          → 查目前 session 花了多少錢
/doctor        → 環境診斷（安裝出問題時用）
/model         → 切換模型（Opus / Sonnet / Haiku）
/permissions   → 查看目前授權設定

Permission 機制：AI 的授權邊界

⏱ 30:17 – 35:24

Claude Code 執行任何會影響你系統的操作前，都會先詢問你的授權。了解這個機制能讓你更有效率地使用工具。

三種授權模式

30:30

逐次詢問（預設） 每個操作都問你，適合初期使用或不熟悉的工作。

Session 授權 一次性允許某類操作在這個 session 內不再詢問：

> Allow: Run shell commands without asking for the rest of this session

永久授權（settings.json）

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git *)",
      "Edit(**/*.ts)",
      "Edit(**/*.tsx)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Edit(**/secrets/**)"
    ]
  }
}

settings.json 路徑：

範圍	路徑
全域（所有專案）	`~/.claude/settings.json`
專案（優先級高）	`專案根目錄/.claude/settings.json`

建議的安全白名單起點：

{
  "permissions": {
    "allow": [
      "Bash(npm run *)",
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(git log *)",
      "Edit(**/*.ts)",
      "Edit(**/*.tsx)",
      "Edit(**/*.md)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(sudo *)"
    ]
  }
}

上集總結

上集涵蓋了使用 Claude Code 最重要的基礎觀念：

理解代理性：Claude Code 是執行者，不只是顧問
CLAUDE.md 是核心：花時間寫好它，AI 才能正確工作
MCP 擴充能力：按需啟用，不要過度開放
目標導向提示：給任務和品質門檻，不給步驟
Permission 要謹慎：AI 的授權邊界要清楚設定

下集（下集：實戰）會進入實際的開發場景，示範如何用 Claude Code 完成一個完整的功能，包括如何從需求到上線的完整流程。

本文根據「柚智夫妻 X 雷蒙三十」的 YouTube 影片整理，版權歸原作者所有。觀看原始影片 ↗