STARTEK
附件 AWORKSHOP HANDOUT · COMET
HANDOUT A · 2026.05.15

Claude Code 安裝教學

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

目錄
  1. Claude Code 是什麼？
  2. 動手前確認 3 件事
  3. macOS 安裝
  4. Windows 安裝
  5. 首次啟動與登入
  6. 加裝 Zeabur Skills（推薦）
  7. 卡關排查
  8. 下一步 · 接附件 B

1 · Claude Code 是什麼？

Claude Code 是 Anthropic 官方的「會操作你電腦的 AI」── 它在你電腦的終端機裡跑，可以幫你寫程式、改檔案、跑指令、部署上線。和 ChatGPT 那種「對話框」不同，它真的會動手做事。

對繪新來說最直接的應用：建客服 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

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

補充

需要安裝 Homebrew + Node.js 嗎？

基本使用不用。但如果你之後要安裝其他開發工具（例如 Zeabur Skills、自己的專案），建議補裝：

# 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 安裝

Windows 走 PowerShell 路線。先決定一件事：用 Windows Terminal（Win 11 內建，新手推薦）或 Tabby（免費開源、視覺好看）。沒安裝過的話，到 Microsoft Store 搜「Windows Terminal」一鍵安裝。

4.1 開啟 PowerShell（以系統管理員身分）

按 Win + X，選「Windows PowerShell（系統管理員）」或「Terminal（系統管理員）」。

4.2 允許執行腳本

PS> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

會問你要不要套用，輸入 Y + Enter。

4.3 安裝 Node.js + Git for Windows（先決條件）

4.4 安裝 Claude Code

PS> npm install -g @anthropic-ai/claude-code

4.5 驗證

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

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
為什麼一定要裝

不裝 Zeabur Skills，Claude 需要你手動下 Zeabur 指令、貼 token、設環境變數。裝了之後，「幫我部署到 Zeabur」就是字面上的意思 ── AI 自己跑完所有步驟，5 分鐘給你網址。

7 · 卡關排查

症狀原因解法
command not found: claude PATH 沒設好 重跑 macOS 3.3 / Windows 重開 PowerShell
安裝中斷 網路或權限 確認 Wi-Fi、確認用管理員權限執行
登入後瀏覽器跳轉失敗 瀏覽器擋彈窗 關掉廣告擋擴充再試一次
Mac 跳出「無法驗證開發者」 macOS Gatekeeper 「系統設定 → 隱私權與安全性」按「仍要打開」
Windows 跳「執行原則」錯誤 沒跑 4.2 步驟 回去執行 Set-ExecutionPolicy
npm install 卡很久 npm 鏡像慢 換 taobao 鏡像：npm config set registry https://registry.npmmirror.com
最後一招

真的卡住，請舉手。

工作坊現場 30 秒就能解決的問題，回家自己 Google 搞半小時。今天就是讓你能跨過這道門檻的時間。

8 · 下一步 · 接附件 B

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