Claude Code Mac 安裝：桌面 App 一次裝完
文 / Coolkid發布：2026-09-09閱讀約 8 分鐘
短答給趕時間的人：在 Mac 上想用 Claude Code，直接下載桌面 App 就好，不用先碰終端機。我自己在 MacBook Air 上裝，一次裝完，沒有卡在任何一步。系統需求以官方下載頁為準，我不在這裡寫死版本號。這篇不是逐圖走完的長篇安裝步驟，講的是我同一個人在 Windows 跟 Mac 各裝一次的對照，跟裝完之後前 30 分鐘該做什麼。
我這半年一直是 Windows 主力機，第一次裝 Claude Code 那次踩過三個雷，PowerShell 執行原則、中文路徑、PATH，寫在另一篇《Windows 安裝踩雷實錄》裡。
第一次在 MacBook Air 上裝 Claude Code。
直接下載桌面 App，一次裝完，沒有卡在任何一步。
這篇不是逐圖走完的長篇安裝指南，那種教學網路上已經很多篇，我不重複寫第五篇。這篇要講的是同一個人裝兩次的對照，跟裝完之後怎麼開始用。
為什麼這次我說「新手直接用桌面 App」？
先講結論：我認為新手也最應該直接使用桌面 App。這是我自己裝完兩次之後的立場，不是官方建議。
Windows 那次，我照著網路上的舊教學，先卡在 PowerShell 執行原則被擋，再碰到中文路徑跟 PATH 兩個問題，一個下午才理順。那三個問題完整記在Windows 安裝那篇裡。
Mac 這次，我是直接裝桌面 App，沒有遇到任何困難。已經登入成功，可以開始用。
兩次差別最大的地方，不是 Mac 比 Windows 厲害，是我這次沒有先去開終端機。
Windows 那次撞的雷，多半是終端機那一層的事，PowerShell 的安全設定、指令找不到路徑。桌面 App 把這一層藏起來，新手不用先弄懂終端機在講什麼，就能開始用。
我不是說終端機不好，是說新手第一天不需要先過那一關。撞到「這指令在桌面 App 沒反應」再開終端機補那一次，順序反過來會省一個下午。
Mac 上桌面 App 怎麼裝、裝完做什麼？
四件事：下載、登入、選資料夾、打第一句話。
下載：去Anthropic 官方下載頁選 Mac 版本。系統需求、版本號會變，一律以那頁當下顯示的為準，我不在這裡寫死數字。
登入：我走的是 Claude 訂閱帳號，流程跟《Claude Code 怎麼登入》那篇說的一樣：瀏覽器跳出來，登入 Anthropic 帳號，授權完回到 App 就好。
選資料夾：桌面 App 要你指定一個資料夾，Claude Code 只會動那個資料夾裡的東西，不會跑到別的地方。我這次選的是新建的資料夾。
第一句話：我打的第一句不是叫它寫程式，是叫它把我 Windows 那邊的環境設定複製過來，改成適合 Mac 的全域設定。這句對第一次用的人沒有參考價值，你手上沒有舊設定可以搬；第一句話該打什麼，看第五節。
整個過程沒有一步要先開終端機，也沒有要先裝什麼其他軟體。
這次真的一個雷都沒有嗎？
是真的沒有。我不想為了讓這篇看起來更像教學文，硬湊一段排錯出來。
那 Windows 的雷去哪了？「Mac 對工程師比較友善」這句常聽到，但我不是工程背景，為什麼這次沒遇到問題，我沒有確切的答案。不同機器、不同時間點、桌面 App 跟我當時用的舊安裝路線本來就不是同一條，條件不只一個變數，我不會替沒驗證過的原因下結論。
能講的只有結果：這次從下載到登入成功，中間沒有停下來查過任何一則錯誤訊息。
如果你這次也順利，不代表你運氣特別好；如果你卡住了，也不代表你哪裡做錯。裝置、系統版本、網路環境都不一樣，遇到問題就照官方下載頁當下的說明處理最準，或者直接把錯誤訊息貼給 Claude Code，讓它幫你排查問題。
什麼時候才需要碰終端機？
裝完桌面 App 不代表終端機從此用不到，只是不用第一天就碰。
桌面 App 內建就有幾樣終端機那邊多半要另外接工具才做得到的事：內建瀏覽器（能自己打開網頁看結果、截圖）、操控你的桌面（要先去設定裡打開，預設是關的）、圖表跟畫面直接顯示在對話裡、長工作跑完會通知你。這四樣我沒有自己驗過，是引用自《終端機還是桌面 App》那篇已經查證過的說法。
反過來，終端機能處理一類桌面 App 處理不了的指令：打了會跳出一個面板讓你上下鍵選、按 Enter 確認的指令。這類指令在桌面 App 的對話框裡叫不出來。
判斷法很簡單：教學如果寫「打了會跳出一個清單讓你選」，就去開終端機打那一行；純文字問答型的指令，桌面 App 就能處理。
同一個 Claude Code，兩邊是同一份設定，不用重裝、不用重新登入。想知道兩邊完整差在哪，看《終端機還是桌面 App？差在哪》那篇。
裝完前 30 分鐘該做什麼？
裝好不代表要立刻把整個資料夾交給它做決定。前 30 分鐘照這個順序走比較安心：
- 先搞懂「交辦任務」跟「問問題」不一樣。挑一件每天做、步驟固定、做錯也沒關係的小事，用背景、目標、限制三段講清楚。完整五步在《AI Agent 怎麼用》那篇。
- 看懂它為什麼一直跳出「可不可以」的提示。改檔案、跑指令這類會改變東西的動作，預設都先問你，這是安全設計，不是故障。分界線在《Claude Code 一直問可不可以？》那篇，一句話：做錯了收得回來嗎。
- 確認自己是走訂閱登入還是 API Key 計費，兩種算錢方式不一樣，搞混會多花錢，細節在《Claude Code 怎麼登入》那篇。
這三篇讀完，桌面 App 裝好之後的第一天大概不會走冤枉路。
在 Mac 上想用 Claude Code，新手直接下載桌面 App 就好，不用先碰終端機。系統需求以官方下載頁為準，這篇不寫死版本號。我自己在 Windows 那次裝的時候踩過 PowerShell 執行原則、中文路徑、PATH 三個雷；在 MacBook Air 上直接裝桌面 App，一次裝完，沒卡在任何一步。裝完不代表終端機用不到：桌面 App 內建瀏覽器、桌面操控、圖表顯示、跑完通知這幾樣，終端機那邊多半要另外接工具；終端機能處理的是那類打了會跳出面板讓你上下選的指令，桌面 App 叫不出來。裝完前 30 分鐘，建議先看懂怎麼交辦任務、為什麼它一直問你可不可以、訂閱跟 API Key 兩種登入方式怎麼分。
名詞解釋
- Claude Code
- Anthropic 推出的 AI 寫程式工具，裝在自己電腦的終端機裡，能直接讀寫你的檔案、跑指令，把你用中文描述的需求做成真的網站或工具。
- 終端機（terminal）
- 「用文字指令操作電腦的視窗」的統稱。Mac 叫 Terminal，Windows 上就是 PowerShell，兩者角色相同。
- Homebrew（brew）
- Mac 專用的軟體安裝工具，Windows 沒有也不需要。Mac 教學看到 brew install 開頭的指令，Windows 用戶直接跳過。
- native 安裝（原生安裝）
- 官方提供的獨立安裝方式：一行指令下載完整程式，不依賴 Node.js 這類其他環境，裝完會自動更新。2026 年官方文件的推薦裝法。
- PowerShell
- Windows 內建的指令視窗：用打字下指令的方式操作電腦，Claude Code 在 Windows 上就在這裡面跑。按 Win + X 可以叫出來。
- 執行原則（Execution Policy）
- Windows 的安全限制，預設擋下外來的指令檔。PowerShell 跳紅字常是它造成的，用系統管理員身分設定一次就解除。
- PATH（環境變數）
- 系統的「去哪裡找程式」清單。指令打了卻顯示找不到，九成是程式所在的資料夾沒被加進這份清單。
- API 金鑰（API key）
- 服務發給你的一串密碼，程式用它證明「我有權限使用這個服務」。絕對不能公開、不能寫死在程式碼裡。
- AI 代理（AI agent）
- 會「動手做事」的 AI：自己讀檔案、寫程式、跑指令、修錯誤，你只負責描述需求跟監督方向。跟只會「回答問題」的聊天機器人是兩種東西。
如果內容對你有用就太好了
隨喜斗內
常見問題FAQ
Mac 裝 Claude Code 要先裝 Homebrew 嗎？
桌面 App 不用。Homebrew 是 Mac 專用的軟體安裝工具，是走終端機那條安裝路線才會用到；直接下載桌面 App 的話，這一步完全不用管。終端機路線的系統需求與安裝方式，以官方下載頁當下的說明為準。
Claude Code 桌面 App 是不是比較簡化的版本？
不是。桌面 App 內建就有一些終端機那邊要另外接工具才做得到的事，像內建瀏覽器、操控桌面、圖表直接顯示在對話裡、長工作跑完會通知。這是引用自《終端機還是桌面 App》那篇已經查證過的說法，不是我自己這次裝的過程裡驗到的。
Mac 版 Claude Code 系統需求是什麼？
版本號跟需求會變，這篇不寫死數字。安裝前一律以官方下載頁當下顯示的系統需求為準，不要照著別篇教學裡寫的舊版本號對照。
桌面 App 跟終端機可以一起用嗎？
可以，兩邊是同一個 Claude Code，共用同一份設定，不用為了換邊重裝或重新登入。新手建議先從桌面 App 開始，撞到那種打了會跳出面板讓你上下選的指令再開終端機補那一次。
訂閱帳號跟 API Key，Mac 版登入要選哪一種？
多數人走訂閱制：有 Pro 方案的話，第一次啟動用瀏覽器登入 Anthropic 帳號、完成授權就能用，不用碰 API Key。API Key 那條路是按用量計費，適合自動化或排程的情境。已經訂閱 Pro 就不用另外再生 API Key，兩種混著算容易多花錢，細節在《Claude Code 怎麼登入》那篇。
新手在 Mac 上該先裝終端機版還是桌面 App？
建議先裝桌面 App。不用先弄懂終端機在講什麼就能開始用，撞到指令沒反應再開終端機處理那一次，順序反過來比較省時間。這是我自己裝完兩次之後的立場，不是官方規定的唯一路線。
看完這篇之前先確認:
- 想在 MacBook 上裝 Claude Code 的新手
- 看過我 Windows 那篇踩雷、想知道 Mac 是不是一樣麻煩
- 不想一開始就碰終端機的人
- 已經用終端機裝好、正在跑的人
- 想找逐圖詳細安裝步驟的人（那種教學網路上已經很多篇）
- 用 Windows 的人（直接看 Windows 那篇）