0%
課堂啟動與版本準備8
課堂操作30 分鐘最後確認 2026-07-24

課堂第 2 步:讓 Claude 半自動安裝 Node.js

Claude App 本身不需要 Node.js,但課程的 Next.js 排班網站需要它才能在本機 Preview。這一步讓 Claude 檢查環境、開啟官方頁面、下載並啟動圖形安裝程式;系統授權與密碼仍由學員本人處理。

08

學完這一課,你會做到

  • 說出 Claude App 與課程網站對 Node.js 的需求不同
  • 讓 Claude 先做只讀檢查,再半自動開啟官方頁面與安裝程式
  • 分辨 Claude 可以代辦的步驟,以及必須由本人確認的系統授權
  • 由 Claude 驗收 Node.js 與 npm 可用,再進入後續課程

開始前先定位

你在這裡課堂啟動與版本準備

先認識 Claude Code 介面並安裝 Node.js,再理解資料夾與 GitHub,最後把自己的 repo 帶進 Claude App,完成第一次 Review changes。

完成證據Checkpoint:環境已準備好

Claude 完成檢查、官方下載與安裝程式啟動;學員本人完成系統授權。重新啟動 Claude App 後,Claude 只讀回報 Node.js 至少為 20.9 與 npm 版本,而且沒有修改專案、安裝專案套件、…

本課先不做Computer use 是輔助,不是前提

如果帳號、方案、組織政策或電腦權限沒有 Computer use,Claude 就改成一次說明一個圖形步驟,由學員點擊;不影響完成本課。Computer use 會看見你允許的真實桌面內容,開始前要關閉病歷、信箱、…

本課名詞Node.jsnpmLTS安裝Claude AppNext.js

開始前先設定安全邊界

  1. 在 Claude App 的 Code 分頁建立新會話,選 Local 與講師指定的課程練習資料夾。
  2. 把左下角權限模式設為詢問權限;安裝軟體會影響整台電腦,不在這一步使用 Auto。
  3. 確認畫面沒有開啟病歷、診所共用硬碟、私人文件或含真實資料的 repository。
  4. 若方案支援,可在 Settings → General 開啟 Computer use,讓 Claude 操作圖形介面;只允許這次課程需要的瀏覽器、Finder/檔案總管與安裝程式。
  5. 貼上下方 Prompt。Claude 可以檢查版本、開啟官方頁面、下載並啟動安裝程式,但遇到正式安裝與系統授權時必須停下。

請 Claude 半自動安裝 Node.js

可直接使用的 Prompt
請協助我半自動安裝這堂課的網站專案需要的 Node.js。我是初學者,主要使用 Claude App,不自行操作 Terminal。

請先只做檢查,不要修改任何設定或專案:
1. 判斷我是 Windows 還是 macOS,並確認處理器應使用 x64 或 ARM64。
2. 檢查 node 與 npm 是否可用,回報完整版本。
3. 本課使用 Next.js 16,Node.js 至少需要 20.9;如果已符合,告訴我不必重裝並停下。

如果缺少或版本太舊:
4. 只能使用 Node.js 官方繁體中文頁 https://nodejs.org/zh-tw/download,並選擇 LTS。
5. 可以替我開啟官方頁面、選擇正確作業系統與處理器、下載並開啟圖形安裝程式:macOS 使用 .pkg,Windows 使用 .msi。
6. 不要使用 nvm、Homebrew、Chocolatey、WinGet 或其他 Terminal 安裝方式。
7. 遇到管理員密碼、Windows UAC、授權條款、安裝位置或正式安裝按鈕時必須停下,先用繁體中文說明畫面與影響,等我本人確認。不得要求、讀取、記錄或代替我輸入任何密碼。
8. 安裝期間不要執行 npm install、不要啟動 Preview、不要修改專案、不要 commit、不要 push。
9. 安裝完成後提醒我完全關閉並重新開啟 Claude App,再只讀檢查 node 與 npm 版本,用繁體中文回報是否通過。

這一步誰負責什麼

Claude 可以代辦學員本人必須處理
檢查作業系統、處理器、node 與 npm 版本確認 Claude 判斷的是目前這台課程電腦
開啟 Node.js 官方頁並選 LTS核對網址確實是 nodejs.org
下載並開啟 .pkg 或 .msi閱讀授權條款、確認安裝位置與正式安裝
安裝後重新檢查版本親自處理 macOS 管理員密碼或 Windows UAC

