安裝與第一次對話:照著打就會
功能與介面更新很快,安裝指令與畫面請以官方說明為準。
這篇你會學到
- 在 Mac 和 Windows 上打開終端機、貼上官方安裝指令,完成安裝與登入。
- 第一次啟動會看到什麼畫面、第一句話該說什麼:一個絕對安全的「介紹資料夾」練習。
- 四步口訣「先看懂、出計畫、才動手、要驗證」,讓它永遠不會在你不知情時亂改東西。
官方原文:Quickstart(功能更新以官方為準)
第 0 步:打開終端機
終端機(用打字跟電腦溝通的視窗)藏在你電腦裡,叫出來的方法:
Mac
- 按下鍵盤的 Command + 空白鍵,叫出 Spotlight(系統內建的搜尋框)。
- 輸入
Terminal(或「終端機」),按 Enter。 - 出現一個白底或黑底的文字視窗,就是它。
Windows
- 按下鍵盤的 Windows 鍵,打開開始功能表。
- 輸入
PowerShell,按 Enter。 - 出現一個藍底或黑底的文字視窗,就是它。
打開之後不用做任何事,下一步我們才要貼指令。
第 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〉)。用公司帳號的人,可能需要管理員開通權限。
重點回顧
- 安裝只有三步:打開終端機、貼官方指令、按 Enter;Mac 和 Windows 的指令本文都有,逐字照貼。
- 先建練習資料夾再啟動,
mkdir建資料夾、cd走進去,這是唯二要記的終端機指令。 - 第一句話先請它「介紹資料夾」,零風險熱身;第一次改檔練習從一個 hello.txt 開始。
- 四步口訣:先看懂、出計畫、才動手、要驗證。每個授權提示都是你的把關點,驗收永遠自己來。
- PowerShell 和 CMD 是兩種視窗,貼錯指令會報錯;看提示開頭有沒有
PS就能分辨。
下一步
- 讓它記住你的規矩,不用每次重講:CLAUDE.md:教它記住你的規矩
- 還沒看懂它是什麼:Claude Code 是什麼
- 更完整的課程脈絡:免費 L1 入門課