Claude Code 完全安裝指南
2026 年最新版:一行指令裝好,十分鐘開始第一次對話
Vista Cheng · https://www.vista.tw
今日學習地圖
-
01
認識 Claude Code 家族
Chat、Cowork、Code 三種模式的真正差別
-
02
安裝前準備
帳號、方案、系統需求,以及為什麼不用再裝 Node.js
-
03
Mac 與 Windows 安裝
保姆級終端機操作,一行指令完成
-
04
第一次使用 Claude Code
登入、權限模式、常用指令、實際對話示範
-
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
安裝前準備
帳號、方案、環境一次確認
動手之前,先確認四件事
系統需求一覽
-
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 安裝就三個動作
貼上安裝指令
複製下一頁那一整行,貼進終端機按 Enter,等它跑完。
重開終端機
關掉視窗再開一個新的,讓系統認得剛裝好的 claude 指令。
驗證版本號
輸入 claude --version,看到版本號就代表成功了。
Mac 安裝指令
# 複製這一整行,貼到終端機裡按 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)
# 完整健檢:檢查安裝狀態與設定檔
claude doctor
# 進到你想要工作的資料夾
cd ~/Desktop
# 啟動 Claude Code
claude
# 想立刻更新到最新版(平常不用手動跑)
claude update
備用路線:Homebrew 與 npm(Mac)
# 備用一:已經在用 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(開頭是 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)
# 備用一: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
# 進到你想工作的資料夾
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
最快最省,適合單純明確的小任務
-
怎麼選
不確定就先用預設值。等你感覺「它想得不夠深」再往上調
實際對話範例
讓 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
更新與解除安裝
# 原生安裝版會自動更新,想立刻更新就打
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.tw
09
想繼續深入學習?
Vista 的 AI 實戰工作坊,帶你從會裝到會用
裝好工具只是起點
今天你學會了安裝 Claude Code,也知道了桌面 app 與其他介面的差別。但工具裝好跟「用得好」之間,還有一段關鍵距離:就像買了一臺好相機,不代表馬上能拍出好照片。
接下來推薦兩門 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 開始你的第一次對話吧!