macOS:略過 nvm 指令,選圖形安裝程式

Node.js 官方繁體中文下載頁,顯示 LTS 版本、nvm 指令區與 macOS 安裝程式按鈕。

Node.js 官方下載頁會先顯示 nvm 指令,但本課不走 Terminal。往下找到「或者取得」區塊,確認作業系統與平台後點 macOS 安裝程式(.pkg)。版本號會更新,以頁面標示 LTS 為準。

  1. 網址必須是 nodejs.org/zh-tw/download
  2. 版本選 LTS,不選 Current/latest improvements。
  3. 忽略 nvm 與 Bash 指令區,本課不要求貼指令。
  4. Apple Silicon Mac 通常選 ARM64;Intel Mac 選 x64。不確定時先請 Claude 說明,不要猜。
  5. 可讓 Claude 下載並開啟 macOS 安裝程式(.pkg);到授權、安裝位置、正式安裝或密碼畫面時由本人接手。

Windows:略過 Chocolatey 指令,選 .msi

Node.js 官方繁體中文下載頁切換為 Windows 與 x64,顯示 LTS 版本、Chocolatey 指令區和 Windows 安裝程式按鈕。

Windows 學員在「或者取得」區塊選 Windows;多數 Intel/AMD 電腦使用 x64,再點 Windows 安裝程式(.msi)。不要複製上方 Chocolatey/PowerShell 指令。

  1. 作業系統選 Windows,版本保持 LTS。
  2. 大多數 Windows 電腦選 x64;只有確定是 Windows on ARM 才選 ARM64。
  3. 忽略 Chocolatey 與 PowerShell 指令區。
  4. 可讓 Claude 下載並開啟 Windows 安裝程式(.msi);到授權、正式安裝或 UAC 畫面時由本人接手。
  5. 若出現管理員權限提示,由本人確認程式來源;不要把系統密碼交給 Claude、助教或同學。

安裝完成後交給 Claude 驗收

  1. Claude 開啟安裝程式後,依約在授權條款、正式安裝、管理員密碼或 UAC 前停下;由本人閱讀並確認。
  2. 完成安裝精靈後,完全關閉 Claude App,再重新開啟,讓 App 讀取新的系統環境。
  3. 回到原會話告訴 Claude「我已完成安裝,請依原本約定只檢查 node 與 npm 版本」。
  4. 看到 Node.js 20.9 或更新版本,以及一個 npm 版本號,即符合目前 Next.js 16 課程模板的最低需求;新安裝通常會是當期 LTS。
  5. 若仍顯示 command not found 或找不到 node,先截取已去識別的錯誤文字請助教處理,不要重複下載不同安裝器。
  6. 通過後先停下,不在本課執行 npm install、Preview、commit 或 push;後續會由講師逐步帶領。

常見卡點與處理方式

畫面先做什麼不要做什麼
官方頁顯示 nvm/Chocolatey 指令往下找 .pkg/.msi 圖形安裝程式不要複製指令
不知道 ARM64 或 x64請 Claude 只說明如何從系統資訊確認不要亂裝兩個版本
安裝後仍找不到 node完全關閉再重開 Claude App,保留完整錯誤不要連續重裝或更改 PATH
需要管理員密碼或 UAC由本人在官方安裝流程中處理,或請電腦管理者協助不要讓 Claude 讀取、記錄或代替輸入密碼
Computer use 不可用讓 Claude 一次說明一個圖形步驟,由學員點擊不要為了開啟功能而借用帳號或繞過組織政策

Checkpoint:環境已準備好

Claude 完成檢查、官方下載與安裝程式啟動;學員本人完成系統授權。重新啟動 Claude App 後,Claude 只讀回報 Node.js 至少為 20.9 與 npm 版本,而且沒有修改專案、安裝專案套件、commit 或 push。

參考資料

介面與方案會改版;實際操作仍以各工具官方頁面為準。延伸資料用來幫助理解,不取代本課安全原則。

低壓力自我檢查

Claude 已開啟 Node.js 安裝程式,接著出現管理員密碼或 Windows UAC,應該怎麼做?

準備好再標記完成完成狀態會留在這台裝置,下次回來可接著學。