Claude Code 完全安裝指南

Windows & Mac 保姆級教學,從零開始到第一次對話

今日學習地圖

  1. 01

    認識 Claude 家族

    Desktop、Code、Claude.ai 三者的差異

  2. 02

    Mac / Windows 安裝教學

    保姆級終端機操作 + Node.js + Claude Code CLI

  3. 03

    Claude Desktop 安裝

    圖形介面版,拖拉即完成

  4. 04

    第一次使用 Claude Code

    登入、基本指令、實際對話示範

  5. 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 安裝指令

bash
# 複製這整行,貼到終端機裡按 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)

bash
# 安裝 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)

bash
# 安裝 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)

powershell
# 方法二:用 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)

powershell
# 安裝 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

bash
# 在終端機輸入
claude

# 瀏覽器會自動打開登入頁面
# 登入後回到終端機,你會看到:
# ╭────────────────────────────╮
# │  Welcome to Claude Code!  │
# ╰────────────────────────────╯
# 
# 接著就可以直接打字跟 Claude 對話了

基本操作指南

  • 直接打字

    在 > 提示符後面打你想問的問題,按 Enter 送出

  • 多行輸入

    按 Shift + Enter 換行(不送出),寫完再按 Enter 送出

  • 取消操作

    按 Esc 可以中斷 Claude 正在做的事

  • 清除畫面

    輸入 /clear 清除對話紀錄

  • 離開

    輸入 /exit 或按 Ctrl + C 兩次退出

實際對話範例

👤
幫我在桌面建立一個叫做「my-project」的資料夾
🤖AI
好的,我來幫您在桌面建立資料夾。 已建立 ~/Desktop/my-project/ 資料夾。要我在裡面建立一些基本檔案嗎?
👤
好,幫我建立一個 README.md,寫上「我的第一個專案」
🤖AI
已建立 ~/Desktop/my-project/README.md,內容是「我的第一個專案」。您可以打開 Finder 確認看看。

常用指令速查

  • /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 提高內容產出效率的人

  • 課程頁面

    https://www.solo.tw/courses/ai-content

Vibe Coding 實戰工作坊

  • 零基礎也能做網站

    不需要會寫程式,用 AI 對話就能建立個人品牌網站、銷售頁、名單收集頁

  • 3 小時現場完成

    帶著你的筆電來,帶著一個可上線的網站走

  • 限 12 人小班

    手把手教學,卡關立即排解,沒有人會被丟下

  • 適合對象

    講師、顧問、教練、自由工作者——想要自己的網站但不想學程式的人

  • 課程頁面

    https://www.solo.tw/courses/vibe-coding

兩門課怎麼選?

AI 內容產製系統

  • 你已經有網站或平臺
  • 痛點是「內容產不夠快」
  • 想建立可複製的 AI 內容流程
  • 適合創作者、編輯、行銷人
  • 16 人班,3 小時

Vibe Coding 實戰

  • 你還沒有自己的網站
  • 痛點是「不會做網頁」
  • 想用 AI 從零做出銷售頁
  • 適合講師、顧問、教練
  • 12 人班,3 小時

恭喜你完成安裝!

Claude Code 完全安裝指南

Vista Cheng · vista.tw

歡迎來信交流 iamvista@gmail.com

現在就打開終端機,輸入 Claude 開始你的第一次對話吧!