難度:入門約 12 分鐘適合:所有人更新:2026-07-07

安裝與第一次對話:照著打就會

功能與介面更新很快,安裝指令與畫面請以官方說明為準。

這篇你會學到

  1. 在 Mac 和 Windows 上打開終端機、貼上官方安裝指令,完成安裝與登入。
  2. 第一次啟動會看到什麼畫面、第一句話該說什麼:一個絕對安全的「介紹資料夾」練習。
  3. 四步口訣「先看懂、出計畫、才動手、要驗證」,讓它永遠不會在你不知情時亂改東西。

官方原文:Quickstart(功能更新以官方為準)

第 0 步:打開終端機

終端機(用打字跟電腦溝通的視窗)藏在你電腦裡,叫出來的方法:

Mac

  1. 按下鍵盤的 Command + 空白鍵,叫出 Spotlight(系統內建的搜尋框)。
  2. 輸入 Terminal(或「終端機」),按 Enter。
  3. 出現一個白底或黑底的文字視窗,就是它。

Windows

  1. 按下鍵盤的 Windows 鍵,打開開始功能表。
  2. 輸入 PowerShell,按 Enter。
  3. 出現一個藍底或黑底的文字視窗,就是它。

打開之後不用做任何事,下一步我們才要貼指令。

第 1 步:貼上安裝指令

以下指令逐字來自官方文件〈Quickstart〉。認明來源很重要:搜尋引擎上有假冒的下載站,請只用官方網域(claude.ai、claude.com、anthropic.com)提供的指令。

Mac(以及 Linux、WSL):複製下面整行,貼到終端機,按 Enter。

curl -fsSL https://claude.ai/install.sh | bash

Windows(PowerShell):複製下面整行,貼到 PowerShell,按 Enter。

irm https://claude.ai/install.ps1 | iex

Windows(CMD,命令提示字元):如果你用的是 CMD 而不是 PowerShell,改貼這行。

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

怎麼分辨自己在 PowerShell 還是 CMD?看視窗裡的提示文字:開頭是 PS C:\ 就是 PowerShell;只有 C:\ 沒有 PS 就是 CMD(依官方文件〈Quickstart〉)。

Windows 使用者多一步:官方建議在 Windows 上安裝 Git for Windows(一套免費的版本管理工具),這樣 Claude Code 才能使用 Bash 工具;沒裝的話它會改用 PowerShell 當作執行指令的工具(依官方文件〈Quickstart〉)。到 git-scm.com 下載,安裝時一路按「下一步」用預設值即可。

貼上指令按 Enter 後,畫面會跑一段安裝訊息,停下來沒有報錯就是裝好了。官方的原生安裝方式會在背景自動更新,你之後不用手動升級(依官方文件〈Quickstart〉)。

第 2 步:建一個練習資料夾

不要在桌面或系統根目錄直接跑,先給它一個安全的小房間。在終端機逐行貼上(每行按一次 Enter):

mkdir claude-practice
cd claude-practice

mkdir 是建立資料夾,cd 是走進那個資料夾。這是本篇唯一要學的兩個終端機指令。之後 Claude Code 的所有動作都會以這個資料夾為工作範圍。

第 3 步:啟動並登入

在終端機輸入:

claude

第一次啟動會請你登入:照畫面指示操作,它會打開瀏覽器讓你登入 Claude 帳號完成授權。可以用 Pro、Max、Team、Enterprise 訂閱,或 Claude Console 帳號登入;登入一次之後憑證會存在你的電腦裡,之後不用重登(依官方文件〈Quickstart〉)。若日後要換帳號,在對話中輸入 /login 即可。

登入完成後,你會看到 Claude Code 的輸入提示,上方顯示版本編號、目前使用的模型、目前的工作資料夾(依官方文件〈Quickstart〉)。看到這個畫面,代表一切就緒——接下來就是用中文打字聊天了。

第 4 步:第一個安全練習——請它介紹資料夾

第一句話不要叫它做東西,先請它「看」。因為只是閱讀和回答,不會改動任何檔案,零風險。可以先請它建一個小檔案再練習觀察,或直接找一個你既有的資料夾練習:

練習甲(空資料夾起步):在剛剛的練習資料夾裡輸入:

這個資料夾目前是空的。請幫我建立一個 hello.txt,內容寫「我的第一個 Claude Code 檔案」。

