第 6 課 · 把 agent 裝到你自己的電腦:安裝與登入 Claude Code

第 6 課 · 把 agent 裝到你自己的電腦:安裝與登入 Claude Code

前面幾課你已經知道兩件事:一個是 agent(能真的動你電腦檔案的 AI 工具,跟你平常用的網頁版 AI 幫手不一樣——網頁版只能聊天、碰不到你的檔案);另一個是 terminal(第 5 課那個黑黑的、用打字下指令的視窗)。

這一課,我們要真的把 agent 裝到你自己的電腦上、登入好、確認它會動。我們手把手帶的工具叫 Claude Code

我先講一句掏心窩的話:這一課是整個系列最容易讓人放棄的地方。 不是因為它難,是因為安裝過程會跳出一堆你看不懂的字,很多人一看到就以為「我把電腦弄壞了」然後關掉不玩了。所以這一課我會做兩件事——每一步都具體到你可以照著點、照著打;每一個「你八成會嚇到」的地方,我都先幫你打預防針,告訴你「等一下會看到 X,別怕,那是正常的」。

💡 這一課你會做到:誠實盤點開始前要準備什麼 → 用一行官方指令把 Claude Code 裝好 → 登入 → 確認「我真的裝成功、也登入成功了」。


先誠實盤點:開始前你需要準備兩樣東西

在動手之前,我不想騙你「免費、三秒鐘、什麼都不用」。老實說,要讓一個 agent 住進你的電腦,你需要備齊兩樣東西。先看清楚,心裡有底:

需要什麼 白話說明
一台能裝軟體的電腦 Mac 或 Windows 都行。本課示範以 Mac 為主。你正在用的這台大概就可以。
一個「付費的」Claude 帳號 Claude Code 需要 Claude 的付費方案(個人用最常見的是 ProMax)。

第二點我要特別框起來,因為它是最多人踩的雷:

⚠️ 免費的 Claude 聊天帳號,不能用 Claude Code。 你平常在網頁上免費跟 Claude 聊天,跟「用 Claude Code」是兩回事——後者一定要有付費方案(Pro/Max 之類;公司帳號 Team/Enterprise,或開發者用的 Console 也行)。如果你還沒有付費方案,就會卡在登入後那道牆。先確認自己有、或願意開一個 Pro,再往下走,才不會裝到一半發現用不了。

關於錢,你只要先抓兩個重點,細節第 7 課會講清楚:

  1. 有了付費方案,平常用它做事大多算在方案額度裡,不是每做一件事都另外掏錢。
  2. 它到底怎麼算錢(那個叫 token 的花費計量單位、怎麼看自己花多少、怎麼用得省),我完全留到第 7 課專門講。這一課你只要先確認「我有一個付費的 Claude 帳號」就好。

全程長怎樣:兩步,大概 10 分鐘

別被「安裝」兩個字嚇到。整件事其實就兩步,像搬進新家:先把家具搬進來,再開門進去住。

flowchart LR A["① 一行指令裝好 Claude Code"] --> B["② 啟動並登入"] B --> C["✅ 確認它真的會動"]

我們一步一步來。每一步做完我都會給你一個「怎麼確認這步過了」的檢查,過了再往下走,你就不會走到一半不知道自己在哪。

⚠️ 先講一個心態:整個過程你會看到很多黑底白字、跑一堆你看不懂的英文。 那是正常的,不是壞掉。那些字是電腦在「跟你回報它正在做什麼」,就像搬家工人一邊搬一邊喊「桌子進來囉、櫃子放這囉」。你不需要看懂每一句,你只需要看最後有沒有成功


步驟一:用一行官方指令裝好 Claude Code

好消息:裝 Claude Code 不需要你先裝一堆別的東西。官方有一行「一鍵安裝」指令,貼下去、按 Enter,它會自己把該裝的都裝好。

