你已經會用 ChatGPT 或 Claude 網頁版了,Claude Code 就是它的「會動手」版本——它能真的去讀你電腦裡的檔案、改程式碼、跑指令、甚至幫你送 PR。 這篇不講 subagents、hooks、MCP 那些進階玩法，只告訴你「新手第一週會天天用到」的 8 個功能，加上思考模式、Plan 模式、3 個模型怎麼選、Skill 是什麼、上下文爆了怎麼辦——每個都配一個最簡單的真實案例。
想看完整規格(subagents / hooks / MCP / Plugin System)的話直接去 Claude Code 完全指南;這篇只管讓你「第一週能用起來」。
🧭 快速跳轉 15 分鐘裝起來 · 8 個實用功能 · 思考模式 · Plan 模式 · 3 個模型怎麼選 · Skill 技能包 · 上下文管理 · vs Cursor / Copilot · 新手踩坑 · 第一週學習路徑 · FAQ
⚡ 先釐清:Claude Code vs Claude 網頁版差在哪？
新手最常問的一題。簡單表格說完:
| Claude 網頁版 / App | Claude Code | |
|---|---|---|
| 形式 | 瀏覽器/桌面程式，聊天視窗 | 終端機(Terminal / PowerShell)跑的 CLI |
| 它會「動手」嗎? | ❌ 不會，只回文字 | ✅ 會，會改檔、跑指令、做 commit |
| 看得到你電腦的檔案嗎? | ❌ 看不到(要你貼給它) | ✅ 看得到，可以讀整個專案 |
| 費用 | 有免費版,Pro $20/月 | 不含免費版,需要 Pro / Max / Team 訂閱 |
| 適合誰 | 問問題、腦力激盪、寫文章 | 改程式、跑測試、做一整件工程任務 |
一句話：聊天就用網頁版，要它做事就換 Claude Code。 兩個是互補的，不是取代關係。
🚀 15 分鐘先把 Claude Code 裝起來
安裝這段我快速帶過，完整步驟(含 Windows WSL2 細節)看 完全指南的安裝章節。
macOS / Linux 終端機貼:
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell 貼:
irm https://claude.ai/install.ps1 | iex裝完驗證:
claude --version看到版本號就成功。第一次用會要你登入 Claude 帳號(Pro / Max 都可以),然後 cd 到你的專案資料夾，打 claude 啟動互動模式。就這樣。
💡 新手小提醒 免費的 Claude.ai 帳號不能用 Claude Code。最便宜要 Pro 方案($20/月),重度使用者(每天幾小時)建議 Max。別卡在「為什麼我登不進去」。
🔥 8 個新手會天天用到的實用功能
每個功能都配「情境 → 怎麼用 → 簡單範例」。你不用一次學完，先把功能 1–3 練熟，其他遇到再查。
功能 1:讀整個專案後再回答(最大差異)
情境:你接手一個別人寫的專案，不知道從哪看起。
怎麼用:cd 到專案資料夾，打 claude,直接問:
這個專案是做什麼的?主要的進入點在哪?Claude Code 會自動掃檔、讀 README、package.json、看路由，給你一份摘要。你不用貼任何程式碼給它。
簡單範例:新人接手公司的網站專案，問「使用者登入流程在哪幾個檔案」,它會跟你說 src/auth/login.ts 跟 middleware/session.ts,還告訴你 JWT 怎麼驗。
功能 2:直接改檔案，不用複製貼上
情境:網頁版 Claude 給你一段修好的程式，你還要手動貼回檔案。Claude Code 省掉這步。
怎麼用:直接說「幫我把 login.ts 裡的密碼驗證改成 bcrypt」——它會直接改檔，改完秀 diff 給你看。
簡單範例:
把 utils/format-date.ts 改成支援時區參數,預設 Asia/Taipei它會自己找檔、改完、顯示改了哪幾行。你只要決定接受或退回。
功能 3:跑指令、跑測試、跑 linter
情境:改完程式要跑測試確認沒弄壞,Claude Code 會自己跑。
怎麼用:
幫我把剛改的那段跑 npm test,看有沒有問題它會執行指令、看輸出、判斷結果、告訴你哪裡紅了。紅的話它還會自己去修。
簡單範例:你寫了個新 API route,叫它「寫測試 + 跑起來」,它會補測試檔、執行 vitest、看結果、缺 mock 就自動加。
⚠️ 破壞性指令會先問你 碰到
rm、git push --force、DROP TABLE這類不可逆指令,Claude Code 會跳出權限詢問，要你手動確認。不用擔心它會偷偷把你的資料砍掉——但也不要亂按 yes。
功能 4:寫 CLAUDE.md 記住專案規則(90% 新手沒用到但超實用)
情境:你告訴 Claude「這個專案的 button 都要用 shadcn 的 Button」,下次重開 session 它又忘了。
怎麼用:在專案根目錄建一個 CLAUDE.md,把專案的規則、慣用工具、coding style 寫進去。Claude Code 每次啟動會自動讀這個檔案。
簡單範例(最簡 CLAUDE.md):
# 專案規則
- 框架:Astro + TypeScript
- UI:shadcn/ui,不要用別的 component library
- 測試:vitest,改功能一定要補測試
- commit message:中文、feat/fix/docs 開頭
- 不要用 any,類型要明確寫進去之後，再也不用每次都跟它囉嗦。這是 Claude Code 最被低估的功能。
功能 5:自動 git commit / 發 PR
情境:改完一堆檔案要 commit,你得自己想 commit message。
怎麼用:
幫我 commit 剛才的改動,message 寫清楚改了什麼它會跑 git status / git diff 看你改了什麼、寫出符合慣例的 commit message、問你要不要 commit。
簡單範例:改完 login.ts 跟 middleware/session.ts,叫它 commit,它會產:
feat(auth): 改用 bcrypt 雜湊密碼,session middleware 同步更新進階:「順便開 PR,跟我說 reviewer 該看哪三個地方」——它會跑 gh pr create 並寫好描述。
功能 6:解 bug,把錯誤訊息貼給它就好
情境:程式壞了,terminal 跳一串紅字看不懂。
怎麼用:直接貼錯誤訊息進去，不用任何解釋:
[貼上錯誤 log]Claude Code 會去看錯誤指到的檔案、對照程式碼、告訴你什麼壞了、建議修法。
簡單範例:TypeError: Cannot read properties of undefined (reading 'id') —— 它會去看那行、發現是 API 回傳可能沒帶 user 物件、建議加 optional chaining 或前置檢查。
功能 7:跨檔重構(rename / 批次改)
情境:某個變數名從 getUserId 要改成 getCurrentUserId,全專案都要改。
怎麼用:
把 getUserId 全站改名成 getCurrentUserId,記得 import 也要改它會先搜尋所有出現的地方，列清單給你，你點頭它就全改。
簡單範例:你把資料表欄位從 created_at 改成 createdAt,叫它同步改 Prisma schema、TypeScript 型別、所有查詢——一次搞定，不會漏。
功能 8:在 codebase 找東西(取代 grep)
情境:你記得某個功能有寫過，但忘了在哪個檔案。
怎麼用:
「報名截止」的邏輯在哪?有幾個地方用到?比 grep 強的是：它懂語意。「報名截止」會找到 registrationDeadline、signupEndDate、甚至中文 截止時間 的欄位，全部列出來。
簡單範例:找「所有檢查使用者是不是 admin 的地方」——它會回傳 isAdmin() 函式、三個 middleware 的權限檢查、前端的 UI 條件顯示，各在哪幾行。
🧠 思考模式:think / think hard / ultrathink 差在哪？
一句話：在 prompt 裡加「think」相關關鍵字,Claude Code 會開啟「延伸思考」——它在回你之前會先花更多 token 推理，適合複雜任務。
關鍵字由弱到強對應四個推理預算:
| 觸發詞 | 推理預算(約) | 什麼時候用 |
|---|---|---|
| (不加) | 預設 | 日常小任務，改個 function、問個問題 |
think | low(約 4k tokens) | 小決策、比較 2–3 個方案 |
think hard / think harder | mid(約 10k tokens) | 多步驟任務、要考慮副作用 |
megathink | high(約 18k tokens) | 跨檔重構、架構改動 |
ultrathink | max(約 31.9k tokens) | 超難 bug、關鍵決策、大規模 refactor |
實務建議：先用預設。 覺得它給的答案不夠深入，再加「think hard」。真的卡關再上 ultrathink——但 token 費用跟時間都會變多。
延伸思考的原理、成本、踩坑細節
原理:Anthropic 的 extended thinking(延伸思考)會讓模型在正式回覆前，先跑一段內部推理(像人先打草稿),消耗額外的 output token。Claude Code 把它包裝成幾個觸發關鍵字，讓你用自然語言選等級。
成本:思考 token 跟一般 output token 同價。ultrathink 一次可能多 3 萬 tokens,Opus 模型的話一次就是 $0.40+ 的推理費用,不是什麼都加就好。
踩坑:
- 日常不要加。小修改加了只會變慢、更貴，品質不會更好
- 不是越多越好。有些任務加
ultrathink反而會讓它想太多、過度工程 - 搭配 Opus 最有感。Haiku 即使加 ultrathink 也有能力上限
- 一次任務一次。不要每句話都加，浪費
判斷時機的口訣:
- 「這個可以有很多種做法，我不確定哪個好」→
think hard - 「這是一個關鍵決策，錯了要回滾很麻煩」→
ultrathink - 「幫我把這行改成 arrow function」→ 不用加
🧭 Plan 模式：先看計畫再動手
一句話:Plan 模式下,Claude Code 只規劃、不執行——等你點頭才動手。適合大任務、不熟的 codebase、或不想被改爛的情境。
Claude Code 有三個操作模式，用 Shift + Tab 切換:
| 模式 | 它會做什麼 | 什麼時候用 |
|---|---|---|
| 預設 | 每個改動問你一次 | 日常大多數時候 |
| Plan 模式 | 只規劃，不動任何檔 | 大任務、重要 refactor、不熟的 repo |
| Auto-accept / Bypass | 自動執行所有改動 | 小任務、你很信任它的時候 |
實務建議:第一週先別開 auto-accept。大任務進 Plan 模式，看完計畫再放行；小任務留預設。
Plan 模式進階:什麼時候該用、怎麼搭配 ultrathink
最該用 Plan 模式的 5 個情境:
- 資料庫 migration:錯了很難回，先看計畫
- 跨檔大重構:一次要動 10+ 檔案的
- 第一次進陌生 repo:不熟的 codebase 先讓它規劃，你對著計畫學架構
- 有 API 金鑰 / 環境變數在 .env 的敏感專案:看它會不會不小心讀到不該讀的
- 正式環境部署相關任務:任何會動 prod 的，先規劃
Plan 模式 + ultrathink 組合技:
think harder 幫我規劃把 express 換成 hono,列出需要改的檔案、風險、回滾方式先進 Plan 模式，再加 think harder 關鍵字——它會給你一份很完整的遷移計畫，你 review 完再退出 Plan 模式讓它執行。
Auto-accept 的風險:新手千萬別一開始就開。它一旦決定要刪某個檔，你沒機會攔。熟了之後對付重複性高的小任務(格式化、補 type、跑測試)再開。
🤖 Haiku / Sonnet / Opus:3 個模型怎麼選？
一句話：日常用 Sonnet(預設),大重構換 Opus,批次小事跑 Haiku。
用 /model 指令切換。
| 模型 | 強項 | 弱項 | 適合任務 | 相對成本 |
|---|---|---|---|---|
| Haiku | 快、便宜 | 複雜推理較弱 | 批次改格式、rename、簡單 grep、跑測試看結果 | 1x |
| Sonnet(預設) | 平衡、主力 | 最難的題目仍有上限 | 一般開發、改 bug、寫新功能、寫測試 | 約 3x |
| Opus | 最聰明、最會做長任務 | 慢、貴 | 大 refactor、架構決策、難 bug、關鍵 PR review | 約 15x |
實務建議:
- 95% 的情況用 Sonnet——別想太多
- 覺得 Sonnet 給的方案不對勁、做錯很多次 → 切 Opus(
/model opus),通常一次就過 - 要 Claude 跑一大堆重複小事(例如「把這 50 個 component 的 import 路徑改對」)→ 切 Haiku(
/model haiku),省錢又快
各模型的實際任務範例 + 成本粗估
Haiku 超適合:
- 批次 rename(變數名、檔案路徑)
- 跑 linter、format、test 然後摘要結果
- 從 log 抓特定 error pattern
- 轉換資料格式(CSV → JSON 這類)
- 寫 commit message
Sonnet 是主力:
- 寫一個新 API route + 對應測試
- 除一般的 bug
- 重構單一檔案
- 寫文件、寫 README
- code review 小型 PR
Opus 才該上的任務:
- 跨 10+ 檔案的 refactor
- 從零設計一個模組的 architecture
- 難重現的 race condition / memory leak
- 關鍵商業邏輯的 PR review
- 多語言 / 跨框架遷移(例如 React → Vue)
成本粗估(以 Claude Pro $20/月、輕度開發者一天用 2 小時為例):
- 全程 Sonnet:月額度大概用 60–70%
- 大量 Opus:可能第 15 天就撞到用量限制，要升 Max
- 聰明切換(Sonnet 為主 + Haiku 做雜事 + Opus 處理關鍵任務):同樣用量可省 30–40% token
切換技巧:進同一個任務前先想「這事情最難的部分是什麼」。難的部分用 Opus 規劃，簡單的執行部分用 Sonnet / Haiku。
🎒 Skill:Claude Code 的「技能包」是什麼？
一句話:Skill 是一包預先寫好的工作流程(markdown 檔 + 可選的程式碼),放進專案後 Claude 會自動識別、用完即走，不佔你的對話上下文。
想像成「RPG 的技能樹」——你把技能掛上，遇到對應任務時它會自動觸發。
日常會用到的 Skill 範例:
- pdf skill:丟一份 PDF 給它，它會自動抓文字、轉表格、做摘要
- pptx / docx skill:讀/寫 Office 檔
- commit skill:按你的 commit 規範自動寫 message
- code-review skill:按你的 review checklist 做檢查
怎麼用(最簡):
- 在專案根目錄建
.claude/skills/資料夾 - 裡面放一個
<skill-name>/SKILL.md - SKILL.md 開頭寫 metadata(名稱、描述、何時觸發),內文寫步驟指示
- Claude Code 啟動後，偵測到相關任務就會自動載入
SKILL.md 最小範例 + 社群 skill 哪裡抓
最簡 SKILL.md 範例(一個「中文 commit」skill):
---
name: commit-zh
description: 使用中文撰寫符合專案規範的 git commit message
triggers: ["commit", "git commit"]
---
# 任務
產生符合以下規範的中文 commit message:
- 首行 50 字內,開頭用 feat / fix / docs / refactor / chore
- 空一行後寫詳細說明,每行 72 字內
- 說明要有「為什麼改」不只是「改了什麼」
- 結尾加 Co-Authored-By 如果是協作丟進 .claude/skills/commit-zh/SKILL.md,下次你說「commit 一下」它就會按這個規範寫。
Skill 跟 CLAUDE.md 的差異:
- CLAUDE.md:每次啟動都載入，適合全域規則(像是 coding style、專案架構)
- Skill:偵測到相關 query 才載入，用完釋放，適合「特定場景的詳細流程」
簡單判斷:「每次都該知道的」寫 CLAUDE.md;「只在特定任務才需要的」做成 Skill。
社群 Skill 哪裡抓:
- Anthropic 官方有內建一批(pdf / pptx / xlsx / docx 等辦公室 skill)
- GitHub 上搜尋
claude-code-skills有社群整理的清單 - 你自己寫一個就是最好的——按你的工作流訂做
🧹 上下文管理：什麼時候該重開 session?
一句話：上下文(對話歷史)不是越長越好——超過 70% 就該 /clear 重開，不要硬撐。
Claude Code 每個 session 有 context 上限(通常 200k tokens)。隨著你跟它對話，它讀的檔案、改動紀錄、思考過程都會累積。超過某個比例，品質會開始下降:回答變慢、開始忘記前面說過的規則、甚至產生幻覺(講不存在的 API)。
三個關鍵指令:
| 指令 | 效果 | 什麼時候用 |
|---|---|---|
/clear | 整個清空，開新 session | 換新任務、context 超過 70%、感覺它變笨 |
/compact | 把前面歷史濃縮成摘要繼續 | 當前任務還沒做完但 context 太長 |
/statusline | 看當前 model / context 使用量 / token 花費 | 隨時確認狀態 |
實務建議:
- 做完一個獨立任務就 /clear——比 /compact 乾淨
- /compact 會失真——重要資訊建議寫進 CLAUDE.md 再清
- 感覺 Claude「變笨」就是警訊——不要硬撐，清掉重開比較快
Context 過長的警訊 + 進階管理策略
Context 過長的 5 個警訊:
- 回答時間明顯變慢
- 開始忘記你前面定過的規則(例如「不要用 any」)
- 提到不存在的函式、不存在的 npm 套件(幻覺)
- 改到一半跳去改無關的檔案
/statusline顯示 context > 70%
看到任何一個就該 /clear。
聰明的 session 規劃:
- 一個功能 = 一個 session:做完一個功能就清，不要一路累積
- 跨 session 延續:重要決策、進度寫進 CLAUDE.md 或暫時的
NOTES.md,下一個 session 重開還看得到 - 不要 /compact 太多次:每次 compact 都會失真一點，累積 3 次以上就直接 /clear 吧
- Plan 模式先跑一次:大任務進 Plan 模式讓它規劃，看完計畫再開新 session 執行，計畫會摘要在對話裡，不會佔太多
特殊技巧:「記憶接力」 做大專案的話，結束一個 session 前叫它:
把我們今天做了什麼、下一步該做什麼,寫進 NOTES.md下一次重開 session 第一句:
讀 NOTES.md 看上次做到哪裡,繼續這樣等於手動做了 session 之間的記憶接力，品質比 /compact 穩。
🆚 Claude Code vs Cursor vs GitHub Copilot(新手視角)
三個都是 AI 寫程式工具，但定位完全不一樣:
| Claude Code | Cursor | GitHub Copilot | |
|---|---|---|---|
| 形式 | 終端機 CLI | AI 原生 IDE(基於 VS Code) | 編輯器擴充(VS Code / JetBrains / Neovim) |
| 主打 | 自己做整件任務 | 邊寫邊聊、多檔同步改 | 即時補全 |
| 價格 | $20–100(跟 Claude 訂閱綁) | $20/月 | $10/月起 |
| 新手難度 | 中(要會用 terminal) | 低(長得像 VS Code) | 最低(裝上去就能用) |
| 最適合 | 做完整任務、後端、大重構 | 前端、快速疊代 | 日常補全、還不確定要不要進 AI |
給新手的建議:
- 完全沒用過 AI 寫程式 → 先裝 GitHub Copilot 感受一下即時補全
- 想要它幫你「做一整件事」 → 用 Claude Code
- 想要一個 AI 為主的編輯器體驗 → 用 Cursor
- 三個都想用?可以——不少開發者 Copilot 負責邊打邊補、Claude Code 負責做大任務
🚨 新手常見踩坑
這段先看，可以省你半天時間。
- 免費帳號用不了:Claude.ai 免費版不含 Claude Code。至少要 Pro($20/月)
- Windows 原生支援有限:某些環境仍建議走 WSL2,看 完全指南
- 不要亂按 yes:破壞性指令(
rm、git push --force、DB migration)會跳權限詢問。每次都看清楚再按 - context 不是越長越好:超過 70% 就 /clear,硬撐品質會爛
- 不懂的 npm package 名不要信:它有時會掰套件名(幻覺),裝之前先
npm info <name>確認 - 日常不要一直加 ultrathink:貴、慢、而且反而可能過度工程
- 小事不要開 Claude Code:「幫我寫一個反轉陣列的 function」——這種開 chat 更快
- CLAUDE.md 一定要寫:不寫就是讓 Claude 每次從零學你的專案，超級浪費
🧭 第一週的建議學習路徑
照這個順序來，不會亂:
- Day 1:裝起來，跑
claude --version,cd到一個你現有的專案，打claude,問它「這專案是什麼?」 - Day 2:讓它改一個小檔案(例如改 README 的 typo),感受一下「它會直接動手」
- Day 3:寫一個最基本的
CLAUDE.md,3–5 條規則就夠 - Day 4:試 Plan 模式(Shift+Tab),丟一個中等任務看它規劃
- Day 5:試
/clear、/compact、/statusline,搞清楚 context 管理 - Day 6:切一次
/model opus做個關鍵任務，感受差異；切/model haiku跑個批次小事 - Day 7:研究一個 Skill(pdf 或 commit),或自己寫一個最簡 SKILL.md
一週後，你應該已經能 80% 覆蓋日常開發工作流。進階玩法(subagents / hooks / MCP)再去看 Claude Code 完全指南。
❓ FAQ
Claude Code 完全沒寫過程式的人也能用嗎?
部分可以，部分不行。 不會寫程式的人可以用它做:
- 讀程式碼、解釋「這段在做什麼」
- 做簡單的 HTML / CSS 微調
- 整理文字檔、CSV、PDF 等資料
- 跑官方教程、照著 README 操作
但完全取代工程師仍不現實:你沒有程式基礎，看不懂它給的 diff、判斷不了它改對不對、出錯了不會除錯。建議還是先把「基礎程式語法」搞懂(任何一個語言都好),再用 Claude Code 會爆炸成長。
Claude Code 需要付費嗎?免費版可以用嗎?
需要訂閱，免費版不行。 選項:
- Pro $20/月:輕中度使用者夠用，大約一天 2–3 小時
- Max $100 / $200/月:重度使用者，開一整天不會撞額度牆
- Team / Enterprise:公司用，有 admin 管理
如果你還不確定值不值得，先訂 Pro 用一個月試試。
Claude Code 安全嗎?會不會偷改我的檔案?
安全等級可控。 Claude Code 預設會在每次破壞性動作(刪檔、改檔、跑 shell 指令)前問你一次。只要你不開 auto-accept / bypass 模式，它不會擅自動手。
風險主要在:
- 你亂按 yes,它就會照做
- 你把 API key 放在容易被讀到的地方(例如 terminal history、
.env沒加 gitignore) - 第三方 Skill 可能有惡意程式(只用信任來源的 Skill)
新手建議:保持預設權限模式、不開 bypass、敏感資料用環境變數管理、CLAUDE.md 裡註記哪些資料夾不能碰。
Claude Code 跟 ChatGPT 比哪個好?
看你要做什麼。 簡單說:
- 聊天問答、寫文章、做簡報大綱 → ChatGPT / Claude 網頁版都好
- 真的改程式、跑指令、做完一整件工程任務 → Claude Code 明顯強(因為它會動手)
目前 ChatGPT 也有 Agent / Code Interpreter 能力，但在「在你本地 codebase 操作」這件事上,Claude Code 仍是整合最深的。
我沒有 Mac,Windows 能不能用 Claude Code?
可以。Windows 原生 PowerShell 有支援(用 irm ... | iex 一行裝),但部分進階功能建議走 WSL2(Windows Subsystem for Linux)會比較順。完整步驟看 完全指南的安裝章節。
ultrathink 會燒很多錢嗎?
會，但沒到恐怖。 一次 ultrathink 可能多 3 萬 output tokens。用 Opus 的話，大約是 $0.45 左右的推理費用。一天用個 3–5 次關鍵任務完全可以接受，問題是有些新手看到「max 思考」就每次都加，這才會爆。
原則:只在真的關鍵、難、不可逆的任務才用 ultrathink。 日常預設、複雜一點加 think hard 就好。
Skill 跟 CLAUDE.md 我該用哪一個?
兩個併用最好，但判斷原則簡單:
- 每次都該知道的規則 → 寫 CLAUDE.md(會自動全局載入)
- 只在特定情境才用到的流程 → 做成 Skill(按需載入、用完即走)
舉例:「專案一律用 TypeScript、UI 用 shadcn」→ CLAUDE.md。「從客戶 PDF 抓財報做摘要」→ 做成 skill(只有處理那種任務時才觸發)。
📌 一句話總結
Claude Code 不是「更強的補全工具」,是「你終端機裡的 AI 工程師」。 新手第一週把 8 個功能、Plan 模式、CLAUDE.md、/clear 這四組東西練熟，就能覆蓋 80% 日常開發工作流。Thinking 模式、模型切換、Skill 這些是「讓你用得更好」的槓桿——不急，遇到對應情境再加。
最重要的心法只有一個:Claude Code 會真的動手，所以你要保持「看得懂它在做什麼」的能力。不懂的時候開 Plan 模式、context 長了就 /clear、有疑慮就不要按 yes。
進階內容(subagents、hooks、MCP、Plugin System)看 → Claude Code 完全指南。