Claude Code 是什麼？（給完全沒用過的人）
一句話:住在終端機裡的 AI 工程師——你輸入自然語言「幫我改這個 bug」「重構這個檔案」**，它讀檔、改檔、跑指令、commit。
vs Copilot / Cursor / Codex 的本質差別:
- Copilot:IDE 內的自動補全——你寫一行，它建議下一行
- Cursor:整合 IDE + AI——chat 介面 + 自動補全 + 跨檔案改寫
- Claude Code:獨立 CLI / agent——你下指令，它自己決定要做什麼、跑什麼、改什麼
- Codex(OpenAI):類似 Claude Code 的 CLI,GPT 模型
為什麼 2026 年 4% GitHub 提交由 Claude Code 寫:
- agentic 能力強——SWE-bench Verified 93.9%(Claude Opus 4.7)
- Plan Mode 讓 AI 先想再動——降低改錯的風險
- 大規模任務（整個 codebase 重構）穩定度比 Cursor 高
- Anthropic 對 Claude Code 投入極大——5/06 SpaceX Colossus 算力 + 限額翻倍就是訊號
安裝與基礎（15 分鐘上手）
macOS / Linux 一行指令
# 用 npm 安裝
npm install -g @anthropic-ai/claude-code
# 啟動
claudeWindows 必裝 WSL2
Windows 用戶必須先裝 WSL2(Windows Subsystem for Linux)——Claude Code 不原生支援 Windows。
WSL2 安裝步驟:
- 開啟 PowerShell（系統管理員） → 執行
wsl --install - 重啟 Windows
- 進入 WSL Ubuntu → 裝 Node.js → 裝 Claude Code
常見錯誤:
- 「WSL 找不到」 → Windows 版本太舊，升級到 Win 10 2004+ 或 Win 11
- 「Claude command not found」 → Node.js 沒裝對，或 PATH 沒設
Mason 自己是 Windows + WSL2——體驗略不如 macOS 原生，但功能 100% 可用。
第一次登入（三種方式）
- Claude Pro / Max 訂閱:用網頁 OAuth 登入——免費額度由訂閱涵蓋
- Anthropic API key:從 console.anthropic.com 拿 key——按 token 計費
- 企業 SSO:Anthropic 企業客戶——統一身分管理
訂閱 vs API 該選哪個：看第 9 節決策樹。
第一個任務：讓它讀你的專案、做個總結
cd ~/your-project
claude
# Claude 啟動後,輸入:
> 請讀這個專案,給我 5 分鐘的高層概覽:技術棧、主要功能、潛在問題Claude Code 會做:
- 自動掃描專案結構
- 讀 README、package.json、主要程式碼檔
- 給你結構化的專案總覽
這是「第一次驚艷」的時刻**——你沒寫一行程式碼，Claude 已經幫你建立了專案的心智模型。
第一週必學的 8 個功能
1. 讀檔與改檔
> 看一下 src/utils/api.ts,把 fetchUser 改成 async/awaitClaude 會自動找檔、讀檔、改檔。不需要你貼程式碼進來。
2. 跑 bash 指令
> 跑 npm test,失敗的測試列出來Claude 會跑指令、看 stdout / stderr、整理結果。
3. git commit / push
> 把這次改的東西 commit,訊息要符合 conventional commitsClaude 會看 diff、寫 message、commit。不會 push 除非你說 push。
4. 跨檔重構與全專案搜尋
> 把 getUserById 重新命名為 fetchUserById,全專案改Claude 會 grep、找出所有引用、一次改完。
5. Plan 模式：讓 AI 先想再動
> /plan 把整個認證系統從 JWT 改成 session-basedPlan Mode 啟動後，Claude 會先寫完整計畫（不改任何檔）讓你 review——確認後才動手。大型改動必開。
6. think / ultrathink 思考模式
think:多想一下（中等深度思考）ultrathink:深度思考（複雜問題的全面分析，用更多 token 但結果更穩）
用法：在自然語言裡加「請用 ultrathink 模式」**,Claude 會切換到深度思考。
7. Haiku / Sonnet / Opus 三模型切換
- Haiku:最快、最便宜——適合簡單任務（讀檔、查找、簡單修改）
- Sonnet:平衡——適合大多數工作
- Opus:最強、最貴——適合複雜重構、架構設計、深度分析
切換指令:/model haiku / /model sonnet / /model opus
8. /clear 與 context 管理
/clear:清掉對話歷史（保留 CLAUDE.md / Skills）/compact:壓縮對話歷史（保留關鍵脈絡，釋放 context）
何時用:context 接近 80% 時、或任務切換時。
CLAUDE.md：讓 Claude 真正懂你的專案
三層架構
| 層級 | 位置 | 適合什麼 |
|---|---|---|
| 全域 | ~/.claude/CLAUDE.md | 你個人偏好（寫作風格、慣用工具、不要做的事） |
| 專案 | <repo>/CLAUDE.md | 整個團隊共用的專案規矩 |
| Local | <repo>/CLAUDE.local.md | 個人在此專案的客製（不 commit） |
該放什麼
好的 CLAUDE.md 內容:
- ✅ 不要做的事(「不要寫 mock test、用真 DB」)
- ✅ 特殊工具 / 指令(「dev server 用
bun dev，不是 npm run dev」) - ✅ 架構約定(「所有 API call 經由
lib/api.ts統一處理」) - ✅ 業務術語(「
Order指訂單，Booking指預約，兩者不一樣」)
爛的 CLAUDE.md 內容:
- ❌ 太籠統的話(「請寫出好程式碼」)
- ❌ 可從程式碼推導的事(「這個專案用 TypeScript」——看 package.json 就知道)
- ❌ 過時的資訊(「用 React 17」**但已升到 18)
Mason 自己站台的 CLAUDE.md 摘要
（站台用來維護 1,600+ 篇文章的真實 CLAUDE.md 結構）
# AI new (主站) — CLAUDE.md
## 寫作規矩
- **中文標點全形**(已有 build-time plugin 自動轉)
- **不要塞英文動詞**(英文只限產品 / 公司名)
- **insights 文章必含 tldr**(5-6 行)
- **長青文必含 FAQ**(5 題)
## 內容結構
- `src/content/insights/`:時效性 AI 趨勢
- `src/content/tools/`:工具教學 / 評測
- `src/content/tech/`:技術概念
- `src/content/career/`:行業 AI 應用
## 不要做的事
- **不要寫死 publishedAt**——讓 frontmatter 自動帶
- **不要碰 jingyun-spa 專案**(私案、未公開)
- **不要動 migration/old-content**(舊內容封存)
## 工具
- Build:`bun run build`
- Dev:`bun dev`
- 生 hero cover:`node scripts/gen-insights-heroes.mjs`
- Normalize 標點:`npm run normalize:punct`Skills：把重複任務變成可呼叫的能力
深度教學見 Claude Skills 完整指南。
跟 CLAUDE.md 的分工
| 機制 | 用途 |
|---|---|
| CLAUDE.md | 「這個專案的規矩」——所有 session 都讀 |
| Skills | 「特定任務的 SOP」——Claude 判斷該用時才讀 |
典型搭配:
- CLAUDE.md 寫「這個專案用全形中文標點」**（全局規矩）
- Skill 寫「怎麼把英文文章編譯成繁中」**（特定任務 SOP）
官方 17 個 Skills 哪些值得裝
第一次必裝 5 個:
- skill-creator（寫 Skill 的 Skill）
- docx（處理 Word）
- pdf（處理 PDF）
- xlsx（處理 Excel，能跑公式）
- research-paper-summarizer（摘要學術論文）
進階再裝:
- mcp-builder（寫 MCP server）
- artifacts-builder(claude.ai 用戶)
Subagents：讓多個 AI 平行工作
內建 Plan Subagent 已可用——你下 /plan 時，Claude 自動啟動一個專門 plan 的子 agent。
自訂 Subagent
放到 .claude/agents/ 資料夾：
# .claude/agents/code-reviewer.md
---
description: Review code changes for quality, security, and edge cases. Spawn when user says "review my changes" or "check this code".
---
# Goal
對 git diff 或指定 commit 做完整 code review,涵蓋:
- 程式碼品質(可讀性、重複、命名)
- 安全性(injection、auth、secrets)
- 邊界條件(空值、錯誤處理、race condition)
# Output
Markdown 結構化報告,分:
- ✅ 沒問題的部分
- ⚠️ 建議改善
- 🔴 必修問題呼叫方式:
> 用 code-reviewer subagent 看一下我這次的改動三個實用 Subagent 案例
- code-reviewer（程式碼審查）
- seo-checker（文章 SEO 檢查——對 Mason 站台超有用）
- batch-refactor（大規模重構某個 pattern）
跟 Skills 的差別
| 機制 | 特性 |
|---|---|
| Skill | 主 Claude 套用 SOP,在當前 session 內做事 |
| Subagent | 獨立 session,獨立 context——適合「不污染主 context」**的任務 |
典型用法:
- 寫程式時，呼叫 code-reviewer subagent 審查——subagent 在獨立 context 跑，主 session 不被污染
- 寫文章時，呼叫 seo-checker subagent 檢查——專門做這件事，結果回傳給主 session
Hooks：用程式碼控制 Claude 的行為
Hooks 是 Claude Code 的「生命週期觸發點」。有 25 個觸發點(2026/05 最新版)，最常用的：
PreToolUse：攔截危險操作
# .claude/hooks/pre-tool-use-block-rm.sh
#!/bin/bash
TOOL_NAME=$1
TOOL_ARGS=$2
if [[ "$TOOL_NAME" == "Bash" ]] && [[ "$TOOL_ARGS" == *"rm -rf"* ]]; then
echo "BLOCKED: rm -rf detected" >&2
exit 1
fi這個 hook 會在 Claude 想跑 rm -rf 之前中斷——避免悲劇。
SessionStart：自動載入專案狀態
# .claude/hooks/session-start.sh
#!/bin/bash
echo "📋 載入專案狀態..."
git status --short
git log --oneline -5
echo "🔍 當前分支:$(git branch --show-current)"每次開 session，自動把專案狀態印給 Claude 看——你不用再貼。
5 個必加 Hooks
- PreToolUse 攔截
rm -rf / -rf / *等危險指令 - PreToolUse 攔截
git push --force到 main - SessionStart 印當前 git status / branch
- PostToolUse 自動 lint 改過的檔案
- OnError 把錯誤訊息整理成可學習的格式
完整實戰：Mason 怎麼用 Claude Code 維護 1,600+ 篇文章
這是 SERP 上沒人完整寫過的部分——從第 0 步到部署的真實工作流。
工作流概覽
- 想到題目(insights / 長青文)→ 開個 Plan
- Plan → Claude 用 ultrathink 模式做 SERP 研究、規劃結構
- 撰寫 → 用 draft-health-news / chinese-news-compilation 等 Skills
- 校稿 → seo-checker subagent 檢查
- commit → Claude 寫 commit message
- 推到 GitHub → 觸發 Cloudflare Pages 自動部署
- build 失敗 → Claude 看 logs 找原因、修、再推
每一步用了什麼
| 步驟 | 工具 |
|---|---|
| 找題目 | Agent + WebSearch(Claude Code 內建) |
| 設計結構 | Plan Mode |
| 撰寫 | Skills(draft 系列) |
| 內鏈 | grep 既有 slugs |
| 校稿 | Subagent(seo-checker) |
| 標點 normalize | hook(post-edit auto-normalize) |
| commit | Claude 寫 message |
| 部署 | git push → Cloudflare 自動 |
這個工作流花的時間:
- 以前（沒 Claude Code）:1 篇 4,500 字長青文約 6-10 小時
- 現在（有 Claude Code）：同樣品質 1-2 小時
ROI:月省 50-80 小時——對 solo 內容創作者是巨大解放。
三階段升級路徑
第 1 週：CLI 基本 8 功能
- 讀檔、改檔
- 跑 bash
- git commit
- Plan Mode
- 三模型切換
/clear管 context
目標:讓 Claude Code 取代 80% 的 IDE 內 AI。
第 1 個月：CLAUDE.md + Skills
- 寫專案 CLAUDE.md
- 裝官方 5 個 Skills
- 開始寫自己的 1-2 個 Skill
目標:讓 Claude Code 理解你的專案脈絡 + 工作 SOP。
第 3 個月：Subagents + Hooks + CI/CD
- 寫 2-3 個 Subagent
- 加 PreToolUse hooks 防呆
- 整合到 CI/CD(GitHub Actions / Cloudflare)
目標:Claude Code 變成「全自動工程師」——你只負責決定要做什麼，執行細節它接手。
訂閱方案決策樹
三檔訂閱
| 方案 | 月費 | 額度（估） | 適合 |
|---|---|---|---|
| Pro | $20 | 約 3-5 小時 / 天 | 輕度寫作、偶爾改程式 |
| Max 5x | $100 | 約 8-12 小時 / 天 | 全職 coding 1-2 hr |
| Max 20x | $200 | 約 20+ 小時 / 天 | 重度 + 多 agent 平行 |
| API per-token | 按用 | 無上限 | CI/CD、企業整合 |
該訂哪個？
情境 A：你是新手 / 輕度用戶
- 日均 Claude Code 0-1 小時
- 建議：Pro $20
情境 B：你是接案者 / SOHO
- 日均 2-4 小時
- 建議：Max 5x $100——超過 Pro 配額但用不到 Max 20x
情境 C：你是全職開發者 + 跑 agent
- 日均 4-8 小時 + 跑背景 agent
- 建議：Max 20x $200
情境 D：你做產品 / CI 整合
- 建議：Pro 訂閱 + Anthropic API key——個人開發用 Pro，自動化用 API
試算：你應該訂哪個
做 Mason 風格的試算:
| 你 | 日均 Coding 時數 | 月費 ROI |
|---|---|---|
| 學生 | < 1 hr | Pro $20（學基本功不需要強配額） |
| 接案者 / SOHO | 2-4 hr | Max 5x $100（配額剛好 + 不卡頓） |
| 全職工程師 | 4-8 hr | Max 5x or 20x 看用法 |
| 重度 + 跑多 agent | 8+ hr | Max 20x $200（配額 + 多 agent 平行） |
Mason 自己:Max 5x $100——日均 3-4 hr，寫文章 + 維護站台，月帳單明顯比 Cursor + ChatGPT Plus 加起來省。
5 個保命設定（避免把 prod 刪掉）
對應 pocketos 9 秒刪庫事件——AI agent 真的會出包，設定要做好。
1. 啟用 Permissions / Allow list
在 .claude/settings.json:
{
"permissions": {
"allow": [
"Read",
"Edit",
"Bash(npm:*)",
"Bash(git:*)"
],
"deny": [
"Bash(rm:*)",
"Bash(*push --force*)"
]
}
}2. git worktree 隔離環境
重要重構別在 main branch 做——用 worktree:
git worktree add ../my-project-refactor refactor-branch
cd ../my-project-refactor
claude這樣 Claude 改錯也只影響 worktree,main 不受傷。
3. PreToolUse hook 攔截危險指令
（見上節「Hooks」）
4. auto-commit 策略
讓 Claude 改完一個邏輯單位就 commit——而不是改 20 個檔才一起 commit。這樣壞掉 git revert 即可，不會丟工。
5. 重要操作前先 Plan
大型重構、改 production config、改 database schema——先 /plan，看完計畫再執行。
vs Cursor / Copilot / Codex 2026 最新
| 維度 | Claude Code | Cursor | Copilot | Codex |
|---|---|---|---|---|
| 介面 | CLI / 終端機 | IDE 內 | IDE 內 | CLI |
| 主模型 | Claude Opus 4.7 | 多模型 | GPT-4o / GPT-5 | GPT-5 |
| 跨檔重構 | 最強 | 強 | 中 | 強 |
| Plan 模式 | 原生 | 部分 | 無 | 有 |
| Skills | 原生 | 無 | 無 | 部分 |
| Subagents | 原生 | 無 | 無 | 部分 |
| Hooks | 原生 25 個觸發點 | 無 | 無 | 部分 |
| 訂閱 | $20 / $100 / $200 | $20 | $10-19 | API |
| 適合 | 中重度 + agent | IDE 重度 | 自動補全 | OpenAI 生態 |
Mason 的建議:Claude Code 主力 + Cursor 輔助(IDE 內小範圍編輯)——兩個各擅長不同場景。
❓ FAQ
Claude Code 要付錢嗎？Pro $20 跟 Max 差多少？
Pro $20:輕度用戶夠用（日均 Claude 1-3 小時） Max 5x $100:接案 / 全職工程師（日均 2-4 小時） Max 20x $200:重度 + 跑背景 agent（日均 4+ 小時）
ROI 試算:
- 接案者用 Max 5x $100,月省 50-80 小時的人工——時薪 NT$1,000 算，月省 5-8 萬
- 每月 $100 換回 5-8 萬時間成本——這是壓倒性的投資報酬
Mason 自己用 Max 5x——配額剛好不卡頓，沒到 Max 20x 的需求。
Windows 可以用 Claude Code 嗎？必須裝 WSL2?
Windows 必須裝 WSL2——Claude Code 不原生支援 Windows，要透過 WSL2(Ubuntu)跑。
安裝步驟:
- PowerShell（系統管理員）→
wsl --install - 重啟 Windows
- 進 WSL Ubuntu → 裝 Node.js →
npm install -g @anthropic-ai/claude-code
體驗:Mason 自己 Windows + WSL2 用，功能 100% 可用,速度略不如 macOS 原生(WSL 跨檔系統有開銷)。
不會寫程式可以用 Claude Code 嗎？
可以，但學習曲線略陡。
完全不寫程式的用法:
- 維護內容網站（像 Mason 用來維護 1,600+ 篇 Markdown）
- 整理檔案 / 文件（讓 Claude 重新組織資料夾）
- 資料分析（餵 CSV / Excel,Claude 跑分析）
- 學程式入門（請 Claude 解釋程式碼）
但你需要:
- 會基本 terminal(
cd、ls) - 會 git 基礎(commit、push)
- 願意看 Claude 寫的程式碼，即使不全懂
完全沒 terminal 經驗:先用 Claude.ai 網頁版 或 Cursor IDE——這兩個門檻低。
我的程式碼會被 Anthropic 拿去訓練嗎？
預設不會。Anthropic 對 API 用戶的承諾是「API 對話預設不用於訓練」**。
但 3 個情境例外:
- 你主動同意「用我的對話改進 Claude」(Pro 訂閱設定可開可關)
- 企業合約（看合約條款，部分企業可能有資料共享）
- 明確的「privacy bug」——理論上 Anthropic 員工極少數情況下可看到對話（內部審查、法律調查）
降風險做法:
- 設定 → Privacy → 確認「不用於訓練」
- 敏感程式碼用本地 Ollama 處理（完全離線）
Claude Code 跟 Cursor 該選哪個？可以一起用嗎？
可以也應該一起用——兩個各擅長不同場景。
Claude Code 強項:
- 跨檔案大規模重構
- 長對話、複雜任務
- Agent 工作流(Plan / Subagents / Hooks)
Cursor 強項:
- IDE 內小範圍編輯（自動補全）
- 視覺 diff
- 即時看到改動
Mason 的搭配:
- Claude Code 主力（寫文章、大改動）
- Cursor 輔助(IDE 內快速調整、看 diff)
- 加起來月費 $120($100 + $20),月省 50+ 小時
Claude Code 把我的檔案改壞、把 prod 刪掉怎麼辦？
真實發生過——2025/04 pocketos 9 秒刪庫事件。5 個保命設定可大幅降低風險:
- Permissions allow / deny list（限制可用工具）
- git worktree 隔離環境（壞了不影響 main）
- PreToolUse hook 攔截危險指令(
rm -rf、git push --force) - auto-commit 策略（改完一個單位就 commit，壞了 revert 即可）
- 重要操作先 Plan 模式
最大原則:Claude 還不是 100% 可信的同事——對 production / 不可逆操作，永遠人工 review。
⚠️ 警語
- Claude Code 仍快速演化——本文基於 2026/05 資訊，指令、訂閱、功能可能更新
- 不要在沒 review 的情況下讓 Claude 改 production——agent 真的會出包
- 訂閱配額會變——Anthropic 過去 6 個月已調整 2 次配額，請以官方公告為準
權威來源: