Claude Code 完全安裝指南

2026 年最新版:一行指令裝好,十分鐘開始第一次對話

今日學習地圖

  1. 01

    認識 Claude Code 家族

    Chat、Cowork、Code 三種模式的真正差別

  2. 02

    安裝前準備

    帳號、方案、系統需求,以及為什麼不用再裝 Node.js

  3. 03

    Mac 與 Windows 安裝

    保姆級終端機操作,一行指令完成

  4. 04

    第一次使用 Claude Code

    登入、權限模式、常用指令、實際對話示範

  5. 05

    排錯與下一步

    卡住了怎麼辦,以及裝好之後該做什麼

01

認識 Claude Code 家族

三種模式,各有各的戰場

Claude 的三種使用方式

  • Chat(一般對話)

    打開 claude.ai 或桌面 app 的 Chat 分頁就能用,看不到你的檔案,純聊天

  • Cowork(自主代理)

    把任務交出去,它在一臺沙箱虛擬機裡自己跑完,你同時去做別的事

  • Code(動手工作)

    直接讀寫你電腦上的檔案、執行指令、跑完整個開發流程

  • 三者可以並存

    同一個帳號、同一個 app,看當下需求切換。今天的主線是 Code

Chat:最簡單的起點

  • 零安裝

    打開瀏覽器、進入 claude.ai、登入帳號,直接開聊

  • 適合場景

    快速問答、翻譯、寫信、查資料、腦力激盪

  • 限制

    碰不到你電腦上的檔案,也不能幫你執行指令

  • 免費可用

    免費帳號就能體驗基本功能,付費方案可用更強的模型

  • 你可能已經會了

    如果你用過 ChatGPT,體驗幾乎一樣,切過來零學習成本

Cowork:會自己跑完任務的代理

  • 交辦,不是陪聊

    你描述要什麼結果,它自己規劃步驟、動手做完,再回來交差

  • 跑在沙箱裡

    它有一個獨立的虛擬環境,可以放在你的電腦上跑,也可以跑在雲端

  • 你可以先去忙別的

    任務在背景進行,不必盯著畫面等它

  • 在桌面 app 的 Cowork 分頁

    這是 Claude 桌面應用程式的其中一個分頁,不是另一套軟體

Code:直接動手的工作夥伴

  • 真的會動手

    讀寫檔案、執行指令、跑測試、開分支、送出 commit

  • 理解整個專案

    不是一次只看一段文字,而是能掌握整個資料夾的結構與脈絡

  • 不只給工程師

    整理檔案、分析試算表、產出簡報與文章,一樣走這條路

  • 安全機制

    危險操作會先問你,也可以切到只做計畫不動手的模式

  • 需要付費方案

    Pro、Max、Team 或 Enterprise 訂閱才能使用,免費方案不含

Cowork vs Code:我該用哪個?

Cowork(自主代理)

  • 交辦完就走,背景自己跑
  • 在沙箱虛擬機裡執行
  • 適合長時間、可以放著的任務
  • 像「派出去的外包夥伴」
  • 互動少,結果導向

Code(互動工作)

  • 一來一往,隨時可以喊停
  • 直接操作你本機的檔案
  • 適合需要邊看邊修的工作
  • 像「坐在旁邊的工程師」
  • 互動多,過程可控

Claude Code 現在跑在哪些地方

  • 終端機 CLI

    功能最完整的本命介面,今天教的就是這條

  • 桌面應用程式

    圖形介面,可以同時開好幾個工作階段、視覺化看修改差異

  • 網頁與手機

    claude.ai/code 直接開,或用手機版 Claude app 遠端下指令

  • VS Code 與 JetBrains

    安裝擴充套件,在編輯器裡直接用

  • Slack 與 CI

    在 Slack 標記 @Claude 交辦,或掛進 GitHub Actions 自動審查

你今天會學會的東西

1

行指令

原生安裝器一次搞定

10

分鐘

從零到第一次對話

0

行程式碼

你不需要會寫程式

5

種介面

裝好之後隨你挑

02

安裝前準備

帳號、方案、環境一次確認

動手之前,先確認四件事

一個 Anthropic 帳號 到 claude.ai 註冊,可以用 Google 帳號一鍵完成
一個付費方案 Pro、Max、Team 或 Enterprise。免費方案不含 Claude Code
作業系統版本夠新 macOS 13 以上,或 Windows 10(1809 版)以上
能連外的網路 安裝過程要下載程式本體,公司網路可能會擋

系統需求一覽

  • macOS

    13.0 以上,Intel 與 Apple Silicon 都支援

  • Windows

    10(1809 版)以上,或 Windows Server 2019 以上

  • Linux

    Ubuntu 20.04、Debian 10、Alpine 3.19 以上

  • 硬體

    4 GB 以上記憶體,x64 或 ARM64 處理器

  • 所在地區

    需在 Anthropic 開放服務的國家或地區,臺灣可用

帳號與方案怎麼開

  • Step 1

    打開瀏覽器,進入 claude.ai

  • Step 2

    點「Sign Up」,用 Google 帳號或 Email 註冊

  • Step 3

    驗證 Email(用 Email 註冊的話)

  • Step 4

    登入後點左下角頭像進 Settings,找到 Billing 選方案

  • 溫馨提醒

    Chat 免費就能用,但 Claude Code 一定要付費方案才開得起來

好消息:不用再裝 Node.js 了

如果你在網路上看過 Claude Code 的安裝教學,多半會看到這樣的三步驟:先裝 Homebrew,再裝 Node.js,最後用 npm 安裝。那是舊路線。

Anthropic 後來改發原生安裝器:一行指令下載一個獨立的執行檔,跑起來完全不需要 Node.js,也不需要套件管理器。裝完之後它還會在背景自動更新,你不必記得回來手動升級。

舊方法今天仍然能用,本指南也會列出來當備用。但如果你是全新安裝,直接走原生安裝器就好,少裝兩套東西,就少兩種出錯的可能。

03

Mac 安裝教學

一行指令,三分鐘完成

Mac Step 1:打開終端機

  • 方法一(最快)

    按 Command + 空白鍵,打「終端機」或「Terminal」,按 Enter

  • 方法二

    打開 Finder → 應用程式 → 工具程式 → 終端機.app

  • 方法三

    在 Launchpad 裡搜尋「Terminal」

  • 你會看到什麼

    一個黑色或白色的視窗,上面有閃爍的游標,這就是終端機

  • 不要怕

    終端機只是另一種跟電腦溝通的方式,打錯字不會壞掉

Mac 安裝就三個動作

1

貼上安裝指令

複製下一頁那一整行,貼進終端機按 Enter,等它跑完。

2

重開終端機

關掉視窗再開一個新的,讓系統認得剛裝好的 claude 指令。

3

驗證版本號

輸入 claude --version,看到版本號就代表成功了。

Mac 安裝指令

bash
# 複製這一整行,貼到終端機裡按 Enter
curl -fsSL https://claude.ai/install.sh | bash

# 跑完之後,關掉終端機視窗再重新打開一個
# 這一步是讓系統重新讀取路徑設定,不能省略

# 確認裝好了
claude --version
# 應該會顯示類似:2.1.211 (Claude Code)

Mac Step 3:確認真的裝好了

  • 看到版本號就成功

    格式是數字加上「(Claude Code)」,例如 2.1.211 (Claude Code)

  • 想看更完整的健檢

    輸入 claude doctor,它會列出安裝狀態、設定檔問題與建議修法

  • claude doctor 不會啟動對話

    它只做唯讀檢查然後印報告,放心跑

  • 自動更新已經開好了

    原生安裝版會在背景自己更新,不必手動維護

  • 指令一律小寫

    是 claude 不是 Claude,終端機會分大小寫

健檢與啟動(Mac)

bash
# 完整健檢:檢查安裝狀態與設定檔
claude doctor

# 進到你想要工作的資料夾
cd ~/Desktop

# 啟動 Claude Code
claude

# 想立刻更新到最新版(平常不用手動跑)
claude update

備用路線:Homebrew 與 npm(Mac)

bash
# 備用一:已經在用 Homebrew 的人
brew install --cask claude-code
# 注意:Homebrew 版不會自動更新,要自己升級
brew upgrade claude-code

# 備用二:已經有 Node.js 22 以上的人
npm install -g @anthropic-ai/claude-code
# 千萬不要加 sudo,會製造權限與安全問題

