Claude Code 遠端 Mac 安裝應直接放在存放專案、執行命令的那台遠端 Mac 上；本週先採官方推薦的原生安裝，再完成版本檢查、環境診斷與安全登入，最後用可丟棄的小專案驗收權限。這套做法適合已經取得遠端 Mac、但不熟悉終端機和 AI 程式設計工具的學生。
最後更新於 2026 年 9 月 1 日；系統支援、安裝方式、登入資格與診斷流程已按官方安裝與認證文件、官方命令列參考及官方權限說明核實。
只有 Windows 電腦、需要 macOS 學習程式設計的學生，適合閱讀本文。已租用遠端 Mac、但不熟悉終端機，或只想短期試用 Claude Code 再決定學習環境的人，也可以依時間線逐步操作。
先分清楚三個角色
已經連上遠端 Mac，卻把 Claude Code 裝在本地 Windows，是新手最容易遇到的錯誤。這時工具只會看到 Windows 的檔案與 Shell，當然找不到遠端 Mac 裡的專案。
可以把整個環境想成一間教室：
- 遠端桌面是教室的大螢幕，負責顯示 macOS 桌面、終端機與瀏覽器。
- SSH是進入教室的側門，通常只提供文字介面；Apple 的官方 SSH 遠端登入說明可用來核對登入邊界。
- Claude Code像助教，必須在真正放著課程專案的遠端 Mac 裡工作。
因此，若專案位於遠端 Mac 的個人資料夾，Claude Code 也必須在同一台主機、同一個遠端帳戶的終端機中安裝與啟動。Windows 上的終端機只能當作入口，不能取代遠端 Mac 的開發環境。若還沒有遠端 Mac，可先參考 NodeMini 的遠端 Mac 學習環境介紹，了解遠端桌面、SSH 與瀏覽器控制台各自負責的工作。
| 連線方式 | 適合做什麼 | 新手要確認的事 |
|---|---|---|
| 遠端桌面 | 開啟終端機、瀏覽器、編輯器，查看圖形介面 | 確認看到的是遠端 macOS，而非本地 Windows |
| SSH | 低頻寬下執行命令、查看檔案、進行文字操作 | 登入帳戶必須與圖形桌面使用的帳戶一致 |
| 兩者搭配 | 用 SSH 執行指令，用遠端桌面處理授權與檔案檢查 | 專案目錄、Shell 環境與登入帳戶不可混用 |
官方文件已確認 Claude Code 支援 macOS，並將原生安裝列為目前推薦路線；至於特定 macOS 下限、可用帳戶資格和發布渠道可能調整，不能把舊文章中的固定要求當成永久規則，應以發布當日的官方頁面為準。
遠端工作目錄與連線檢查
首次進入遠端 Mac 後，不要立刻貼上安裝命令。先確認「目前坐在哪張書桌前」：也就是登入使用者、目前位置和寫入權限。
可在遠端終端機逐行執行：
whoami
pwd
touch ~/claude-code-check.txt
rm ~/claude-code-check.txt
whoami 應顯示預期的遠端帳戶；pwd 應位於個人目錄或個人專案路徑；建立與刪除測試檔案成功，才代表該位置可寫。若結果顯示系統資料夾、共享資料夾或不熟悉的帳戶，應先停止，不要用管理權限硬闖。
遠端桌面終端機與 SSH 終端機都可以操作，但兩邊若登入不同帳戶，看到的 ~ 可能不是同一個地方。這會造成「桌面上明明有檔案，Claude Code 卻看不到」的假象。
建議為學習建立獨立目錄：
mkdir -p ~/learning-projects/first-claude-task
cd ~/learning-projects/first-claude-task
pwd
理想輸出會是遠端帳戶底下的 learning-projects 路徑。若 mkdir 或 cd 失敗，先處理帳戶和目錄問題；不要把練習檔案放進系統目錄，也不要在學校或他人共用的資料夾中測試 AI 編輯。
Claude Code 遠端 Mac 安裝路線
Claude Code 遠端 Mac 安裝時，優先使用官方目前推薦的原生方式，不要把論壇腳本、網路硬碟檔案或聊天訊息中的一鍵指令當成可信來源。安裝前應開啟官方文件，核對網域、命令和當日更新說明；網路若經過學校代理伺服器，也要參考官方代理與網路設定說明。
| 安裝路線 | 適合情況 | 主要取捨 |
|---|---|---|
| 官方原生安裝 | 第一次使用、希望依照目前推薦流程部署 | 步驟會隨官方文件更新，不能照抄多年以前的教學 |
| Homebrew | 遠端 Mac 已經有可信的套件管理習慣 | 更新和路徑由套件管理方式影響，需知道自己安裝到哪裡 |
| npm | 已經熟悉 Node.js 與 npm 的學習者 | 需要額外核對 Node.js、套件路徑與版本相容性，不適合盲目照做 |
原生安裝命令必須以官方頁面當日顯示內容為準。若官方文件仍提供下列形式，才在核對來源後執行：
curl -fsSL https://claude.ai/install.sh | bash
這類管線命令會下載並執行網路內容，因此「網址正確」和「來源可信」是前置條件，不是執行後才補做的檢查。若不確定目前命令是否仍有效，回到官方安裝頁核對，不要用搜尋結果中的複製版本。
安裝失敗時，按以下順序排查：
- 網路存取：終端機是否能連到官方服務，學校網路是否攔截必要網域。
- 目錄權限：執行檔是否寫入目前帳戶可管理的位置。
- Shell 環境：目前終端機是否載入安裝後的路徑。
- 帳戶一致性：安裝時和之後啟動 Claude Code 是否為同一個遠端帳戶。
- 版本狀態：不要只看命令沒有報錯，還要做明確驗證。
若選用 Homebrew 或 npm，應把它當成替代路線，而不是同時安裝多個版本。Node.js 是否需要、所需版本及更新方式，應依當日官方文件和所選渠道確認；原生路線與 npm 路線的要求不能混在一起。
版本、診斷與瀏覽器授權
安裝完成後，先檢查命令是否真的可用。官方命令列文件提供版本檢查與環境診斷方向，可依當日文件執行：
claude --version
claude doctor
成功的判斷不是「終端機沒有顯示紅字」，而是能取得版本資訊，且診斷結果沒有指出命令路徑、權限或環境錯誤。若顯示 command not found，先重新開啟遠端終端機，再確認目前帳戶與安裝帳戶相同；若仍失敗，回到 Shell 路徑和官方安裝步驟，不要隨意下載另一份執行檔。
接著在遠端 Mac 啟動 Claude Code：
cd ~/learning-projects/first-claude-task
claude
登入通常會引導使用瀏覽器完成授權。若使用遠端桌面，可以直接在遠端 macOS 開啟瀏覽器；若目前只有 SSH，授權頁未能自動返回時，應依官方文件顯示的安全流程完成，不要把包含授權內容的網址貼到公開群組，也不要請他人代登入。
可用帳戶資格、登入方式和授權頁面都可能因官方發布狀態改變。學生應以官方文件當日說明為準，不應把個人帳戶、學校帳戶或 API 金鑰交給同學共用。金鑰不可寫進作業、聊天記錄、截圖或公開版本庫；若課程要求使用環境變數，也要先確認檔案不會被提交。
第一個可丟棄專案
首次任務不要直接交給 Claude Code 一個正式作業或含個人資料的專案。可先建立一個只有練習檔案的小目錄，讓學生觀察工具如何讀取、提出計畫和請求操作。
例如建立簡單檔案：
cd ~/learning-projects/first-claude-task
printf 'print("hello")\n' > hello.py
ls
進入 Claude Code 後，先要求它說明檔案結構和可能的執行方式，再讓它提出修改計畫。這個階段的重點不是提示詞技巧，而是檢查它是否讀到了遠端 Mac 的檔案。
權限可以分成三層理解：
- 讀取檔案：工具查看程式內容，學生檢查它引用的檔案是否正確。
- 修改檔案：工具提出或套用變更，學生先看差異，再批准有限範圍。
- 執行命令：可能改變檔案、安裝套件或影響環境，第一次不應啟用無邊界自動操作。
每次要執行有影響的命令，都先問三件事：會改哪個檔案、會不會下載內容、失敗後能否復原。官方權限與存取控制說明可用來核對目前授權模式；學生不應為了讓流程「順利」而關閉安全確認。
最後以可驗證結果收尾：
git diff
python3 hello.py
若環境沒有使用 Git，至少要逐一查看檔案內容，確認程式能執行，並檢查修改是否只發生在練習目錄。看到 AI 回覆「已完成」不等於任務完成；程式差異、執行結果或課程測試才是驗收依據。
結束工作與學習週期判斷
退出會話前，先確認專案仍在個人目錄或已提交至個人版本庫，並重新開啟終端機檢查檔案是否找得到：
cd ~/learning-projects/first-claude-task
ls -la
pwd
若退出後檔案消失，可能是使用了暫存目錄、另一個帳戶，或遠端環境本身有清理規則。此時先保存重要程式碼，再決定是否繼續使用。原生安裝、Homebrew 和 npm 的更新方式可能不同，實際命令應回到官方文件核對，不要混用多套更新指令。
| 驗收結果 | 下一步 |
|---|---|
| 版本可查、診斷正常、專案可保存 | 依課程需要繼續使用目前遠端 Mac |
| 能操作但 SSH 或桌面連線不穩 | 先調整連線方式與專案保存流程，再增加使用時間 |
| 安裝、授權或權限仍不清楚 | 暫緩正式作業，先用小專案重做驗收 |
| 只需要短期完成指定課程 | 先按課程週期評估，不急著購買長期設備或工具 |
對於還在摸索 Python、前端或 AI 輔助程式設計的學生，遠端環境的價值在於先驗證學習流程；如果之後每天都要長時間使用、需要穩定保留大量檔案，則應另外比較自購 Mac、本地電腦和其他雲端方案，而不是把短期租用當成永久替代品。
新手 FAQ
Node.js 與原生安裝的關係
不應因為看到舊教學使用 npm，就認定 Claude Code 必須先安裝 Node.js。原生安裝和 npm 安裝是不同渠道，前者是否需要額外執行環境、後者的 Node.js 要求及更新方式，都要以官方入門文件發布當日的內容為準。
遠端瀏覽器未完成授權
瀏覽器授權沒有自動返回時，先確認瀏覽器是在遠端 Mac，而不是本地 Windows。若只有 SSH，應依官方登入流程安全完成授權；不要複製含有個人授權資訊的網址，也不要以公開貼出金鑰的方式繞過登入。
找不到 Claude Code 命令
先以 whoami 和 pwd 確認帳戶及目錄，再重新開啟終端機，執行官方提供的版本檢查和診斷命令。若安裝檔在另一個帳戶或 Shell 沒有載入路徑，重新安裝未必能解決問題；應先修正環境歸屬。
修改遠端專案的安全邊界
Claude Code 可以處理遠端 Mac 上的專案，但前提是目前帳戶具備相應的檔案權限。新手應從可丟棄目錄開始，先批准讀取和計畫，再逐項批准檔案修改與命令執行，並以差異和測試結果確認沒有超出預期範圍。
完成第一個練習後，學生可以比較目前方案與本地 Mac：Windows 加遠端連線通常會多出帳戶混用、瀏覽器授權、檔案保存和網路穩定性等管理成本；學校電腦還可能限制安裝軟體或長時間執行。若只是短期體驗 Claude Code、配合課程完成特定作業，直接購買 Mac 未必划算，租用 NodeMini 的遠端 Mac 會更容易按學習週期調整；若需要長期高強度使用、穩定保留本地檔案或連接實體裝置，則應誠實比較自購設備是否更適合。
想先確認連線、交付與學習環境是否符合需求，可查看 NodeMini 遠端 Mac 方案，再按照課程週期決定使用時間。