Claude Code 新手入門：從安裝到第一次對話

如果你聽說過 Claude Code，卻因為「要用終端機」四個字就卻步——這篇就是寫給你的。我會假設你完全沒碰過終端機，每一步都講清楚，包括那些讓新手卡住、老手卻覺得理所當然的地方。

一、Claude Code 是什麼？

Claude Code 是一個「住在終端機裡的 AI 助手」。你用打字跟它講話，它能看懂你電腦裡的檔案、幫你寫程式、改檔案、執行指令，甚至幫你把網站部署上線。

你可以把它想成一個很強的工程師助理，坐在你旁邊，你說人話，它動手做。

「終端機」就是 Mac 內建的那個純文字視窗 App。它看起來很硬派，但你只要會複製貼上，就能開始。

二、安裝

先打開「終端機」App

如果你從來沒開過終端機，最簡單的方法是用 Spotlight 搜尋：

  1. 按鍵盤的 Command +（空白鍵），畫面中央會跳出一條搜尋列。
  2. 打「終端機」三個字（打英文 Terminal 也可以），第一個出現的結果就是它。
  3. 按 Enter，就會打開一個純文字視窗，這就是終端機。

另一個方法：打開「Finder → 應用程式 → 工具程式」資料夾，裡面的「終端機」點兩下也能打開。

貼上安裝指令

終端機打開後，把下面這行貼進去、按 Enter（推薦這個官方腳本，它會自動保持更新）：

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

如果你已經用慣 Homebrew，也可以用這個：

brew install --cask claude-code

裝好後有很重要的一步：把終端機完全結束再重新打開——按鍵盤的 Command + Q 把終端機整個關掉（只關視窗不算），再重新打開一個新的。這樣它才會認得剛裝好的 claude 指令。

三、打了 claude 卻沒反應？

這是最多人卡住的地方，別緊張。如果你打 claude 沒反應、或出現「command not found」，代表電腦還沒認得這個指令。

先確認你有照上一步「用 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 這類訂閱方案都行）。登入成功後回到終端機，就進入了跟 Claude 對話的畫面。以後登入資訊會自動記住，不用每次登。

兩種帳號方式：

  • 訂閱帳號（推薦）：用 claude.com 的 Pro / Max 帳號登入，額度包在月費裡。
  • API 金鑰：到 console.anthropic.com 申請金鑰，按用量付費。適合進階或公司用。

之後想換帳號，在對話中打 /login 就能重新登入。

五、怎麼跟它聊天

進入 Claude Code 後，畫面會停在一個等你打字的地方。你就像傳訊息一樣，直接用中文打你想做的事，按 Enter 送出。例如：

  • 「幫我看看這個資料夾裡有什麼檔案」
  • 「幫我寫一個 Python 程式，把這些圖片全部縮小成一半」
  • 「這段程式為什麼會出錯？幫我找一下」

它會一邊跟你說明、一邊動手，遇到要改檔案或執行指令時會先讓你確認。你不用背任何指令，把它當成一個聽得懂人話的助理就好。

這就是最開始的一段路。裝好、登入、開始對話之後，接下來就能慢慢玩它更強的功能——這些我會在後面的文章一篇篇寫下來。有卡住的地方，也歡迎告訴我，我把它補進教學裡。