KNOW Vibe Camp 行前準備
設定進度 0 / 7
清交 Vibe Coding 資工 AI 體驗營

準備好你的開發環境

請在營隊報到前依序完成 7 項設定。完成測試後，將 Claude Code 回覆畫面截圖傳給 LINE 粉專 @831hkcbd 確認。

7 項設定 Windows / macOS 自動儲存進度
開始設定 Claude Code Git + SSH 環境就緒

指令方塊右上角可直接複製內容；貼到終端機後按 Enter 執行。

選擇 Windows 或 macOS 後，整份文件會同步顯示對應步驟。

為什麼要先做？

營隊現場會直接進入專案實作。事前完成帳號、終端機與版本控制設定，第一堂課檢查完成後即可開始開發。

若步驟出現錯誤，請保留完整錯誤訊息與畫面截圖，傳給 LINE 粉專 @831hkcbd。

任務 1申請 OpenRouter 帳號 + 拿 API key

  1. 前往 openrouter.ai 註冊帳號，可使用 Google 或 Email。
  2. 進入 Keys 頁面 → 按 Create Key 建立一組新的 API key（開頭是 sk-or-）。
  3. 金鑰只會顯示一次，馬上複製起來貼到自己的記事本（等一下任務三要用）。

API key 等同帳號密碼。請勿貼到公開頁面、上傳到 GitHub 或傳送到群組。

任務 2安裝 Claude Code CLI

按 開始 → 搜尋「PowerShell」→ 開啟 Windows PowerShell，貼上：

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

按 ⌘ + 空白鍵 → 搜尋「終端機 / Terminal」→ 開啟，貼上：

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

確認裝好了

關掉終端機視窗，重新開一個，然後貼上：

claude --version
若顯示版本號，例如 2.1.220 (Claude Code)，即代表安裝成功。

任務 3設定環境變數，接上 OpenRouter

設定 3 個環境變數，讓 Claude Code 連線到 OpenRouter 並使用指定模型。

開啟 PowerShell，一行一行貼、一行一行按 Enter：

setx ANTHROPIC_BASE_URL "https://openrouter.ai/api"
setx ANTHROPIC_AUTH_TOKEN "貼上你的sk-or金鑰"
setx ANTHROPIC_MODEL "openrouter/free"

第二行要把 貼上你的sk-or金鑰 整段換成任務一拿到的金鑰，引號要保留。

setx 只對之後新開的視窗生效。設定完請關掉 PowerShell 再重開。

開啟終端機，一行一行貼、一行一行按 Enter：

echo 'export ANTHROPIC_BASE_URL="https://openrouter.ai/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="貼上你的sk-or金鑰"' >> ~/.zshrc
echo 'export ANTHROPIC_MODEL="openrouter/free"' >> ~/.zshrc
第二行要把 貼上你的sk-or金鑰 整段換成任務一拿到的金鑰，引號要保留。

讓設定立刻生效：

source ~/.zshrc

確認接對了

打開 claude，輸入 /status，看 Base URL 是不是 https://openrouter.ai/api。

任務 4跑一句測試 prompt，截圖回傳

  1. 在終端機輸入： 
    claude
  2. 打一句話測試，例如： 
    請用繁體中文跟我說一句話，證明你有連上線
  3. 把它回覆你的畫面截圖，傳給 LINE 粉專 @831hkcbd，作為完成安裝的確認。

目前模型的用量上限為每分鐘 20 次、每天 50 次請求。完成連線測試後即可關閉。

對話內容可能由模型提供者用於訓練，請勿輸入個資、密碼或金鑰。

API 用量說明

額度是算「API 請求數」不是「你打了幾句話」。Claude Code 每讀一個檔、寫一個檔、跑一次指令都算一次，所以一句「幫我做一個計數器網頁」大概會用掉 3~6 次。

50 次 ≈ 8~15 個有意義的指令，而且營隊兩天都要靠它。所以：

  • 行前測試只需確認模型能正常回覆，完成後即可關閉。
  • 上課時想清楚再下指令。一次把需求講完整（要什麼、長怎樣、用什麼、放哪裡）最省；連續丟五次模糊指令最浪費。
  • 看到 429 或 rate limit 就是當天額度用完了，隔天才會更新，不要一直重試（重試也算次數），舉手告訴 TA。
OpenRouter 服務條款禁止以多重帳號規避用量限制（§7 Prohibited Conduct），違規帳號可能遭停權。