它會顯示要建立的檔案內容,並徵求你同意;你按下同意,再自己打開資料夾確認 hello.txt 真的出現了——恭喜,你完成了第一次「交辦、授權、驗收」。

練習乙(用既有資料夾):先用 cd 走進某個你想了解的資料夾(例如一個舊專案、一堆下載的文件),啟動 claude 之後輸入:

請介紹這個資料夾的內容:裡面有哪些檔案、大概在做什麼用途、有沒有重複或雜亂的地方?

官方的入門教學同樣建議用「這個專案在做什麼?」這類理解型問題開場,Claude 會自己讀取需要的檔案再回答,你不需要手動餵檔案(依官方文件〈Quickstart〉)。

四步口訣:先看懂、出計畫、才動手、要驗證

這是本系列最重要的一段。Claude Code 很強,但把關的人是你。每次交辦任務,心裡默念四步:

1. 先看懂:先讓它讀、讓它說,不要一開口就叫它改。 「先分析這個資料夾的結構,先不要改任何東西。」

2. 出計畫:要求它先列步驟給你看。 「列出你打算怎麼做,一步一步說明,等我同意再開始。」

3. 才動手:你看過計畫、按下同意,它才執行。它每次要改檔案本來就會徵求授權(依官方文件〈Quickstart〉),不要嫌煩就全部盲目同意——每一次授權提示都是你的把關點。

4. 要驗證:做完不等於做對。自己打開成果看一眼:檔案真的建了嗎?網頁打得開嗎?內容是你要的嗎?台灣創作者的實戰經驗是:測試發現錯誤時完全不用慌,把錯誤訊息複製或截圖貼回去,請它修正,修好再繼續下一個功能——這個「小步做、勤驗收」的循環就是最穩的用法。

常用指令小抄

依官方文件〈Quickstart〉,先記這幾個就夠:

指令 在哪打 作用
claude 終端機 啟動互動對話
claude -c 終端機 接續這個資料夾最近一次的對話
/help 對話中 列出可用指令
/clear 對話中 清空對話紀錄,重新開始
/exit(或 Ctrl+D) 對話中 離開 Claude Code

常見卡點

1. Windows 貼指令出現 The token '&&' is not a valid statement separator 症狀:貼了 CMD 的安裝指令卻報這個錯。 解法:你其實在 PowerShell 裡,不是 CMD。改貼 PowerShell 版指令(irm ... | iex 那行)就好(依官方文件〈Quickstart〉)。

2. Windows 出現 'irm' is not recognized as an internal or external command 症狀:貼了 PowerShell 的指令卻報這個錯。 解法:你其實在 CMD 裡。改貼 CMD 版指令,或開始功能表重新搜尋 PowerShell 打開再貼(依官方文件〈Quickstart〉)。

3. 搜尋「Claude Code 下載」點進了奇怪的網站 症狀:搜尋結果最上面的廣告連到長得很像官方的頁面。 解法:不要從廣告進入。認明 claude.ai、claude.com、anthropic.com 網域,或直接用本文的官方指令。

4. 裝好了,輸入 claude 卻說找不到指令 症狀:終端機回覆 command not found 之類訊息。 解法:先把終端機視窗整個關掉、重開一個新視窗再試——安裝後舊視窗常常還沒認得新指令。還是不行,參考官方的安裝疑難排解文件,或改用免安裝的網頁版(claude.ai/code)先開始。

5. 登入時卡在方案問題 症狀:登入後提示無法使用。 解法:確認你的帳號是 Pro 以上訂閱或 Console 帳號(依官方文件〈Quickstart〉)。用公司帳號的人,可能需要管理員開通權限。

重點回顧

  1. 安裝只有三步:打開終端機、貼官方指令、按 Enter;Mac 和 Windows 的指令本文都有,逐字照貼。
  2. 先建練習資料夾再啟動,mkdir 建資料夾、cd 走進去,這是唯二要記的終端機指令。
  3. 第一句話先請它「介紹資料夾」,零風險熱身;第一次改檔練習從一個 hello.txt 開始。
  4. 四步口訣:先看懂、出計畫、才動手、要驗證。每個授權提示都是你的把關點,驗收永遠自己來。
  5. PowerShell 和 CMD 是兩種視窗,貼錯指令會報錯;看提示開頭有沒有 PS 就能分辨。

下一步