- 這頁回答四件事：Claude 跟 Claude Code 在手機／電腦上各長什麼樣、專案資料夾要放桌面還是 C 槽、開工前一定要完成哪些設定、Git 與 Node.js 為什麼非裝不可。
- 最短路徑：裝桌面版 Claude App → 點上方中央的 Code 分頁 → 選一個全英文、不被雲端同步的資料夾 → 裝 Git（Mac 要多一步 Xcode 命令列工具）→ 之後要部署網站再裝 Node.js。
- 卡住不要硬撐：終端機打
claude doctor會直接告訴你哪裡壞掉，或看本頁最後的「常見卡關」對照表。
1我到底該點哪一個？Claude 跟 Claude Code 差在哪
十個學員有八個卡在這裡：打開 App 之後不知道要點哪個分頁，然後在「聊天」那一欄叫 Claude 幫他改檔案，當然改不動。這兩個是同一個帳號、不同的工作區。
| Claude（聊天） | Claude Code | |
|---|---|---|
| 它能做什麼 | 對話、寫文案、看圖、查資料 | 直接讀寫你電腦裡的檔案、跑指令、做網頁、部署上線 |
| 會不會動到我的檔案 | 不會，它看不到你的硬碟 | 會。所以一定要先指定「工作資料夾」 |
| 要不要付費 | 免費方案就能用 | 要 Pro / Max / Team / Enterprise。免費方案沒有這個功能 |
| 我們上課用哪個 | 查資料、想文案時用 | 本課程主要都在這裡 |
各版本的畫面：符號長這樣、位置在這裡
以下為版面示意圖（非實機截圖），重點是記住「分頁在畫面的哪個位置」。官方改版時位置可能微調，但 Code 這個字不會變。
Chat｜Cowork｜Code。上課請一律點 Code。點下去若跳出升級提示，代表你的帳號還是免費方案。
Code。手機不會在你手機上跑程式，它是遙控器：遙控雲端，或遙控你自己開著的電腦。
claude。瀏覽器版在 claude.ai/code。本課程用桌面 App 就夠，這兩個等你想跑自動化再說。
| 你手上的裝置 | Claude Code 在哪裡 | 備註 |
|---|---|---|
| Mac 桌機／筆電 | 桌面 App 上方中央 → Code | Applications 打開 Claude，Intel 與 Apple 晶片同一個安裝檔 |
| Windows 桌機／筆電 | 桌面 App 上方中央 → Code | 開始功能表打開 Claude；一般是 x64 版，ARM 機型下載 ARM64 版 |
| iPhone／iPad | Claude App 下方分頁 → Code | App Store 搜「Claude by Anthropic」；iPad 裝同一支 iOS App |
| Android | Claude App 下方分頁 → Code | Google Play 搜「Claude」 |
| 任何瀏覽器 | claude.ai/code | 免安裝，適合臨時借別人電腦 |
| 終端機 | 指令 claude | 要另外安裝，見本頁第 4 節 |
👉 小結：電腦看上面、手機看下面，認「Code」這個字。看不到 Code 分頁，九成是帳號還在免費方案，不是 App 壞掉。
2專案資料夾要設在哪？放桌面還是 C 槽？
先講結論，再講為什麼：不要放在會被 OneDrive 或 iCloud 同步的桌面。建一個專門的資料夾，之後所有作品都丟進去。
C:\claude\ ├─ my-site\ ← 第一個作品 ├─ price-tool\ ← 第二個作品 └─ client-page\ ← 第三個作品
在 C 槽根目錄按右鍵 → 新增資料夾 → 命名 claude。路徑短、沒有中文、沒有空白、不會被雲端同步。
/Users/你的帳號/claude/ ├─ my-site/ ├─ price-tool/ └─ client-page/
Finder 按 Shift + Command + H 回到個人資料夾，在那裡新增 claude。避開「桌面」與「文件」，那兩個預設會被 iCloud 同步。
為什麼不建議放桌面？
| 你會遇到的狀況 | 實際發生什麼事 |
|---|---|
| 存檔後檔案被鎖住 | OneDrive／iCloud 正在上傳那個檔，Claude 同時要寫入，兩邊打架，出現「檔案正由另一個程式使用」 |
| 同步轉圈圈轉不完 | 做網站會產生 node_modules 這種內含幾萬個小檔的資料夾，同步軟體會一個一個傳，電腦直接卡死 |
| 路徑有中文和空白 | Windows 的桌面實際路徑是 C:\Users\你\OneDrive\桌面\，中文字與空白常讓部署指令噴錯 |
| 在別台電腦不見了 | 雲端空間滿了、或同步暫停，檔案會顯示成「僅線上可用」，Claude 讀不到內容 |
已經放在桌面、而且用得好好的人，不用急著搬——上面四種狀況出現任何一種再搬就好。搬的時候整個資料夾剪下貼上到 C:\claude\，再回 Claude Code 重新選一次資料夾即可。
資料夾命名三條規矩
- 全部小寫英文，不要中文：
price-tool✓ ／價格工具✗ - 用短橫線代替空白：
my-first-site✓ ／my first site✗ - 一個作品一個資料夾，不要十個作品全塞同一層。之後 Claude 才分得清哪個檔案是哪個案子的。
👉 小結：一個 claude 母資料夾，底下一個作品一個子資料夾，全英文小寫，離開雲端同步區。這件事花你三分鐘，可以省掉之後三小時的鬼打牆。
3Claude 必做設定：開工前的八個勾
照這張表由上往下做一次，做完就可以正式上課。第 6、7 項是差別最大的兩項——很多人覺得「Claude 講話怪怪的、每次都要重講一遍」，就是漏了這兩個。
| 設定項目 | 在哪裡做 | 怎麼確認做好了 | |
|---|---|---|---|
| 1 | 訂閱方案 | claude.ai 登入後 → 設定 → 方案。Claude Code 需要 Pro / Max / Team / Enterprise | 點 Code 分頁不會跳升級提示 |
| 2 | 登入同一個帳號 | 桌面 App 與手機 App 用同一個帳號登入 | 手機 Code 分頁看得到電腦上的工作階段 |
| 3 | 選工作資料夾 | Code 分頁 → 環境選 Local → Select folder → 選第 2 節建的資料夾 | 畫面上方看得到資料夾路徑 |
| 4 | 選模型 | 送出鍵旁邊的下拉選單 | 上課前老師會統一說今天用哪一顆 |
| 5 | 權限模式 | 送出鍵旁邊的模式選單，或按 Shift + Tab 循環切換 | 見下方說明，新手先用 Manual 或 Accept edits |
| 6 | 建立 CLAUDE.md | 在對話框輸入 /init，它會自己讀專案然後寫一份 | 資料夾裡出現 CLAUDE.md |
| 7 | 鎖定繁體中文＋你的身分 | 把下方範本貼進 ~/.claude/CLAUDE.md（個人版，所有專案通用） | Claude 回你繁體中文，而且知道你是誰 |
| 8 | 健檢 | 終端機輸入 claude doctor（只有裝了 CLI 才需要） | 沒有紅字警告 |
權限模式：這四個選項決定它會不會先問你
| 模式 | 行為 | 什麼時候用 |
|---|---|---|
| Manual | 每改一個檔案都先問你，你按同意才動 | 第一次上課建議用這個，看清楚它到底改了什麼 |
| Accept edits | 改檔案不問，跑指令才問 | 熟了之後最順手的一檔 |
| Plan | 只規劃、完全不動檔案 | 大改造之前，先叫它講清楚要怎麼改 |
| Auto | 由背景判斷，只擋危險動作 | Pro／Max／Team 方案的預設值，做熟的例行工作才用 |
個人版 CLAUDE.md 範本（複製去改成你自己的）
這份放在 ~/.claude/CLAUDE.md（Windows 是 C:\Users\你的帳號\.claude\CLAUDE.md），所有專案都會自動吃到，等於幫 Claude 建一張你的名片。在 Claude Code 裡直接說「幫我把這段寫進我的個人 CLAUDE.md」就行，不用自己找資料夾。
## 語言 - 一律使用繁體中文回答，程式碼註解也用繁體中文。 ## 我是誰 - 我是（你的職稱／行業），主要服務（你的區域或客群）。 - 我的聯絡方式：（電話／官方 LINE）。 ## 我的工作習慣 - 做網頁一律做成單一 HTML 檔，可以直接點兩下打開。 - 每個網頁都要先顧手機版，交付前用 375 寬檢查一次。 - 網頁頁尾一律附上我的姓名、聯絡方式與法定應揭露資訊。 ## 不要做的事 - 不要用我沒講過的資料編造數字。 - 不確定的地方先問我，不要自己假設。
順手記起來的幾個指令
| 指令 | 作用 |
|---|---|
/init | 讓 Claude 讀過整個資料夾，自動生一份專案的 CLAUDE.md |
/memory | 打開所有記憶檔來看、來改，也可以開關「自動記憶」 |
/context | 確認這次對話到底吃到哪幾個 CLAUDE.md（設定沒生效時第一個查這個） |
/config | 模型、自動更新頻道等偏好設定 |
/clear | 清掉這次對話重來（檔案不會被刪） |
/mobile | 跳出 QR Code，掃了直接去下載手機 App |
/help | 忘記指令就打這個 |
👉 小結：設定的重點不是「裝好」，是「讓它知道你是誰、聽得懂你的規矩」。第 6、7 項的 CLAUDE.md 寫得越具體，你之後每次開工少講十句話。
4環境安裝：Git、Mac 的額外一步、Node.js
- 桌面版 Claude App 本身不需要你先裝任何東西，它已經內建 Claude Code。
- Git：強烈建議裝。Windows 上沒裝 Git，Claude 少掉一整組 Bash 指令能力；另外你的作品要存檔、要回上一版、要放 GitHub，都靠它。
- Node.js：等你要把網頁部署上線（Netlify、Cloudflare）或要裝終端機版 Claude Code 才需要。
(a) Git 怎麼裝
- 開
git-scm.com/downloads/win，下載 64-bit 安裝檔。 - 安裝過程全部按 Next 就好，不用改任何選項。
- 裝完重開 PowerShell，輸入
git --version，有跳出版本號就成功。
裝 Git for Windows 會順便給 Claude Code 一個叫 Git Bash 的環境，Claude 才能用 Bash 指令；沒裝的話它會改用 PowerShell，多數教學範例的指令就得換寫法。
- 打開「終端機」（Terminal）。
- 輸入
git --version按 Enter。 - 如果跳出安裝視窗，按「安裝」，等它跑完（就是下面 (b) 說的 Xcode 命令列工具）。
- 跑完再輸入一次
git --version確認。
也可以到 git-scm.com/downloads/mac 下載，或裝了 Homebrew 之後用 brew install git。
Git 裝完，做一次就好的設定
git config --global user.name "你的名字" git config --global user.email "你的Email"
這兩行是在檔案的修改紀錄上簽名用的，沒設定的話之後存檔會一直跳警告。跟 GitHub 有沒有帳號無關，先設就對了。
(b) 蘋果（Mac）還要多裝什麼
| 項目 | 要不要裝 | 怎麼做／為什麼 |
|---|---|---|
| Xcode 命令列工具 Command Line Tools |
必裝 | 終端機輸入 xcode-select --install，跳視窗按「安裝」。Mac 的 git 就藏在這包裡面，沒裝就沒有 git，很多工具也跑不起來。約 1～2 GB，網路慢的話請提早裝好，不要留到上課當天。 |
| Homebrew | 建議 | Mac 的軟體管家。裝了之後要什麼打一行就好，例如 brew install node。安裝指令去 brew.sh 首頁複製那一長串貼到終端機。 |
| 隱私權授權 | 視情況 | 第一次讓 Claude 讀「桌面／文件／下載」裡的檔案時，macOS 會跳出詢問視窗，要按允許。不小心按了拒絕，去「系統設定 → 隱私權與安全性 → 檔案與資料夾」把它打開。 |
| 系統版本 | 檢查 | 需要 macOS 13 以上。左上角蘋果 →「關於這台 Mac」看得到版本。太舊的機器請先更新系統。 |
Windows 這邊對應的門檻是 Windows 10（1809 版）以上，記憶體 4GB 以上。近五年的機器基本上都過。
(c) 為什麼要裝 Node.js？那些記錄檔又是幹嘛的？
Node.js 是「讓你的電腦看得懂 JavaScript」的引擎。你平常寫網頁，JavaScript 是跑在瀏覽器裡的；但有一大票工具是用 JavaScript 寫的、而且要在你的電腦上跑——沒有 Node.js，這些工具就完全叫不動。我們課堂上會用到的至少有三類：
| 你想做的事 | 為什麼會用到 Node.js |
|---|---|
| 把網頁部署上線 | Netlify、Cloudflare 的部署工具都是 npm 套件，指令長這樣：npx netlify deploy、npx wrangler pages deploy |
| 本機預覽 | 要在電腦上開一個臨時網址看成品（而不是直接點兩下開檔案），靠的是 Node 起的小型伺服器 |
| 裝終端機版 Claude Code | 走 npm 安裝這條路的話需要 Node.js 22 以上：npm install -g @anthropic-ai/claude-code |
- 開
nodejs.org，下載標示 LTS 的版本（LTS＝長期支援，穩定版，不要抓最新的實驗版）。 - Windows 下載
.msi、Mac 下載.pkg，一路按下一步。 - 重開終端機，輸入
node -v與npm -v，兩行都有版本號就成功。
Mac 有 Homebrew 的話，一行 brew install node 也可以。
npm：跟著 Node 一起裝好的套件管理員，負責下載工具。npx：不安裝、直接跑一次某個工具。我們部署網頁大多用這個，用完不留垃圾。node_modules/：工具的零件倉庫，動輒上萬個檔案。可以整個刪掉，下次跑指令會自己重建——這也是為什麼它不該待在雲端同步資料夾裡。
記錄檔：Claude 會偷偷幫你留下這些，別亂刪
很多人以為關掉視窗對話就沒了，其實不是。Claude Code 在背後留了好幾種檔案，這也是它「下次還記得你」的原因：
| 檔案／資料夾 | 作用 | 能不能刪 |
|---|---|---|
CLAUDE.md放在專案資料夾裡 |
這個案子的規矩：要用什麼風格、頁尾放什麼、哪些字不能寫。每次對話開頭都會被讀一次 | 不要刪。這是你最重要的資產，寫得越清楚，Claude 越像你的員工 |
~/.claude/CLAUDE.md個人版，在你的使用者資料夾 |
跨所有專案的個人規矩：語言、身分、聯絡方式、慣用做法 | 不要刪。第 3 節的範本就是寫在這裡 |
| 對話記錄 ~/.claude/projects/… |
每一次對話的完整逐字記錄。所以你隔天可以接著昨天講（終端機用 claude -c 續接、claude -r 挑一則舊的） |
可以刪，但刪了就接不回昨天的進度。它預設也會自己清掉太舊的 |
| 自動記憶 …/memory/MEMORY.md |
你糾正過它的事、你的偏好，它會自己記下來，下次不用你再講一遍。想看寫了什麼就打 /memory |
可以刪也可以改，它就是純文字檔。覺得它記錯了就直接改掉 |
node_modules/ |
Node 工具的零件倉庫 | 可以整包刪，需要時會自己長回來 |
.git/ |
Git 的版本歷史，你改壞了要回上一版靠它 | 不要刪，刪了所有歷史版本一起沒 |
👉 小結：Git 管「你的檔案改了什麼」，Node.js 管「工具跑不跑得起來」，記錄檔管「Claude 記不記得你」。三件事各司其職，缺一個就會有一種你搞不懂的卡關。
5常見卡關：學員最常問的六題
CLAUDE.md。對話裡講的話只在這次有效，寫進 CLAUDE.md 才會每次開場都被讀到。打 /context 可以確認這次到底有沒有吃到那個檔案。claude doctor，它會列出安裝與設定的問題；② 確認 git --version、node -v 是不是都有版本號；③ 還是不行就把紅字整段截圖丟進 Claude 對話框問它——這是它最擅長的事。👉 小結：設定卡關九成不是你笨，是少了一個前置條件。把上面三個檢查指令跑過一輪，通常自己就找得到答案。
資料來源：Anthropic 官方文件 code.claude.com/docs（安裝需求、方案限制、指令與檔案位置以官方最新說明為準）