# 三種方式裝到的是同一個原生程式,擇一即可

Mac 安裝完成,回顧一下

  • Step 1

    打開終端機(Command + 空白鍵,搜尋 Terminal)

  • Step 2

    貼上一行 curl 指令,按 Enter 等它跑完

  • Step 3

    關掉終端機再重開,輸入 claude --version 驗證

  • 總共

    一行指令,不到三分鐘,沒有裝任何額外套件

04

Windows 安裝教學

先分清楚兩種終端機,其餘一樣簡單

Windows Step 1:分清楚 PowerShell 與 CMD

  • 怎麼打開

    按 Windows 鍵,打「PowerShell」或「cmd」,按 Enter

  • 怎麼分辨

    提示字元開頭是 PS C:\ 就是 PowerShell,只有 C:\ 就是 CMD

  • 兩種指令不一樣

    貼錯的話會報錯,下一頁兩種都有,對號入座

  • 不需要系統管理員

    原生安裝器裝在你自己的使用者目錄,不用提升權限

  • 不要怕

    跟 Mac 終端機一樣,只是換了一套指令語言

Windows 安裝指令(兩種擇一)

powershell
# 如果你在 PowerShell(開頭是 PS C:\)
irm https://claude.ai/install.ps1 | iex

# 如果你在 CMD(開頭只有 C:\)
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

# 裝完關掉視窗,重新開一個新的終端機
# 然後確認
claude --version

Windows Step 2:驗證與收尾

  • 看到版本號就成功

    例如 2.1.211 (Claude Code),指令一律小寫

  • 報錯「不是有效的陳述式分隔符號」

    代表你在 PowerShell 卻貼了 CMD 的指令,換一條

  • 報錯「irm 不是內部或外部命令」

    代表你在 CMD 卻貼了 PowerShell 的指令,換一條

  • 建議加裝 Git for Windows

    有它,Claude Code 才能用 Bash 執行指令,功能比較完整

  • 完整健檢

    輸入 claude doctor 看安裝與設定的診斷報告

備用路線:WinGet 與 WSL(Windows)

powershell
# 備用一:WinGet(Windows 內建的套件管理器)
winget install Anthropic.ClaudeCode
# 注意:WinGet 版不會自動更新,要自己升級
winget upgrade Anthropic.ClaudeCode

# 備用二:在 WSL 裡安裝,走 Mac 與 Linux 那一條
curl -fsSL https://claude.ai/install.sh | bash

# 一般使用不需要 WSL
# 只有想讓指令跑在沙箱隔離環境時,才需要 WSL 2

Windows 安裝完成,回顧一下

  • Step 1

    打開 PowerShell 或 CMD,先確認自己在哪一個

  • Step 2

    貼上對應的那一行安裝指令

  • Step 3

    關掉視窗重開,輸入 claude --version 驗證

  • 總共

    一行指令,不到三分鐘,也不需要系統管理員權限

05

順手裝一下桌面應用程式

圖形介面版,不必碰終端機

下載與安裝

  • 下載頁面

    打開瀏覽器,進入 claude.ai/download

  • Mac

    下載 .dmg,打開後把 Claude 圖示拖進「應用程式」資料夾

  • Windows

    下載 .exe,雙擊執行,桌面與開始選單會出現 Claude 圖示

  • 登入

    打開 app,用你的 Anthropic 帳號登入

  • 不需要另外裝什麼

    桌面 app 已經內含 Claude Code,不需要 Node.js 也不需要 CLI

桌面 app 的三個分頁

  • Chat

    一般對話,碰不到你的檔案,跟網頁版體驗一樣

  • Cowork

    交辦任務給沙箱裡的自主代理,它自己跑完再回報

  • Code

    互動式操作你本機的檔案,可以視覺化檢視每一處修改

  • Code 分頁要付費方案

    點下去若跳出升級提示,代表你的帳號還沒有訂閱

終端機版與桌面版,我該用哪個?

兩者跑的是同一套引擎,設定也共用:你寫的 CLAUDE.md、裝的 MCP 伺服器、自訂的 skills,在兩邊都認得。所以這不是「選一個就回不了頭」的決定,你可以兩邊都開著。

