Claude Code 完全安裝指南
Windows & Mac 保姆級教學,從零開始到第一次對話
Vista Cheng · https://www.vista.tw
今日學習地圖
-
01
認識 Claude 家族
Desktop、Code、Claude.ai 三者的差異
-
02
Mac / Windows 安裝教學
保姆級終端機操作 + Node.js + Claude Code CLI
-
03
Claude Desktop 安裝
圖形介面版,拖拉即完成
-
04
第一次使用 Claude Code
登入、基本指令、實際對話示範
-
05
常見問題與排解
卡住了怎麼辦?FAQ 全收錄
01
認識 Claude 家族
三種使用方式,各有所長
Claude 的三種使用方式
-
Chat(網頁版)
打開 claude.ai 就能用,像 ChatGPT 一樣的對話介面,不用安裝任何東西
-
Cowork(桌面協作)
Claude Desktop 裡的協作模式——Claude 能看見你的螢幕、幫你操作應用程式,像坐在你旁邊的同事
-
Code(終端機)
在終端機裡跟 Claude 對話,它能直接讀寫你的檔案、執行指令、幫你建專案
-
三者可以並存
不衝突,看當下需求切換。今天我們會教你裝好 Desktop 和 Code
Chat:最簡單的起點
-
零安裝
打開瀏覽器、進入 claude.ai、登入帳號,直接開聊
-
適合場景
快速問答、翻譯、寫信、查資料、腦力激盪
-
限制
不能存取你電腦上的檔案,也不能幫你執行指令
-
免費可用
免費帳號就能體驗基本功能,付費可用更強模型
-
你可能已經會了
如果你用過 ChatGPT,體驗幾乎一樣,切過來零學習成本
Cowork:你的螢幕協作夥伴
-
Claude 能看見你的畫面
開啟 Cowork 模式後,Claude 可以觀察你正在做什麼,主動提供建議
-
跨應用程式協作
你在寫 Google Docs,它幫你潤稿;你在看 Excel,它幫你分析數據
-
自然語言操控
說「幫我把這段文字複製到那個檔案」,它真的會動手做
-
需要 Claude Desktop
這是 Desktop 應用程式裡的功能,等等會教你怎麼安裝
Code:AI 程式設計夥伴
-
在終端機裡對話
Claude 能直接讀寫程式碼、執行指令、幫你除錯
-
理解整個專案
不是一次只看一段文字,而是能掌握整個資料夾結構
-
保姆級操作
告訴它「幫我建一個網站」,它真的會動手做出來
-
安全機制
每個危險操作都會先問你,不會自作主張刪東西
-
需要付費方案
Claude Max、Team 或 Pro 訂閱才能使用
Cowork vs Code:我該用哪個?
Cowork(桌面協作)
- ✓ 圖形介面,操作直覺
- ✓ 能看見你的螢幕
- ✓ 適合文書、設計、日常工作
- ✓ 像「坐在旁邊的同事」
- ✓ 不需要會用終端機
Code(終端機)
- ✓ 文字介面,指令操作
- ✓ 能讀寫整個專案目錄
- ✓ 適合開發、自動化、系統操作
- ✓ 像「全能的工程師助手」
- ✓ 需要基本終端機操作
你今天會學會的東西
3
種方式
Chat + Cowork + Code
30
分鐘
從零到能用的時間
0
行程式碼
你不需要會寫程式
∞
種可能
裝好之後能做的事
02
安裝前準備
帳號、訂閱、環境一次搞定
你需要準備的東西
-
Anthropic 帳號
到 claude.ai 註冊(Google 帳號一鍵註冊)
-
付費訂閱(Claude Code 用)
Claude Max、Team 或 Pro 方案才能用 Claude Code
-
Node.js(Claude Code 用)
這是讓 Claude Code 能在你電腦上跑的基礎環境
-
穩定的網路
安裝過程需要下載約 200MB 的檔案
帳號申請步驟
-
Step 1
打開瀏覽器,進入 claude.ai
-
Step 2
點「Sign Up」,用 Google 帳號或 Email 註冊
-
Step 3
驗證 Email(如果用 Email 註冊)
-
Step 4
登入後到左下角齒輪 → Billing → 選擇方案
-
溫馨提醒
Claude Desktop 免費版就能用,Claude Code 需要付費方案
關於 Node.js
Node.js 是一個讓 JavaScript 能在你電腦上執行的環境。你不需要學會它,只需要裝好它。就像你不需要懂引擎原理才能開車——Node.js 是 Claude Code 的引擎。
安裝 Node.js 之後,你的電腦就會多一個叫做 npm 的工具(Node Package Manager),用它來安裝 Claude Code。整個過程只需要在終端機裡打兩三行指令。
03
Mac 安裝教學
一步一步跟著做
Mac Step 1:打開終端機
-
方法一(最快)
按 Command + 空白鍵,打「終端機」或「Terminal」,按 Enter
-
方法二
打開 Finder → 應用程式 → 工具程式 → 終端機.app
-
方法三
在 Launchpad 裡搜尋「Terminal」
-
你會看到什麼
一個黑色(或白色)視窗,上面有閃爍的游標,這就是終端機
-
不要怕
終端機只是另一種跟電腦溝通的方式,打錯字不會壞掉
Mac Step 2:安裝 Homebrew(套件管理器)
-
Homebrew 是什麼
Mac 上最方便的軟體安裝工具,就像 App Store 的終端機版
-
怎麼裝
複製下一頁的指令,貼到終端機裡,按 Enter
-
過程中會問你密碼
輸入你的 Mac 登入密碼(打字時畫面不會顯示,這是正常的)
-
等多久
大約 2-5 分鐘,取決於網路速度
-
已經有了?
在終端機打 brew --version,有顯示版本號就跳過這步
Homebrew 安裝指令
# 複製這整行,貼到終端機裡按 Enter
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 如果安裝程式有提示你加入 shell 環境變數,請照畫面上的指示執行
# 安裝完成後,驗證是否成功
brew --version
# 應該會顯示類似:Homebrew x.y.z
# 若出現「command not found: brew」
# 代表 brew 尚未加入 PATH,請依安裝完成畫面提供的指令執行
Mac Step 3:安裝 Node.js
-
用 Homebrew 裝
一行指令搞定,Homebrew 會幫你處理所有相依套件
-
為什麼用 Homebrew
比從官網下載安裝更乾淨,日後更新也方便
-
驗證方式
打 node --version 看到版本號就成功了
-
建議版本
Node.js 18 以上都可以,Homebrew 預設裝最新穩定版
Node.js 安裝指令(Mac)
# 安裝 Node.js
brew install node
# 驗證安裝成功
node --version
# 應該顯示:v20.x.x 或更高
npm --version
# 應該顯示:10.x.x 或更高
Mac Step 4:安裝 Claude Code
-
一行指令
用 npm 全域安裝 Claude Code CLI
-
-g 的意思
global(全域),代表在任何資料夾都能用 Claude 指令
-
需要多久
大約 30 秒到 1 分鐘
-
安裝完驗證
打 Claude --version 看到版本號就成功
Claude Code 安裝指令(Mac)
# 安裝 Claude Code
npm install -g @anthropic-ai/claude-code
# 驗證安裝成功
claude --version
# 應該顯示版本號
Mac 安裝完成!回顧一下
-
Step 1
打開終端機(Command + 空白鍵 → Terminal)
-
Step 2
安裝 Homebrew(如果還沒有的話)
-
Step 3
安裝 Node.js(brew install node)
-
Step 4
安裝 Claude Code(npm install -g @anthropic-ai/claude-code)
-
總共打了
大概 4 行指令,花不到 10 分鐘
04
Windows 安裝教學
一步一步跟著做
Windows Step 1:打開終端機
-
推薦用 PowerShell
Windows 內建,不需要另外安裝
-
怎麼打開
按鍵盤的 Windows 鍵,打「PowerShell」,選「以系統管理員身分執行」
-
為什麼要管理員
安裝全域套件(npm install -g)需要管理員權限
-
你會看到什麼
藍色背景的文字視窗,上面寫著 PS C:\Users\你的名字>
-
不要怕
跟 Mac 終端機一樣,只是換了一套指令語言
Windows Step 2:安裝 Node.js(方法一:官網下載)
-
適合誰
不熟悉終端機、偏好圖形介面的人
-
步驟
打開 nodejs.org → 點「Download Node.js (LTS)」→ 執行安裝檔
-
安裝過程
一路點 Next → 勾選 Add to PATH → Install → Finish
-
重要
「Add to PATH」一定要勾,不勾的話終端機找不到 node 指令
-
裝完後
關掉 PowerShell 再重新打開(讓 PATH 生效)
Windows Step 2:安裝 Node.js(方法二:終端機指令)
-
適合誰
喜歡用終端機、或想一氣呵成的人
-
用 winget
Windows 11 內建的套件管理器,類似 Mac 的 Homebrew
-
Windows 10 用戶
如果沒有 winget,用方法一(官網下載)即可
-
裝完後一樣
關掉 PowerShell 再重新打開
Node.js 安裝指令(Windows)
# 方法二:用 winget 安裝 Node.js LTS
winget install --id OpenJS.NodeJS.LTS -e
# 安裝完成後,關閉 PowerShell 或重新開啟終端機
# 然後驗證
node --version
# 應該會顯示:v22.x.x、v24.x.x 或其他目前的 LTS 版本
npm --version
# 應該會顯示 npm 的版本號,例如 10.x、11.x 或其他目前版本
Windows Step 3:安裝 Claude Code
-
跟 Mac 一模一樣
同一行指令,跨平臺通用
-
確保用管理員 PowerShell
否則 -g 全域安裝會沒權限
-
安裝完驗證
打 Claude --version 看到版本號就成功
Claude Code 安裝指令(Windows)
# 安裝 Claude Code(跟 Mac 一樣)
npm install -g @anthropic-ai/claude-code
# 驗證安裝成功
claude --version
# 應該顯示版本號
Windows 安裝完成!回顧一下
-
Step 1
打開 PowerShell(以系統管理員身分執行)
-
Step 2
安裝 Node.js(官網下載 或 winget install)
-
Step 3
安裝 Claude Code(npm install -g @anthropic-ai/claude-code)
-
總共
2-3 行指令,加上一個安裝檔,花不到 10 分鐘
05
Claude Desktop 安裝
圖形介面版,不需要終端機
Mac 版 Claude Desktop
-
Step 1
打開瀏覽器,進入 claude.ai/download
-
Step 2
點「Download for macOS」下載 .dmg 檔案
-
Step 3
打開 .dmg → 把 Claude 圖示拖到「應用程式」資料夾
-
Step 4
從應用程式或 Launchpad 打開 Claude
-
Step 5
用你的 Anthropic 帳號登入,就能開始對話
Windows 版 Claude Desktop
-
Step 1
打開瀏覽器,進入 claude.ai/download
-
Step 2
點「Download for Windows」下載 .exe 安裝檔
-
Step 3
雙擊 .exe → 按「安裝」→ 等待完成
-
Step 4
桌面或開始選單會出現 Claude 圖示
-
Step 5
打開 Claude → 登入帳號 → 開始對話
Claude Desktop vs Claude Code:我該用哪個?
如果你主要是想跟 AI 聊天、問問題、翻譯文章、整理想法、寫信,Claude Desktop(或一般 Claude app)通常就很夠用。它比較像一個直覺、好上手的 AI 助手,適合一般知識工作與日常對話。
如果你想讓 AI 幫你處理程式開發相關工作,例如讀懂整個專案、修改多個檔案、執行指令、除錯、寫功能、跑開發流程自動化,那麼 Claude Code 會更適合。它的重點不是單純聊天,而是能直接在你的開發環境中工作。以前 Claude Code 主要是終端機工具,但現在不一定只能在終端機使用,也可以透過桌面 app、IDE 或其他介面操作。
兩者不是互斥的,你可以依需求搭配使用。若你平常既有一般問答需求,也有寫程式、改專案、跑指令的需求,兩種模式並用是合理的。
06
第一次使用 Claude Code
登入、基本指令、實際對話
啟動與登入
-
打開終端機
Mac 用 Terminal / Windows 用 PowerShell
-
輸入 Claude
就這一個字,按 Enter
-
瀏覽器會自動打開
跳出 Anthropic 的登入頁面
-
登入你的帳號
用你剛剛註冊的帳號登入、授權
-
回到終端機
會看到「Welcome to Claude Code」的歡迎訊息
第一次啟動 Claude Code
# 在終端機輸入
claude
# 瀏覽器會自動打開登入頁面
# 登入後回到終端機,你會看到:
# ╭────────────────────────────╮
# │ Welcome to Claude Code! │
# ╰────────────────────────────╯
#
# 接著就可以直接打字跟 Claude 對話了
基本操作指南
-
直接打字
在 > 提示符後面打你想問的問題,按 Enter 送出
-
多行輸入
按 Shift + Enter 換行(不送出),寫完再按 Enter 送出
-
取消操作
按 Esc 可以中斷 Claude 正在做的事
-
清除畫面
輸入 /clear 清除對話紀錄
-
離開
輸入 /exit 或按 Ctrl + C 兩次退出
實際對話範例
常用指令速查
-
/help
顯示所有可用指令
-
/clear
清除目前對話紀錄
-
/exit
退出 Claude Code
-
/model
切換 AI 模型(Opus / Sonnet / Haiku)
-
/compact
壓縮對話紀錄,釋放記憶空間
讓 Claude Code 幫你做事的訣竅
-
說清楚目標
不要說「幫我寫程式」,要說「幫我用 Python 寫一個計算 BMI 的程式」
-
給具體路徑
不要說「那個檔案」,要說「桌面上的 report.docx」
-
分步驟下指令
複雜任務拆成小步:先建資料夾 → 再建檔案 → 再寫內容
-
確認再繼續
Claude 做完一步會問你下一步,不確定就先看結果再決定
07
常見問題與排解
卡住了?這裡找答案
問題一:npm 指令找不到
-
症狀
終端機顯示「npm: command not found」或「npm 不是內部命令」
-
原因
Node.js 沒裝好,或 PATH 沒設對
-
Mac 解法
重新跑 brew install node,然後關掉終端機重新打開
-
Windows 解法
重新從 nodejs.org 下載安裝,確認勾選「Add to PATH」
-
驗證
打 node --version 有出現版本號就修好了
問題二:權限不足(Permission denied)
-
症狀
安裝 Claude Code 時出現「EACCES」或「Permission denied」
-
Mac 解法一
在指令前面加 sudo:sudo npm install -g @anthropic-ai/claude-code
-
Mac 解法二(推薦)
用 nvm 管理 Node.js 版本,避免權限問題
-
Windows 解法
確認 PowerShell 是「以系統管理員身分執行」
問題三:Claude 指令找不到
-
症狀
安裝成功但打 Claude 沒反應
-
原因
全域 npm bin 目錄不在 PATH 裡
-
Mac 排查
打 npm bin -g 看路徑,然後加到 ~/.zshrc 的 PATH
-
Windows 排查
關掉 PowerShell 重開,通常就好了
-
終極解法
解除安裝再重裝:npm uninstall -g @anthropic-ai/claude-code 然後再裝一次
問題四:登入後顯示「需要付費方案」
-
原因
Claude Code 需要 Max、Team 或 Pro 訂閱
-
解法
到 claude.ai → Settings → Billing → 升級到付費方案
-
注意
Claude Desktop 的免費版不等於 Claude Code 可以用
-
替代方案
如果暫時不想付費,先用 Claude Desktop 免費版體驗 AI 對話
問題五:網路連線問題
-
症狀
安裝到一半卡住、或 npm install 超時
-
解法一
確認你的網路可以存取 registry.npmjs.org
-
解法二
如果在公司/學校網路,可能被防火牆擋住,換用手機熱點試試
-
解法三
用 npm install 加上 --verbose 看詳細錯誤訊息
08
裝好之後,你可以做什麼?
打開新世界的大門
Claude Code 能幫你做的事
-
管理檔案
批次改名、整理資料夾、搬移檔案
-
寫程式
從零開始建網站、寫 App、做自動化腳本
-
分析資料
讀 CSV / Excel,做統計、畫圖表
-
內容創作
幫你寫文章、做簡報、產出社群貼文
-
學習新技能
讓 Claude 當你的家教,邊教邊做
Claude Desktop 能幫你做的事
-
日常問答
翻譯、寫信、查資料、解釋概念
-
文件處理
拖入 PDF/圖片,讓 Claude 摘要或分析
-
寫作輔助
幫你修潤文章、改語氣、調整結構
-
腦力激盪
跟 Claude 討論想法,讓它幫你延伸思考
最好的學習方式就是裝好之後開始用。不用等到「準備好」——打開終端機,跟 Claude 說「你好」,一切就開始了。
— Vista Cheng
vista.tw
09
想繼續深入學習?
Vista 的 AI 實戰工作坊,帶你從會裝到會用
裝好工具只是起點
今天你學會了安裝 Claude Code 和 Claude Desktop。但工具裝好跟「用得好」之間,還有一段關鍵距離——就像買了一臺好相機,不代表馬上能拍出好照片。
接下來推薦兩門 Vista 親自帶的小班實戰工作坊,每一門都是 3 小時、限額制、現場帶你從零完成一個真實成果。不是看投影片聽講——是你自己動手做出來帶回家。
AI 內容產製系統工作坊
-
一份素材,六種格式
用 Claude Code 建立五層內容產製架構,一次產出部落格、電子報、社群貼文、短影音腳本等六種內容
-
3 小時實作制
不是理論課,現場帶你建好自己的內容產線,做完直接能用
-
限 16 人小班
確保每位學員都能得到即時指導,不會落單
-
適合對象
創作者、自媒體經營者、想用 AI 提高內容產出效率的人
-
課程頁面
Vibe Coding 實戰工作坊
-
零基礎也能做網站
不需要會寫程式,用 AI 對話就能建立個人品牌網站、銷售頁、名單收集頁
-
3 小時現場完成
帶著你的筆電來,帶著一個可上線的網站走
-
限 12 人小班
手把手教學,卡關立即排解,沒有人會被丟下
-
適合對象
講師、顧問、教練、自由工作者——想要自己的網站但不想學程式的人
-
課程頁面
兩門課怎麼選?
AI 內容產製系統
- ✓ 你已經有網站或平臺
- ✓ 痛點是「內容產不夠快」
- ✓ 想建立可複製的 AI 內容流程
- ✓ 適合創作者、編輯、行銷人
- ✓ 16 人班,3 小時
Vibe Coding 實戰
- ✓ 你還沒有自己的網站
- ✓ 痛點是「不會做網頁」
- ✓ 想用 AI 從零做出銷售頁
- ✓ 適合講師、顧問、教練
- ✓ 12 人班,3 小時
恭喜你完成安裝!
Claude Code 完全安裝指南
Vista Cheng · vista.tw
歡迎來信交流 iamvista@gmail.com
現在就打開終端機,輸入 Claude 開始你的第一次對話吧!