附件 APOLARIS · 北極星商圈

Claude Code 安裝教學

從零開始把 Claude Code 裝到你的筆電。預計需要 10–15 分鐘。先 macOS、再 Windows、最後是首次登入與卡關排查。

1 · Claude Code 是什麼？

1.1 Claude 目前有 5 種使用方式

很多人用過 claude.ai 網頁版就以為「Claude = 網頁聊天」── 其實 Anthropic 把 Claude 包成 5 種產品，每一種適合不同事情：

1.2 為什麼今天要教你用 Terminal 版（Claude Code）？

因為「最瞭解公司流程的人 = AI 系統的開發者」這件事，網頁版做不到。

網頁版 Claude 只能告訴你「你應該這樣做」 ── 但它不能真的幫你做出來、跑起來、上線給客戶用。它沒有訪問你電腦的權限、不能跑指令、不能改檔案、不能部署。

Claude Code 不一樣 ── 它真的在你電腦上動手：

• 讀你的檔案、改你的檔案
• 跑指令（裝套件、執行 script、部署到雲端）
• 建一個新專案、做完、上線、給你網址

對企業主來說最直接的應用：建客服 FAQ Bot、自動化報價 / 報關文件、做產品 / 案例展示頁、整理 SOP 跟客訴知識庫。今天分享會走完從安裝到部署的完整路徑。

2 · 動手前確認 3 件事

1. 有 Claude 帳號 ── 用 Google 登入最快，免費試用 Claude Code 有額度，後續建議升級 Pro（USD $20/月）讓額度寬鬆些。
2. 網路穩定 ── 安裝過程要從網路抓 200 MB 左右的檔案。
3. 有 sudo / 管理員權限 ── 公司配發筆電如果不能裝軟體，請先請 IT 開權限。

3 · macOS 安裝

3.1 開啟終端機

按 Cmd + 空白 叫出 Spotlight，輸入「終端機」（或英文 Terminal）並按 Enter。會跳出一個黑底白字的視窗。

3.2 安裝 Claude Code

把下面這行整行複製貼上到終端機，按 Enter：

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

會看到下載與安裝進度條，等到看到 ✓ Claude Code installed 之類的訊息表示完成。

3.3 設定 PATH（讓終端機找得到 claude 指令）

$ echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
$ source ~/.zshrc

這兩行的意思是：把 Claude Code 安裝的位置告訴終端機，以後打 claude 就能跑起來。

3.4 驗證安裝

$ claude --version
claude-code 2.x.x

看到版本號就成功了。如果沒看到，跳到下方 卡關排查。

# 1. Homebrew
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. 設定 Homebrew PATH
$ echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
$ eval "$(/opt/homebrew/bin/brew shellenv)"
# 3. Node.js
$ brew install node

4 · Windows 安裝

這是 2026 年 5 月 Anthropic 官方 docs 推薦的路徑：PowerShell 一行指令裝完。不用先裝 Node.js、不用先裝 Git、不用管理員權限。

4.1 開啟 PowerShell（不需要管理員權限）

按 Win 鍵，輸入「PowerShell」── 點「Windows PowerShell」或「Terminal」開啟。一般使用者權限就夠，不要按右鍵選「以系統管理員身分執行」（管理員權限反而會把 Claude 裝到錯的位置）。

提示符長這樣：PS C:\Users\YourName> ── 有 PS 前綴才是 PowerShell。如果只有 C:\Users\YourName> 沒 PS，你開到 CMD 了，請關掉重開 PowerShell。

4.2 一行指令裝完

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

會跑 1-3 分鐘下載與安裝。看到 ✓ Claude Code installed 表示完成。

常見錯誤：

• 看到 'irm' is not recognized as an internal or external command ── 你在 CMD 不是 PowerShell，請開 PowerShell 重試。
• 看到 無法載入檔案... 因為這個系統上已停用指令碼執行 ── 跑這行允許執行：Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser（輸入 Y），再重試 4.2。

4.3 關掉 PowerShell · 重新開一個

安裝完務必關掉這個視窗、重開一個新的 PowerShell ── 否則 PATH 變數還沒重新載入，下一步驗證會找不到 claude 指令。

4.4 驗證安裝

PS> claude --version
2.x.x
PS> claude doctor

claude doctor 會做更完整的健檢，看到綠色 ✓ 表示一切正常。

4.5 （可選）裝 Git for Windows

Claude Code 不用 Git 也能用。但如果你想讓 Claude 用 Bash 工具（而不是預設的 PowerShell 工具），裝 Git for Windows 會更順 ── 因為 Claude 在 macOS / Linux 預設用 Bash，文件 / Skills 範例都是 Bash 寫的。

到 git-scm.com/downloads/win 下載安裝，一路下一步即可。安裝後 Claude 會自動偵測。

5 · 首次啟動與登入

1. 啟動 Claude Code

   在終端機輸入 claude 並按 Enter。第一次會跳出歡迎畫面。

2. 選擇色彩主題

   有 6 種顏色可選，用方向鍵切換，按 Enter 確認。不喜歡之後可以改。

3. 選擇登入方式

   選預設的 Claude 訂閱 登入。瀏覽器會自動打開，登入你的 Claude 帳號，授權後跳轉回終端機。

4. 看到 「Build Something Great」 畫面

   恭喜！Claude Code 已經可以用了。接下來會問你信不信任這個工作區（Workspace Trust），按 Enter 確認。

5. 第一次測試

   直接輸入「你好，請介紹一下自己」並 Enter，AI 會回應。確認對話流暢後就可以正式開工。

6 · 加裝 Zeabur Skills（強烈推薦）

Skills 是「給 Claude 額外能力」的擴充包。Zeabur 官方 Skills 讓 Claude 直接會操作 Zeabur ── 建專案、部署、查 log、改環境變數，全部一句話搞定。

6.1 安裝

$ claude plugin marketplace add zeabur/zeabur-claude-plugin
$ claude plugin install zeabur@zeabur

6.2 之後保持更新

$ claude plugin marketplace update zeabur
$ claude plugin update zeabur@zeabur

7 · 卡關排查

8 · 下一步 · 接附件 B

Claude Code 裝好了，下一步是讓終端機更好用 ── 不閃爍、滑鼠能用、打 cc 一鍵啟動。請接著看 附件 B · 終端機設定。