Claude Code 教學/第 2 篇・共 17 篇
Claude Code 新手入門:從安裝到第一次對話
完全沒碰過終端機也沒關係。這篇帶你避開釣魚網站、一步步裝好 Claude Code、解決「打了沒反應」的常見卡關、選對訂閱方案,然後開始第一次對話。
更新於
如果你聽說過 Claude Code,卻因為「要用終端機」四個字就卻步——這篇就是寫給你的。我會假設你完全沒碰過終端機,每一步都講清楚,包括那些讓新手卡住、老手卻覺得理所當然的地方。
一、Claude Code 是什麼?
Claude Code 是一個「住在終端機裡的 AI 助手」。你用打字跟它講話,它能看懂你電腦裡的檔案、幫你寫程式、改檔案、執行指令,甚至幫你把網站部署上線。
你可以把它想成一個很強的工程師助理,坐在你旁邊,你說人話,它動手做。
「終端機」就是 Mac 內建的那個純文字視窗 App。它看起來很硬派,但你只要會複製貼上,就能開始。
2026 年 7 月更新:現在有官方「桌面版 App」了,完全不用終端機也能用 Claude Code——如果你光看到「終端機」三個字就想關掉這篇,可以先跳去看本系列第 10 篇〈新的一扇門〉,從桌面版上車。想學正統終端機用法(自動化能力最完整),就繼續往下讀。
二、安裝
動手之前:小心釣魚網站
先講一個安裝前最容易中招的坑。用 Google 搜尋「Claude Code」時,搜尋結果最上面標著「贊助商」的那幾條,千萬不要點。有心人士會買廣告,做出跟 Claude 官網長得一模一樣的釣魚網站,上面的「安裝指令」可能讓你下載到惡意程式。
判斷方法很簡單:認網址。只信 claude.com、claude.ai 這兩個網域,官方教學文件則在 code.claude.com。往下捲、跳過廣告,點有這些網址的結果才安全。這個提醒來自中文圈觀看數最高的 Claude Code 教學(柚智夫妻與雷蒙三十那支影片),雷蒙特地把它放在安裝步驟的最前面——因為真的有人在這一步就出事。
下面的安裝指令我都直接抄自官方文件(code.claude.com,2026 年 7 月查證),你可以放心照貼。
先講清楚:以下是 Mac 的安裝教學。 用 Windows 的朋友不用往下跟——直接看本系列的〈Windows 安裝完全指南〉,那篇從打開 PowerShell 到裝好必備的 Git 一步步帶你,裝完再回來從本文的「第一次啟動與登入」接著讀就行。
先打開「終端機」App
如果你從來沒開過終端機,最簡單的方法是用 Spotlight 搜尋:
- 按鍵盤的 Command +(空白鍵),畫面中央會跳出一條搜尋列。
- 打「終端機」三個字(打英文 Terminal 也可以),第一個出現的結果就是它。
- 按 Enter,就會打開一個純文字視窗,這就是終端機。
另一個方法:打開「Finder → 應用程式 → 工具程式」資料夾,裡面的「終端機」點兩下也能打開。
貼上安裝指令
終端機打開後,把下面這行貼進去、按 Enter(推薦這個官方腳本,它會在背景自動保持更新):
curl -fsSL https://claude.ai/install.sh | bash
如果你已經用慣 Homebrew,也可以用這個(要注意:用 brew 裝的話,之後更新要自己動手,不像官方腳本會自動更新):
brew install --cask claude-code
裝好後有很重要的一步:把終端機完全結束再重新打開——按鍵盤的 Command + Q 把終端機整個關掉(只關視窗不算),再重新打開一個新的。這樣它才會認得剛裝好的 claude 指令。
三、打了 claude 卻沒反應?
這是最多人卡住的地方,別緊張。如果你打 claude 沒反應、或出現「command not found」,代表電腦還沒認得這個指令。
先給你一個內行人才知道的小提示:其實答案就印在安裝完成的畫面裡。安裝結束時,終端機會顯示一段 Setup notes:,裡面直接附了修復指令。雷蒙在影片裡說得很白:「大家安裝會卡住,通常是沒看備註。」所以卡住時,先往上捲看看安裝訊息。
具體解法:先確認你有照上一步「用 Command + Q 完全結束終端機、再重新打開」。如果重開後還是不行,把下面這行整段貼進終端機、按 Enter,再打一次 claude 就會好:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
為什麼會這樣? 官方安裝器把 claude 放在 ~/.local/bin 這個資料夾,並把這個路徑寫進你的設定檔 ~/.zshrc。但「已經開著的那個終端機視窗」不會自動重讀設定檔,所以要重開、或用上面那行 source 一次,它才認得。
想確認裝好了沒,可以打:
claude --version
有出現版本號,就代表成功了。
四、第一次啟動與登入
在終端機打 claude 再按 Enter:
claude
第一次啟動會有一小段引導流程,大概是這四步:
- 選外觀主題:畫面會先出現吉祥物,讓你選深色或淺色主題,看順眼的選就好。
- 選登入方式:畫面會給你三個選項——第一個是用 Claude 訂閱帳號(Pro、Max、Team、Enterprise),第二個是 Anthropic Console 帳號(按 API 用量計費),第三個是第三方平台(Amazon Bedrock 這類,公司環境才會用到)。一般人選第一個。
- 瀏覽器授權:它會自動打開瀏覽器要你登入。確認頁面下方顯示的是你的帳號,按下授權按鈕,關掉網頁回到終端機就完成了。以後登入資訊會自動記住,不用每次登。
- 信任資料夾:它會問你是否信任目前所在的資料夾,確認後就進入對話畫面。如果 macOS 跳出系統權限提示,點允許。
進入前它還會顯示一段安全提醒(Security notes),兩句話值得記住:Claude 會犯錯,執行程式碼前務必檢查它的回應;以及因為有 prompt injection 風險,只在你信任的程式碼上使用它。現在看不懂沒關係,先記得「它不是不會錯」這件事就好,之後的文章會再展開。
方案怎麼選:先買 Pro 就好
這裡補充一下大家最常問的錢的問題。Claude Code 不能用免費帳號,需要 Pro 以上的訂閱。官方方案目前長這樣:
| 方案 | 價格 | 說明 |
|---|---|---|
| Free | $0 | 只能用網頁版聊天,不能用 Claude Code |
| Pro | $20 美元/月 | 新手起點,額度包在月費裡 |
| Max 5x | $100 美元/月 | Pro 的 5 倍用量 |
| Max 20x | $200 美元/月 | Pro 的 20 倍用量 |
我的建議跟幾支高觀看教學影片的共識一樣:先買 Pro,每月 20 美元,額度不夠用再考慮升級 Max。至於另一條路——申請 API 金鑰按用量付費——雷蒙的原話是「在 Claude 的世界會花到可怕的金額」,除非你是進階用戶或公司環境,一般人一定選月訂閱,訂閱制用完額度就是等重置,不會有帳單爆炸的意外。
(額度的具體數字官方會不定期調整,我就不寫死在文章裡了,以官方最新公告為準。)
過來人建議:用「手機」訂閱,之後好管理
訂閱的動作本身,我建議在安裝之前,先用手機的 Claude App 完成:
- 手機下載 Claude App(App Store/Google Play,認明 Anthropic 出品),登入你的帳號。
- 在 App 裡升級 Pro——這樣訂閱走的是手機商店的「App 內訂閱」。
- 回到電腦,Claude Code 登入同一個帳號,訂閱直接生效。
為什麼特地這樣做?因為訂閱管理會統一在手機商店裡:之後想確認扣款、續訂或取消,打開手機的訂閱設定就全部在那(iPhone:設定 → 點你的名字 → 訂閱項目;Android:Play 商店 → 付款與訂閱)。網路服務訂久了,最常見的困擾就是「這筆錢當初是在哪裡訂的?」——訂閱散在各家網站,取消時找不到門。全部走手機商店,就一個地方管到底。
小提醒:App 內訂閱的價格可能與官網略有出入(商店抽成的關係,依地區而異),按下去之前看一眼金額。如果你已經在網頁上訂過了也沒關係,不用改——只是記得你是在 claude.com 訂的,取消要回官網帳號設定裡操作。
之後想換帳號,在對話中打 /login 就能重新登入。
五、怎麼跟它聊天
進入 Claude Code 後,畫面會停在一個等你打字的地方。你就像傳訊息一樣,直接用中文打你想做的事,按 Enter 送出。
第一句話:先問問題,不要先叫它做事
這是 Claude Code 的作者 Boris Cherny 在官方演講裡給新手的第一個建議:入門的第一步不是叫它寫程式、也不是玩花俏功能,而是先問問題。在 Anthropic 內部,新員工報到第一天就是這樣被教的——裝好 Claude Code,直接問它關於專案的問題,入職上手時間因此從兩三週縮短到兩三天。
為什麼?因為「問問題」是零風險的:它不會改動你的任何檔案,你卻能藉此學會怎麼跟它說話、摸清它的能力邊界——哪些事它一次就懂、哪些要來回幾輪。所以你的第一句話可以是:
- 「幫我看看這個資料夾裡有什麼檔案」
- 「這個資料夾裡的檔案是做什麼用的?」
- 「這段程式為什麼會出錯?幫我找一下」
等你對它有感覺了,再開始交辦動手的任務:
- 「幫我寫一個 Python 程式,把這些圖片全部縮小成一半」
它會一邊跟你說明、一邊動手,遇到要改檔案或執行指令時會先讓你確認。你不用背任何指令,把它當成一個聽得懂人話的助理就好。
不會就直接問它:「把自己當巨嬰」
最後送你一個心法,來自雷蒙那支影片,他叫它**「把自己當巨嬰」:遇到任何不會的事,第一反應不是卡住、也不是去 Google,而是直接把問題用白話丟給 Claude Code**。
影片裡有個很好的示範:雷蒙想讓 Claude Code 切換到某個資料夾工作,但他不會下指令,於是直接打「我該怎麼讓你移動到(資料夾路徑)裡面進行後續任務呢?」——結果 Claude Code 不只告訴他指令是什麼,還直接幫他執行完了。工程師都知道那個指令叫 cd,但你根本不需要知道。
這個心法會貫穿你之後用 Claude Code 的每一天:裝軟體、修環境、設定工具,全部都可以「叫它帶你做」。你要學的不是指令,是怎麼開口問。
這就是最開始的一段路。裝好、登入、開始對話之後,接下來就能慢慢玩它更強的功能——這些我會在後面的文章一篇篇寫下來。有卡住的地方,也歡迎告訴我,我把它補進教學裡。
本文參考素材
- 柚智夫妻 X 雷蒙三十:〈Claude Code 零基礎入門(上)|非工程師也能打造 AI 助理的詳細配置教學〉(https://www.youtube.com/watch?v=xo7dE80ktu4)——釣魚網站警告、PATH 卡關、方案建議與「巨嬰」心法
- PAPAYA 電腦教室:〈Claude Code 保姆級教學〉(https://www.youtube.com/watch?v=2pM-7fBXc_M)——首次啟動流程、登入選單與方案價格表
- Boris Cherny(Anthropic,Claude Code 作者)官方演講(https://www.youtube.com/watch?v=WpewI22B-2I)——「第一步先問問題」的入門建議
- 安裝指令與方案資訊以官方文件為準(code.claude.com,2026 年 7 月查證)