不用會寫程式、不用懂終端機。這份教學從「申請帳號」開始，一步一步帶你在 Windows 或 Mac 裝好 Claude Code，最後教你怎麼跟它說話、裝上好用的 Skill。每一步都有按鈕可以直接點、指令可以一鍵複製。
Step 0 · Before you start
這三樣都準備好，後面就會非常順。沒有的話也別擔心，下面每一項都有連結。
Windows 10（1809 以後）或 Windows 11；Mac 需要 macOS 13 Ventura 以後。記憶體 4GB 以上就夠，需要能上網。
免費版不能用 Claude Code。最少要 Pro 方案（一個月約 20 美元），用量大可以選 Max。也可以改用按用量計費的 Console（API）帳號。
第一次看到黑色的終端機視窗很正常會緊張——它只是一個「打字下指令」的地方。照著複製貼上就好，打錯也不會弄壞電腦。
Step 1 – 5 · Install
先選你的電腦，下面的說明和指令會自動切換成對應版本。每做完一步就打勾，進度會記在你的瀏覽器裡。
Pro 和 Max 差在哪？功能一樣，差在「每 5 小時能用多少」。剛開始用 Pro 就夠，常常用到額度上限再升級 Max 就好。
兩種都是同一個 Claude Code，選你看起來比較不怕的那一種。
一行指令就裝好，功能最完整、更新最快，網路上的教學和 Skill 大多以它為準。這份教學接下來以它為主。
① （建議先做）安裝 Git for Windows——Claude Code 有它會更好用（可以執行更多種指令、也能幫你管理程式版本）。下載後一路按「Next」用預設值安裝即可。
② 打開 PowerShell：按鍵盤左下角的 ⊞ Win 鍵 → 打字輸入 PowerShell → 按 Enter。會跳出一個藍色或黑色的視窗，開頭寫著 PS C:\Users\你的名字>。不需要用「系統管理員」開啟。
③ 複製下面這行，貼進去按 Enter（在 PowerShell 裡按滑鼠右鍵就是貼上）：
irm https://claude.ai/install.ps1 | iex如果看到 'irm' 不是內部或外部命令，代表你開到的是「命令提示字元（CMD）」不是 PowerShell。沒關係，改貼這一行：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd① 打開「終端機」：按 ⌘ Command + 空白鍵 叫出 Spotlight → 輸入 終端機（或 Terminal）→ 按 Enter。會跳出一個白色或黑色的小視窗。
② 複製下面這行，貼進去按 Enter（貼上是 ⌘ + V）：
curl -fsSL https://claude.ai/install.sh | bash已經在用 Homebrew 的人也可以改用 brew install --cask claude-code。不知道 Homebrew 是什麼就用上面那行，最簡單。
畫面會跑一些文字，最後出現安裝成功的訊息就好了。裝完請把這個視窗關掉，再重新打開一個新的——這樣電腦才會「認得」新裝的 claude 指令。
在重新打開的終端機裡輸入這行，按 Enter：
claude --version看到類似 2.1.xxx (Claude Code) 的數字就代表成功了 🎉。想做完整健康檢查可以再跑：
claude doctor出現「找不到 claude」怎麼辦？九成是視窗沒有重開——把終端機全部關掉再開一次。還是不行，把電腦重新開機一次；重新登入一次 Mac；再不行就回到第 3 步重跑安裝指令，並把畫面上的錯誤訊息整段複製起來（下面「常見問題」有解法）。
Claude Code 會在「你所在的資料夾」裡工作，所以先幫它準備一個專屬資料夾，不要直接在整個桌面亂動。
cd ~\Desktop
mkdir my-first-project
cd my-first-project
claudecd ~/Desktop
mkdir my-first-project
cd my-first-project
claude以後每次要用：打開終端機 → 用 cd 進到你的專案資料夾 → 輸入 claude。登入只需要做一次。
Your first session
Claude Code 聽得懂中文，而且會自己看檔案、寫檔案、執行指令。你只要像交代同事一樣把需求講清楚。它每次要改檔案或執行指令前都會先問你，按 Enter 同意、按 Esc 拒絕。
幫我做一個單頁的個人名片網站，要有我的名字、簡介和聯絡方式，風格簡約好看，做完告訴我怎麼打開。
這個資料夾裡有很多照片，幫我依拍攝月份分到不同資料夾，先告訴我你打算怎麼做，我同意了再動手。
用國中生聽得懂的方式，解釋這個專案是在做什麼、主要檔案各負責什麼。
我執行時出現這個錯誤訊息（貼上錯誤），幫我找原因並修好，修完再跑一次確認。
① 說「要做什麼＋給誰用」② 說「做到什麼程度算完成」③ 大改之前加一句「先說你的計畫，我確認後再做」。
/init在專案資料夾裡輸入 /init，它會讀完整個專案，產生一份 CLAUDE.md 筆記。以後每次開啟都會先讀這份筆記，越用越懂你。你也可以自己在裡面寫規則，例如「回答一律用繁體中文」。
Cheat sheet
不用全背，先記住前六個就能用得很順。在輸入框打 / 會跳出所有指令清單。
/help看所有功能說明，迷路時先打這個。Esc立刻打斷它正在做的事。連按兩下可以回到之前的對話重來。Shift+Tab切換模式：一般 → 自動接受修改 → 計畫模式（只討論不動檔案，適合大改之前先想清楚）。/clear清空對話，換新任務時用，避免它被舊話題干擾。@檔名指定檔案，例如「幫我改 @index.html 的標題」。打 @ 會跳出檔案清單。claude -c在終端機用這個開啟，接續上一次的對話。claude -r 可以選更早的對話。/model切換 AI 模型。難的任務用強一點的模型，簡單的用快一點的。/compact對話太長時壓縮成摘要，省額度又不會忘記重點。/usage看目前用量，快到上限時就知道要休息一下或升級。!指令開頭打驚嘆號，直接執行終端機指令，結果它也看得到。/config設定：主題、語言、自動更新等等。/exit離開 Claude Code（或按兩次 Ctrl+C）。Skills & plugins
Skill 是一份「做事說明書」，教 Claude 用特定方法完成特定工作（例如「做出不像 AI 味的網頁」「幫我 commit 程式」）。它會在需要時自動派上用場，也可以打 /skill名稱 直接叫出來。Skill 通常打包在 Plugin（外掛）裡安裝。
/plugin 按 Enter，會打開外掛選單的「Discover（探索）」頁。frontend），用方向鍵選到它按 Enter 看介紹。Plugin is now active. 就能用了；若提示要重新載入，照畫面執行 /reload-plugins。以下都來自 Anthropic 官方外掛市集 claude-plugins-official，第一次開啟 Claude Code 就已經自動加好，不用另外設定。把指令貼進 Claude Code 的輸入框即可。
讓做出來的網頁、介面有設計感，避免一看就是 AI 做的樣板風格。
/plugin install frontend-design@claude-plugins-official一句話幫你存版本（commit）、推上 GitHub、開 PR，不用記 git 指令。
/plugin install commit-commands@claude-plugins-official要做比較大的功能時，它會先摸清楚專案、規劃架構，再一步步實作，不會亂改一通。
/plugin install feature-dev@claude-plugins-official改完程式先讓它幫你「挑毛病」，抓出 bug 和漏洞再上線，比較安心。
/plugin install code-review@claude-plugins-official跟它說「我想要一個每次都照我的格式寫週報的 Skill」，它會幫你寫好、測好。
/plugin install skill-creator@claude-plugins-officialAnthropic 官方的文件 Skill 合集：讀寫 Word、Excel、簡報和 PDF。要先加入它的市集，再安裝：
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills安全提醒：外掛可以執行程式，安裝前先看一下介紹頁寫了它會做什麼。只裝官方或你信任的人做的外掛，不要亂裝來路不明的市集。不想用了可以在 /plugin 的「Installed」分頁停用或移除。
一個 Skill 就是一個資料夾，裡面放一個叫 SKILL.md 的文字檔。放在下面這個位置，所有專案都能用：
%USERPROFILE%\.claude\skills\weekly-report\SKILL.md~/.claude/skills/weekly-report/SKILL.md檔案內容範例（最上面三條線之間是「說明卡」，告訴 Claude 什麼時候該用它）：
---
name: weekly-report
description: 當使用者要寫週報時使用，依固定格式整理本週進度。
---
請依照以下格式寫週報，全部用繁體中文：
1. 本週完成（條列，每條不超過 20 字）
2. 遇到的問題與解法
3. 下週計畫
語氣專業但口語，不要用艱深術語。存好之後在 Claude Code 輸入 /weekly-report 就能叫出來。懶得自己建？直接跟 Claude 說「幫我在 ~/.claude/skills 建一個寫週報的 Skill」，它會幫你做好。
Level up · Best practices
整理自 Anthropic 官方〈Best practices for Claude Code〉、Claude Code 開發團隊公開分享的用法，以及社群實戰經驗。最重要的一條只有一句話：給它一個「自己檢查對不對」的方法。
它覺得「看起來做完了」就會停。所以要說清楚怎麼算完成：「寫完跑測試，全部通過才算好」「做完截圖跟我的設計稿比對，列出差異並修好」。有驗收方法，你就可以離開座位；沒有，你就得自己一行一行檢查。也要它拿出證據（測試結果、截圖），不要只說「好了」。
大一點的改動先按 Shift+Tab 切到計畫模式，讓它只讀檔、不改檔，把計畫寫出來。你可以按 Ctrl+G 直接編輯計畫，同意後再開工。一句話講得完的小修改就不用這麼麻煩，直接叫它做。
對話太長它會開始忘東忘西。換新任務就 /clear；同一件事糾正它兩次還不對，別再糾正第三次——/clear 重開，把學到的教訓寫進新的第一句話，效果幾乎一定比較好。臨時小問題用 /btw 問，不會塞進對話裡。
它每次改檔前都會自動存檔點。按兩下 Esc 或輸入 /rewind 就能把對話和程式一起回到之前的狀態。所以可以放心叫它「試試看這個大膽的做法」。但它不能取代 git——用終端機指令改的東西不會被記錄，重要進度還是要 commit。
只寫它「猜不到」的事：要跑什麼指令、你們團隊的特殊規則、踩過的坑。每一行都問自己：「刪掉這行它會犯錯嗎？」不會就刪。它犯錯時，直接叫它「把這個教訓寫進 CLAUDE.md，以後不要再犯」——這是開發團隊自己最常用的習慣，文件會越用越值錢。
不知道怎麼把需求講清楚？讓它反過來問你問題，最後整理成規格書，再開一個新對話照規格書做（新對話的腦袋最乾淨）。下面有可以直接複製的咒語 ↓
剛寫完程式的它會偏袒自己的作品。改完先跑內建的 /code-review，或說「用一個子代理（subagent）幫我審查這次的改動，只回報會影響正確性的問題」。子代理在獨立的腦袋裡工作，不會把你的主對話塞爆。
一直按同意很煩？用 /permissions 把你信任的指令（例如跑測試、git commit）加入白名單，其他的照樣先問你。付費方案的「自動模式」會有另一個模型幫你擋掉危險動作。網路上教你「跳過所有權限」的設定，新手請不要用。
我想做 [一句話描述你的點子]。請用 AskUserQuestion 工具詳細訪問我。
問技術做法、畫面與操作、特殊情況、疑慮和取捨，不要問顯而易見的問題，
專挑我可能沒想到的難處。問到全部涵蓋為止，最後把完整規格寫進 SPEC.md。大雜燴對話一個對話裡做好幾件不相干的事，它會被舊話題干擾。解法：換任務就 /clear。一直糾正越改越亂，因為對話裡塞滿失敗的嘗試。解法：錯兩次就重開、寫更好的第一句。CLAUDE.md 太長規則太多，重要的反而被淹沒。解法：定期刪減，一定要遵守的改成 hook。看起來對就信程式看起來很合理，但特殊情況沒處理。解法：一定要測試或截圖驗證，驗證不了就不要上線。無限探索叫它「研究一下」卻沒說範圍，它讀了幾百個檔案。解法：說清楚範圍，或交給子代理去查。Real-world setup
這是我自己用 Claude Code 開發、經營一個多店家線上預約平台（正式上線、有真實付費店家）的配置。新手不用一次全做，先從第 1 項開始，遇到一樣的錯誤第二次時再往下加。
根目錄一份總綱，資料層、API 層、畫面層……各自再放一份，寫「這一層負責什麼、改 A 要一起檢查 B、這裡踩過哪些坑」。Claude 改到哪一層就讀哪一份，不會一次塞爆。還有一條鐵則寫在最上面：改了程式就要同步改說明書，文件過時比沒有文件更危險。
CLAUDE.md 是「建議」，hook 是「一定會發生」。我放了這幾支（都存在 .claude/settings.json，跟著專案一起進版控，同事拿到就自動生效）：
不會寫 hook 沒關係，直接叫它寫：
幫我在 .claude/settings.json 加一個 hook：每次執行 git push 之前先跑測試，
測試沒過就擋下來並告訴我哪裡失敗。寫完實際測一次給我看。放在 .claude/agents/，每個都是一份 .md 檔，寫它的角色和能用的工具：
---
name: qa-tester
description: 修 bug 之前先重現確認真偽；改完後寫測試並執行。
tools: Read, Grep, Glob, Bash, Edit, Write
---
你是資深測試工程師。收到疑似 bug 時：
1. 先寫一個會失敗的測試重現它，確認 bug 真的存在
2. 回報重現步驟與失敗訊息，不要自己動手修
3. 修好之後重跑，確認由紅轉綠，且相關舊測試沒有被弄壞我最常用的是 /bugfix-verify：丟給它一串疑似 bug，它會先證明 bug 真的存在（測試必須先紅）→ 才修 → 再證明修好（轉綠）且沒弄壞別的→ 更新文件 → commit。這條規則來自血淚教訓：只憑讀程式碼推理就動手改，細節錯誤率非常高。
Claude Code 會把「我的偏好、被糾正過的做法、進行中的工作」存成一則則小筆記，下次開新對話自動讀進來。例如我跟它說過一次「回覆我一律用繁體中文」「真實店家的資料不准拿來測試」，之後就不用再講。想看它記了什麼，直接問它「你記得我哪些事？」
寫 Java、TypeScript 這類程式語言的，建議裝官方的「程式碼智慧」外掛（在 /plugin 搜尋你的語言，例如 lsp），它能精準找到函式定義和所有引用處，大幅減少它「編造不存在的函式」。另外我讓終端機底下的狀態列顯示目前分支和用量，一眼就知道狀況。
我的心得：「多提醒它小心」沒有用，結構才有用。同一種錯誤出現第二次時，不要只修那一處，把它變成一個測試、一個 hook 或一條 CLAUDE.md 規則，讓它在物理上不可能再犯。
FAQ & troubleshooting
卡住的時候最快的方法：把錯誤訊息整段複製，貼到 claude.ai 的聊天視窗問「我照教學安裝 Claude Code 出現這個，怎麼辦？」
是的。Claude Code 需要 Pro、Max、Team、Enterprise 其中一種訂閱，或是 Console（API）帳號。免費版可以繼續在 claude.ai 網頁聊天，但無法登入 Claude Code。
這是 PowerShell 的安全設定擋住了。先貼上這行（只影響你自己的帳號），再重跑安裝指令：
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned問你是否要變更時，輸入 Y 按 Enter。
你把 CMD 版的指令貼到 PowerShell 了。請改用第 3 步的 PowerShell 版本：irm https://claude.ai/install.ps1 | iex。
① 先把所有終端機視窗關掉重開。② 還是不行，重開機。③ 若安裝時畫面有提示要把某個路徑（通常是 .local\bin 或 ~/.local/bin）加到 PATH，把那段提示複製起來，貼給 claude.ai 聊天視窗請它一步步教你加。
終端機畫面上會有一段很長的網址，把它整段複製，貼到瀏覽器網址列打開，登入後按授權即可。若畫面要求輸入代碼，把瀏覽器顯示的代碼貼回終端機。
預設每次要修改檔案或執行指令前都會先問你。建議：① 永遠在專屬的專案資料夾裡用，不要在整個桌面或系統資料夾啟動 ② 重要的專案先用 git 存版本（裝 commit-commands 外掛最簡單），改壞了可以一鍵回去 ③ 看不懂它要執行的指令時，先按 Esc 拒絕，問它「這個指令會做什麼？」
用這份教學的安裝方式會自動在背景更新，不用管它。想立刻更新可以在終端機輸入 claude update。用 Homebrew 安裝的要自己跑 brew upgrade claude-code。
可以。在 VS Code 的擴充功能市集搜尋「Claude Code」安裝官方擴充功能，側邊就會出現 Claude 面板。它和終端機版共用同一份登入與設定。