任務 5建立 GitHub 帳號

  1. 前往 github.com 註冊帳號。
  2. 用學校或常用 Email 驗證。
  3. 記住你的帳號名稱和密碼，第一堂課要用它 push 你的第一個 repo。
已經有 GitHub 帳號的同學，確認一下還記得帳密、能登入就好。

任務 6安裝 Git + 設定 SSH 金鑰

GitHub 已經不支援用密碼 push，所以要先設定好 SSH 金鑰，現場才能直接上傳程式碼。

6-1 安裝 Git

開啟 PowerShell，貼上：

winget install --id Git.Git -e

開啟終端機貼上，會跳出安裝視窗按「安裝」即可：

xcode-select --install

關掉終端機重開，確認裝好：

git --version

6-2 設定你的 Git 身分

把引號內換成你自己的資料（Email 請用註冊 GitHub 的那個）：

git config --global user.name "你的名字"
git config --global user.email "你的GitHub註冊Email"

6-3 產生 SSH 金鑰

把 Email 換成你的 GitHub Email，貼上後連按三次 Enter（不用設密碼）：

ssh-keygen -t ed25519 -C "你的GitHub註冊Email"

6-4 複製公鑰

Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub | Set-Clipboard
pbcopy < ~/.ssh/id_ed25519.pub

執行完金鑰就已經在剪貼簿裡了（畫面不會有反應是正常的）。

6-5 貼到 GitHub

  1. 到 github.com → 右上角頭像 → Settings
  2. 左邊選 SSH and GPG keys → New SSH key
  3. Title 隨便填（例如 我的筆電），Key 欄位按 Ctrl+V / ⌘+V 貼上
  4. 按 Add SSH key

6-6 測試連線

ssh -T git@github.com

第一次會問 Are you sure you want to continue connecting? → 輸入 yes 按 Enter。

看到 Hi 你的帳號! You've successfully authenticated... 即代表連線成功。

設定好 SSH 之後，repo 網址要用 SSH 格式（git@github.com: 開頭），不是 https://：

git remote add origin git@github.com:你的帳號/my-first-project.git

替代方式：安裝 GitHub CLI 後執行 gh auth login，選 GitHub.com → HTTPS → 使用瀏覽器登入，之後即可透過 https:// repo push。需要時可請 TA 協助。

任務 7安裝 VS Code

上課會用它來看檔案、改程式碼。

開啟 PowerShell，貼上：

winget install --id Microsoft.VisualStudioCode -e

開啟終端機，若有 Homebrew：

brew install --cask visual-studio-code

沒有 Homebrew 的同學，直接到 code.visualstudio.com 按 Download 下載安裝即可。

裝好後打開 VS Code，確認能開啟就好（不用做任何設定）。

完成確認表

點一下就能打勾，進度會自動記住（換頁、關掉再開都在）。

  • 1. OpenRouter 帳號 + API key（sk-or- 開頭）
  • 2. 安裝 Claude Code CLI（claude --version 有版本號）
  • 3. 設定 3 個環境變數（/status 顯示 openrouter）
  • 4. 跑測試 prompt + 截圖回傳 LINE 粉專 @831hkcbd
  • 5. GitHub 帳號可登入
  • 6. Git 已安裝 + SSH 金鑰測試成功（ssh -T git@github.com）
  • 7. VS Code 已安裝並能開啟
全部完成。你的開發環境已準備就緒。

疑難排解

症狀可能原因解法
claude: command not found沒重開終端機關掉視窗重開；還是不行就重跑任務二
/status 顯示 anthropic 官方環境變數沒生效重開終端機；Windows 確認 setx 三行都跑過
出現 401 / Unauthorized金鑰貼錯或多了空白重跑任務三第二行，確認 sk-or- 完整無空格
出現 429 / rate limitAPI 額度或速率已達限制隔天再試，或現場找 TA
出現 404 model not found模型名稱打錯確認是 openrouter/free（斜線、拼字都要對）
回英文 / 亂碼沒指定語言prompt 加「請用繁體中文」
git@github.com: Permission denied公鑰沒貼到 GitHub重做 6-4 ~ 6-5

需要協助？

  • 客服 LINE 粉專：@831hkcbd
  • 有任何錯誤訊息，請直接截圖傳給粉專，並附上你的作業系統（Windows / Mac）。
LINE 粉專有問題請直接詢問
設定進度 0 / 7