- 這頁回答四件事: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(安裝需求、方案限制、指令與檔案位置以官方最新說明為準)