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

Claude Code 零基礎入門第 1 集

Claude Code 零基礎入門 — 上集

✍️柚智夫妻 X 雷蒙三十 📅2026年4月7日 ⏱35:24 📑8 章

#claude-code#terminal#mcp#vibe-coding

▶觀看原始 YouTube↗ 本文根據原 YouTube 整理，版權歸原作者所有

外部資源

Claude Code 官方文件官方

Anthropic 官方的 Claude Code 完整安裝、設定與使用說明

docs.anthropic.com ↗

原始影片（YouTube）

柚智夫妻 X 雷蒙三十 — Claude Code 零基礎入門上集

youtube.com ↗

什麼是 Claude Code？不只是寫程式

⏱ 00:00 – 05:04

Claude Code 是 Anthropic 推出的 AI 編程代理（Coding Agent），可以在你的終端機（Terminal）裡直接執行。它不只是一個聊天機器人——它可以：

讀取、寫入、修改你的本地檔案
執行命令列指令（npm install、git commit 等）
自主完成多步驟任務，不需要你逐步指揮

與一般 AI 聊天工具的比較：

功能	一般 AI 聊天	Claude Code
讀取本地檔案	❌	✅
執行終端機指令	❌	✅
多步驟自動化	有限	✅
與 IDE 整合	插件	原生終端機
跨工具協作（MCP）	❌	✅

AI 三階段：Chat → Cowork → Code

⏱ 05:04 – 09:18

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

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

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

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

安裝 Claude Code

⏱ 09:18 – 14:52

前置條件

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

安裝步驟

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

# 確認安裝成功
claude --version

設定 API Key

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

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

首次啟動

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

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

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

⏱ 14:52 – 20:11

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

一個好的 CLAUDE.md 應該包含

# 專案說明
這是一個用 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

類型	路徑	適用範圍
全域	`~/.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 工具

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

設定 MCP

// 在 ~/.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_..."
      }
    }
  }
}

Slash Commands 與互動技巧

⏱ 25:33 – 30:17

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

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

有效的提示技巧

給任務而不是步驟

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

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

提供品質門檻

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

Permission 機制：AI 的授權邊界

⏱ 30:17 – 35:24

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

三種授權模式

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

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/**)"
    ]
  }
}

上集總結

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

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

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

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