桌面版的強項是視覺:修改前後的差異一目瞭然、可以同時開好幾個工作階段並排跑、內建終端機與瀏覽器面板、還能排定期任務。想看清楚 AI 到底改了什麼,桌面版比較舒服。

終端機版的強項是完整與可組合:它是功能最齊的介面,也能跟其他指令串接、寫進自動化腳本、掛進伺服器。想把 AI 變成流程的一環,終端機版才做得到。

06

第一次使用 Claude Code

登入、操作、對話

啟動與登入

  • 先切到工作資料夾

    用 cd 指令進到你想讓它幫忙的那個資料夾

  • 輸入 claude

    就這一個字,小寫,按 Enter

  • 選擇帳號類型

    第一次會問你用訂閱帳號還是 Console 帳號

  • 瀏覽器完成授權

    登入後回到終端機,會看到歡迎訊息與提示符號

  • 之後想換帳號

    在對話中輸入 /login 就能重新登入

第一次啟動 Claude Code

bash
# 進到你想工作的資料夾
cd ~/Desktop

# 啟動
claude

# 第一次會跳出登入選項,瀏覽器完成授權後
# 回到終端機,看到提示符號就可以直接打字了

# 想換帳號,在對話中輸入
/login

五個一定要會的按鍵

  • Enter

    送出你打的內容

  • Shift + Enter

    換行但不送出,適合寫比較長的需求

  • Shift + Tab

    切換權限模式,下一頁詳細說明

  • Esc

    中斷 Claude 正在做的事,隨時可以喊停

  • Ctrl + D 按兩次

    離開 Claude Code,也可以輸入 /exit

權限模式:用 Shift + Tab 切換

  • 預設模式

    每次要改檔案或執行指令前都先問你,最安全

  • Plan(計畫模式)

    只讀不寫,先跟你講它打算怎麼做,你同意了才動手

  • Accept edits

    自動接受檔案修改,適合你已經信任的重複性工作

  • 建議的習慣

    不熟的任務先用 Plan 看它的計畫,確認方向對了再放行

常用指令速查

  • /help

    列出目前可用的所有指令

  • /clear

    清空這一輪對話,從乾淨的狀態重來

  • /model

    切換模型,或直接打 /model sonnet 指定

  • /resume

    把之前中斷的對話接回來繼續

  • /exit

    離開 Claude Code

選對模型:四個層級

  • Fable 5

    最強也最慢,留給跨越好幾個小時的硬任務

  • Opus 5

    複雜推理的主力,需要想清楚再動手的工作用它

  • Sonnet 5

    日常工作的預設選擇,速度與品質的平衡點

  • Haiku

    最快最省,適合單純明確的小任務

  • 怎麼選

    不確定就先用預設值。等你感覺「它想得不夠深」再往上調

實際對話範例

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

讓 Claude Code 幫你做事的訣竅

  • 說清楚目標

    不要說「幫我寫程式」,要說「幫我用 Python 寫一個計算 BMI 的程式」

  • 給具體路徑

    不要說「那個檔案」,要說「桌面上的 report.docx」

  • 分步驟下指令

    複雜任務拆成小步:先建資料夾,再建檔案,再寫內容

  • 先看計畫再放行

    大工程先用 Plan 模式,確認它理解對了再讓它動手

  • 卡住就直接問它

    你可以問「你剛剛做了什麼」「為什麼這樣改」,它會解釋

07

常見問題與排解

卡住了?這裡找答案

問題一:找不到 claude 指令

  • 症狀

    終端機顯示「command not found: claude」或「claude 不是內部命令」

  • 最常見原因

    安裝完沒有重開終端機,系統還沒讀到新的路徑設定

  • 第一步

    關掉整個終端機視窗,重新開一個,再試一次

  • 第二步

    確認你打的是小寫 claude,不是 Claude

  • 還是不行

    重跑一次安裝指令,然後用 claude doctor 看診斷報告

問題二:安裝指令貼上去就報錯

  • 「不是有效的陳述式分隔符號」

    你在 PowerShell 卻貼了 CMD 的指令,改用 irm 那一行

  • 「irm 不是內部或外部命令」

    你在 CMD 卻貼了 PowerShell 的指令,改用 curl 那一行

  • 「syntax error near unexpected token」

    指令沒複製完整,或被聊天軟體改掉了引號,重新複製一次

  • 回傳 403 或連線失敗

    通常是網路被擋,看下一頁