打開 terminal(第 5 課那個黑黑的、打字下指令的視窗),把下面這行用複製貼上放進去(別手打,裡面有一長串符號,一個都不能錯),然後按 Enter:

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

💡 這行可以放心貼嗎? 可以。它是 Claude 官方網站(claude.ai 提供的官方安裝指令——就像去官網下載一個 App。(第 9 課我會教你怎麼判斷「哪些指令能放心貼、哪些要小心」;從官方網站來的這種,屬於可以放心的。反而是路邊來路不明、叫你複製一長串的,才要提防。)

💡 你用的是 Windows? 前面「打開 terminal」那步,Windows 是到開始選單搜尋、打開 Windows Terminal 或 PowerShell。上面那行 curl 是 Mac 用的,Windows 請改成貼下面這行(一樣複製貼上、別手打),再按 Enter:

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

之後啟動 claude、登入的流程,Mac 和 Windows 完全一樣,照本課往下走就好。

按下 Enter 之後,畫面會開始跑東西。這裡我一次幫你打好兩支預防針:

⚠️ 預防針一:它會跑一陣子,畫面像卡住不動。 從幾十秒到幾分鐘都有可能(看你網路快慢)。只要它沒跳出紅色的錯誤、最後回到你可以打字的狀態,就代表它在乖乖工作。 泡杯水等它。

⚠️ 預防針二:中間你會看到一堆進度條、百分比、你看不懂的英文。 那是它在「下載+安裝」的正常回報,不用一句一句看懂。你只要等它跑完、看最後有沒有成功就好。

怎麼確認步驟一過了?

裝完,在 terminal 打下面這行、按 Enter:

claude --version

如果你看到一串**版本號(數字,例如 2.1.xx)**跑出來,恭喜,Claude Code 已經住進你電腦了(數字幾多不重要,有出現就對了)。

⚠️ 如果你打 claude --version 卻看到 command not found(找不到指令),別怕,這幾乎都不是真的沒裝成功。最常見的原因是:terminal 在你裝之前就開著,還沒「知道」電腦裡多了新東西。解法超簡單:把 terminal 整個關掉、重新打開,再打一次。 十之八九就出現了。要是重開還是找不到,就把前面那行安裝指令再貼一次、重跑一遍;或者到官方安裝頁,照它當下寫的步驟再做一次。

💡 裝好了、claude 也進得去,但總覺得哪裡怪怪的?(比如它回話怪怪的、某個功能卡住)這時候才輪到 claude doctor 上場:在 terminal 打 claude doctor 按 Enter,它會自己幫你做一次健康檢查、告訴你哪裡不對勁。

💡 不想碰安裝指令的人,還有一條路:Claude Code 也可以用別的方式裝(例如 Mac 的 Homebrew、或給已經有 Node.js 的人用的 npm)。但對「就是想最快裝好、之後還會自動更新」的你,上面那行官方安裝就是最省事的一條,我們用它就好。


步驟二:啟動並登入

家具搬進來了,現在開門進去。在 terminal 裡打一個字、按 Enter:

claude

第一次啟動,它會跳出一個歡迎畫面,並且帶你走登入流程。大致會是這樣:

  1. 它會問你要用哪種方式登入——選「用 Claude 帳號登入」那個(畫面上可能另外有一個 API 的選項,那是給開發者按用量另外付費用的,一般 Pro/Max 方案選它會用不了,別選錯)。接著它會自動幫你打開瀏覽器(如果沒自動開,它會給你一段網址,你把那段網址複製到瀏覽器貼上、按 Enter 就好)。
  2. 在瀏覽器裡,用你的 Claude 付費帳號登入——就是前面盤點時確認的那個 Pro/Max 帳號。
  3. 它會問你「要不要授權」之類的,按同意/授權
  4. 授權完,瀏覽器會叫你回到 terminal,有時會給你一小段驗證碼要你貼回 terminal。照它說的做即可。

⚠️ 第一次啟動,Claude Code 可能還會問你一兩個確認問題,比如「你信不信任現在這個資料夾」。這一課你先照預設/繼續走就好。至於怎麼「看住它、別讓它亂動你的檔案」,那是很重要的一課,但我留到第 9 課專門講,這裡先不岔開。

⚠️ 登入這一步,如果瀏覽器沒有自動彈出來,不要以為失敗了。回頭看 terminal,它八成印了一段網址在那——把那段網址整條複製、貼到瀏覽器就能繼續。

⚠️ 如果登入後它跟你說「需要有效的付費方案」或把你導去付費頁,那就是前面提醒的——免費帳號不能用。你得先開通一個 Claude 的付費方案(Pro/Max 之類),才能真的開始叫它做事。


收尾驗收:怎麼確認「我全部都成功了」

前面每一步都各自驗收過了,最後我們做一個「整條打通」的小測試,讓你親眼看到它活著

在 terminal 打 claude 進去(如果剛剛登入完你還在裡面,就直接用)。你會看到一個可以打字的框。這時候,給它一句你給它的指示,最簡單的:

你好,用一句話介紹你自己。

按 Enter。只要它回你話了,代表安裝 + 登入整條都通了。 這就是成功。

如果你想更過癮一點、親眼看到它「有手腳」(呼應第 4 課,agent 跟網頁版 AI 幫手最大的差別就是它真的能動你的檔案),可以再給它這句指示:

在現在這個資料夾裡,建一個叫 hello.txt 的檔案,裡面寫「我成功了」。

它做完之後,你到電腦的資料夾裡(就是你打開 terminal 時它所在的那個資料夾)去看,如果真的多出一個 hello.txt、打開裡面寫著「我成功了」——那你就親手見證了:這不是只會聊天的網頁版 AI 幫手,這是真的會動你電腦的 agent。

💡 成功長怎樣,對一下這張清單:

  • [ ] claude --version 有跑出版本號(數字)
  • [ ] 打 claude 進得去、看得到可以打字的框
  • [ ] 你給它一句指示,它會回你話
  • [ ](想更仔細的話)打 claude doctor 顯示一切正常

前三項都打勾,你就正式「有一個裝在自己電腦裡、能動手做事的 agent」了。

💡 想離開 Claude Code 怎麼辦? 很多人第一次進去就慌「我要怎麼出來」。很簡單:連按兩下 Ctrl(控制鍵)+ C,或者在框裡打 /exit 再按 Enter,就回到普通的 terminal 了。下次要再用,一樣打 claude 就進得去,不用重裝、不用重登入


順帶一提:其實還有另一個很像的選擇

你之後可能會聽到一個叫 Codex 的東西,它是另一個跟 Claude Code 很類似的 agent 幫手,安裝、登入的邏輯大同小異。這系列我們專心把 Claude Code 帶熟,就不重複教一遍 Codex 了——你把這一課學會,日後想試 Codex,也會有種「啊,套路差不多嘛」的熟悉感。


這一課你完成了什麼

你從「聽過 agent」正式跨到「電腦裡真的有一個 agent、而且我登入好、確認它會動了」。具體來說:

  • 誠實盤點了前置需求:一台能裝軟體的電腦、以及一個付費的 Claude 帳號(Pro/Max 之類,免費聊天帳號不行)。
  • 你用一行官方安裝指令curl -fsSL https://claude.ai/install.sh | bash)把 Claude Code 裝好,再打 claude 啟動、用瀏覽器登入。
  • 你會用 claude --version(看裝好沒)、claude doctor(做健康檢查)、以及「叫它回你一句話」來確認自己真的裝好、登入好了

下一課(第 7 課),我們來面對那個你剛剛瞄到一眼的問題:用它到底怎麼花錢? 我們會把 token 這個花費計量單位講到你會自己估:一件事大概花多少、怎麼用得省。裝好了,就該懂怎麼精打細算地用它了。