問題三:登入後說「需要付費方案」

  • 原因

    Claude Code 需要 Pro、Max、Team 或 Enterprise 訂閱

  • 解法

    到 claude.ai 進 Settings,找到 Billing,升級到付費方案

  • 常見誤會

    桌面 app 能打開,不等於 Code 分頁能用。Chat 免費,Code 要付費

  • 另一條路

    用 Anthropic Console 帳號預付額度,也可以登入使用

問題四:公司或學校網路裝不起來

  • 症狀

    安裝到一半卡住、逾時,或回傳 403

  • 原因

    企業防火牆或代理伺服器擋掉了下載來源

  • 最快的驗證方式

    改用手機熱點再跑一次安裝指令,成功就確定是網路問題

  • 正式解法

    請資訊人員放行 claude.ai 與 downloads.claude.ai

更新與解除安裝

bash
# 原生安裝版會自動更新,想立刻更新就打
claude update

# 解除安裝(Mac 與 Linux)
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

# 解除安裝(Windows PowerShell)
Remove-Item "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item "$env:USERPROFILE\.local\share\claude" -Recurse -Force

排錯的萬用心法

  • 先跑 claude doctor

    它會直接告訴你哪裡不對,以及建議怎麼修

  • 把錯誤訊息整段複製

    不要只說「壞掉了」,貼完整訊息才找得到原因

  • 問 Claude Code 它自己

    啟動後直接問「我遇到這個錯誤該怎麼辦」,它很懂自己

  • /help 是免費的地圖

    忘記指令就打 /help,不用回頭翻投影片

08

裝好之後的下一步

從「能用」到「用得好」

第一件事:寫一份 CLAUDE.md

  • 它是什麼

    放在資料夾根目錄的一個文字檔,每次啟動都會被讀進去

  • 寫什麼

    你的習慣、禁忌、專案背景、希望它怎麼回報

  • 為什麼重要

    同樣的交代講一次寫進去,就不用每次對話都重講

  • 怎麼開始

    直接叫它「幫我建一個 CLAUDE.md」,它會先問你幾個問題

第二件事:養成先看計畫的習慣

  • Shift + Tab 切到 Plan

    大一點的任務一律先進計畫模式

  • 它會先講怎麼做

    列出步驟、要動哪些檔案、有什麼風險,全程不動你的東西

  • 你負責的是判斷

    看方向對不對,不對就在這時候改,成本最低

  • 同意了再放行

    確認之後才讓它動手,省下大量事後收拾的時間

第三件事:把重複的工作變成 Skill

  • Skill 是什麼

    一段寫好的工作流程,之後打一個斜線指令就能重跑

  • 適合什麼

    每週的報表整理、固定格式的貼文、發布前的檢查清單

  • 怎麼開始

    在對話中打斜線,看看有哪些現成的可以用

  • 進階

    你也可以請 Claude Code 幫你把剛剛跑順的流程寫成一個 Skill

不寫程式的人可以拿它做什麼

  • 整理檔案

    批次改名、依規則分類、把散落的資料夾收乾淨

  • 處理資料

    讀 CSV 與 Excel,做統計、找異常、畫圖表

  • 內容產製

    把一篇長文改寫成電子報、社群貼文與影片腳本

  • 做出你自己的網站

    從零建立個人品牌網站或報名頁,全程用中文對話

  • 當你的家教

    請它邊做邊教,做完一件事的同時也學會一件事

最好的學習方式就是裝好之後開始用。不用等到「準備好」:打開終端機,跟 Claude 說「你好」,一切就開始了。
Vista Cheng

vista.tw

09

想繼續深入學習?

Vista 的 AI 實戰工作坊,帶你從會裝到會用

裝好工具只是起點

今天你學會了安裝 Claude Code,也知道了桌面 app 與其他介面的差別。但工具裝好跟「用得好」之間,還有一段關鍵距離:就像買了一臺好相機,不代表馬上能拍出好照片。

接下來推薦兩門 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 開始你的第一次對話吧!