學員專區・課前準備

上課前 20 分鐘，省掉課堂上的 40 分鐘。

第一堂最常卡的不是 AI，是「裝不起來」。在家把這幾件事做好，上課就直接開始做出東西。

  • 一行指令裝好六個程式
  • 三分鐘自我檢查
  • 卡住先看常見問題
看要裝什麼我卡住了
Finn 站在學生身後指著螢幕講解，隔壁學生托著下巴看自己的畫面醒吾科大 · 2026/10

要裝的東西

七個要裝，除了 Claude Code 都免費

在家先裝好，上課只做確認；教室網路整班同時下載會很慢。六個程式一行指令就能全部裝好，GitHub 是帳號，另外去註冊。

懶人包

一行指令，六個程式一次裝好

按「開始」→ 打 PowerShell → 打開。不是「命令提示字元」（cmd），那個跑不了。一般權限打開就好；裝 Git、Node.js 時會跳出「要允許這個 App 變更您的裝置嗎？」，按「是」。學校電腦如果要管理員密碼，就找助教。

貼到 PowerShell 的那一行

"SST.OpenCodeDesktop","SST.opencode","Anthropic.ClaudeCode","StablyAI.Orca","Obsidian.Obsidian","Git.Git","GitHub.cli","OpenJS.NodeJS.LTS" | ForEach-Object { winget install --id $_ -e --accept-source-agreements --accept-package-agreements }
想要中文說明、自動檢查版本？改貼這行

這行會下載我們寫好的安裝腳本來跑：裝的東西一樣，但每一步有中文說明，最後列出哪個沒裝成功。 先看腳本內容

貼到 PowerShell

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor 3072; irm https://wport.me/learn/setup-win.ps1 | iex

這一行會裝好

  • OpenCode（AI Agent）
  • Claude Code（要付費帳號）
  • Orca
  • Obsidian
  • Git 與 GitHub CLI（gh）
  • Node.js（選 LTS）

  1. 01OpenCode（AI Agent）

    會動手的 AI Agent：你交代，它開檔、改檔、跑指令、打開給你看。桌面版把檔案、對話、終端機放在同一個視窗。免費模型就能上完整門課。

    怎麼裝
    桌面版和終端機版都要裝：Orca 是用終端機的 opencode 指令叫它。一鍵安裝會兩個一起裝好；自己裝的話，下面兩行都要跑。第一次打開要選模型，先選免費的。
    怎麼確認
    打得開，而且在對話框打「你好」它會回你。
    只裝這一個：一行指令

    Windows（PowerShell）

    winget install --id SST.OpenCodeDesktop -e; winget install --id SST.opencode -e

    Mac（終端機，要先有 Homebrew）

    brew install --cask opencode-desktop; brew install opencode
    下載 OpenCode

  2. 02Claude Code（要付費帳號）

    Anthropic 的 AI Agent，跟 OpenCode 做同一件事，但快很多：我們實測同一個任務：Claude Code 15 秒做完，OpenCode 配免費模型要 3 分鐘。要 Claude Pro 以上的付費帳號才能用；沒有訂閱就用 OpenCode，一樣上得完。

    怎麼裝
    一行指令裝好（下面的一鍵安裝已經包含）。裝完在終端機打 claude，照畫面登入 Claude 帳號。
    怎麼確認
    終端機打 claude --version 會出現版本號。
    只裝這一個：一行指令

    Windows（PowerShell）

    winget install --id Anthropic.ClaudeCode -e

    Mac（終端機，要先有 Homebrew）

    brew install --cask claude-code
    Claude Code 官網

  3. 03Orca

    指揮 AI 的駕駛艙。OpenCode、終端機、瀏覽器、GitHub 放進同一個視窗，一個任務開一個分頁；要同時叫兩個 AI 各做一件事也行。免費、開源。

    怎麼裝
    下載對應 Windows 或 Mac 的安裝檔，一路按下一步。第一次打開會要你選 agent，選 OpenCode；資料夾等上課再加。
    怎麼確認
    打得開，看得到左邊側欄的 Add Repo 按鈕。
    只裝這一個：一行指令

    Windows（PowerShell）

    winget install --id StablyAI.Orca -e

    Mac（終端機，要先有 Homebrew）

    brew install --cask stablyai/orca/orca
    下載 Orca

  4. 04Obsidian

    你的資料庫。「我的資料」都寫在這，AI 照這份做，不亂編。

    怎麼裝
    安裝後建立一個新的保管庫（vault），名字取 my-portfolio，放在「文件」資料夾。路徑不要有中文或空白。
    怎麼確認
    左邊看得到 my-portfolio，能新增一則筆記。
    只裝這一個：一行指令

    Windows（PowerShell）

    winget install --id Obsidian.Obsidian -e

    Mac（終端機，要先有 Homebrew）

    brew install --cask obsidian
    下載 Obsidian

  5. 05Git 與 GitHub CLI（gh）

    存檔點。每改一版存一個點，改壞了可以退回去；把作品存到 GitHub 也要靠它。gh 是 GitHub 的指令工具，上課用 gh auth login 登入 GitHub。

    怎麼裝
    兩個都用預設值一路按下一步就好，一鍵安裝會一起裝。Mac 通常已經內建 git，但 gh 要另外裝。
    怎麼確認
    終端機打 git --version 和 gh --version 都會出現版本號。
    只裝這一個：一行指令

    Windows（PowerShell）

    winget install --id Git.Git -e; winget install --id GitHub.cli -e

    Mac（終端機，要先有 Homebrew）

    brew install git gh
    下載 Git

  6. 06Node.js（選 LTS）

    發動機。第 2 週用 WPORT CLI 找職缺、建履歷，和 Google 的 CLI 做簡報，都靠它跑。

    怎麼裝
    官網選 LTS 版本下載，一路按下一步；一鍵安裝在 Windows 和 Mac 裝的也都是 LTS。裝完把已經開著的終端機和 OpenCode 關掉重開，它們才看得到。
    怎麼確認
    終端機打 node --version 會出現 v22 或更新的版本號。
    只裝這一個：一行指令

    Windows（PowerShell）

    winget install --id OpenJS.NodeJS.LTS -e

    Mac（終端機，要先有 Homebrew）

    brew install node@26; brew link --force --overwrite node@26
    下載 Node.js

  7. 07GitHub 帳號

    雲端倉庫。電腦教室會還原，作品存上 GitHub 換哪台都拿得回來；學生方案的 Copilot 也從這裡申請。

    怎麼裝
    用個人信箱註冊（學校信箱畢業後會失效，這個帳號之後要給面試官看），收信點驗證。要申請學生方案，再到 Settings → Emails 把學校信箱加進去。帳號名字用英文，之後會出現在網址裡，取一個能給面試官看的。
    怎麼確認
    登入後右上角有你的頭像，信箱旁邊沒有「未驗證」。
    註冊 GitHub

裝好了嗎

三分鐘自我檢查

打開 OpenCode，開啟 my-portfolio 這個資料夾，把這段貼進去。它回你話、而且 git、gh、node 都有版本號，就代表環境好了。

複製 → 貼到 OpenCode → 送出

你好，請告訴我：
1. 你是哪一個模型？你現在看得到哪個資料夾？
2. 幫我檢查這台電腦有沒有 git、gh 和 node，各是什麼版本？沒有的話告訴我。

成功的話，它會回你像這樣

我是 GPT-5 mini（免費模型）。

我看得到的資料夾：C:\Users\you\Documents\my-portfolio

git version 2.47.0

gh version 2.80.0

node v26.13.0

三個都裝好了，可以開始上課。

模型名稱不一樣沒關係；有資料夾路徑、git、gh、node 都有版本號就是好了。少了哪一個，到下面的常見問題找。

Q&A

常見問題

前幾班真的發生過的狀況。點開看為什麼、怎麼辦。

安裝時

A

Windows 對沒簽名或少見的安裝檔會先擋一下，不代表有毒。

  1. 1先確認這個檔案是從上面工具卡的官方連結下載的。只有這種才放行；來路不明的檔案直接刪掉。
  2. 2點「其他資訊」。
  3. 3出現「仍要執行」再點它。
A

電腦教室的電腦被鎖住，學生帳號不能裝軟體。

  1. 1舉手找助教，不要自己試密碼。
  2. 2等的時候先跟旁邊同學一起看同一台。
  3. 3Git 和 Node.js 都有「可攜版」不用管理員權限，助教會帶。
A

剛裝好的程式，已經開著的 OpenCode 或終端機看不到，要重開才會讀到新的路徑。

  1. 1把 OpenCode 關掉重開，再問一次。
  2. 2還不行：在終端機打 git --version 看是裝好了沒，沒有就重裝。
  3. 3再不行就舉手。
A

macOS 預設只放行 App Store 和有簽名的程式。

  1. 1先確認這個程式是從上面工具卡的官方連結下載的。只有這種才放行；來路不明的直接丟垃圾桶。
  2. 2系統設定 → 隱私權與安全性，往下捲找到那個程式，按「仍要打開」。
  3. 3或者在程式上按右鍵 → 打開。
A

整班同時下載，教室網路會塞。

  1. 1最好在家先裝好，上課只做確認。
  2. 2現場可以先用手機熱點下載安裝檔。
  3. 3等下載的時候先做第 1 步（聊天 AI 做一頁網頁），不需要任何安裝。
A

有些防毒對終端機工具特別敏感。

  1. 1不要關防毒、不要改系統安全設定。
  2. 2找助教，或改在自己的電腦上先裝好。
A

學校信箱常把它丟進垃圾郵件，或要等幾分鐘。

  1. 1看垃圾郵件和「其他」分類。
  2. 2GitHub 設定 → Emails → Resend verification email。
  3. 3等 5 分鐘還沒有，先用個人信箱註冊，之後再把學校信箱加進去申請學生方案。

上課中

A

通常是沒選模型、模型額度用完，或網路斷了。

  1. 1看模型清單有沒有選到免費模型；換另一個免費模型試試。
  2. 2關掉重開。
  3. 3同一個問題貼到 ChatGPT 或 Gemini 也能先往下做。
A

免費方案每小時或每天有上限。

  1. 1換另一個免費模型。
  2. 2申請 Copilot 學生方案，通過後接進 OpenCode。
  3. 3一次講清楚要改什麼，少來回幾次就省額度。
A

電腦教室的電腦會還原，而且不一定坐同一台。

  1. 1下課前一定 commit＋push 到 GitHub。
  2. 2下週用 git clone 拿回來，Obsidian 和 OpenCode 都開同一個資料夾。
A

資料夾名稱有中文或空白，有些工具會讀錯。

  1. 1保管庫和專案資料夾用英文、不要有空白：my-portfolio。
  2. 2放在「文件」（Documents）底下，不要放桌面或下載。
A

這台電腦還沒登入 GitHub。推上去要先證明你是倉庫的主人，課堂用 gh auth login 登入。

  1. 1終端機打 gh auth login，依序選 GitHub.com、HTTPS、用瀏覽器登入（Login with a web browser）。
  2. 2瀏覽器打開後輸入畫面上的 8 碼、按 Authorize；終端機出現 Logged in 就好了，再 push 一次。
  3. 3公用電腦下課前要清掉這個登入（見下方「下課前清乾淨」）。
A

建倉庫時沒選 Private。「我的資料」在裡面，全世界都看得到。

  1. 1倉庫 Settings → 最下面 Danger Zone → Change visibility → Private。
  2. 2之後上線只公開 site 資料夾（Vercel 的 Root Directory 選 site）。
A

85 分想衝 90 分，一改變 75 分。這就是為什麼改之前要先 commit。

  1. 1跟 AI 說「幫我回到上一個 commit」。
  2. 2養成習慣：每次滿意就 commit 一下。
A

瀏覽器把舊檔案存在快取裡。

  1. 1Windows 按 Ctrl＋F5，Mac 按 Cmd＋Shift＋R 強制重新整理。
  2. 2Vercel 上線的網站：確認有 push，到 Vercel 看最新一次部署是不是綠勾。
A

最常見是 Root Directory 沒選 site，Vercel 找不到 index.html。

  1. 1Vercel 專案 Settings → Root Directory → Edit → 選 site → 重新部署。
  2. 2確認網頁檔名是 index.html（全小寫）。
A

Git 會記住每一版，只刪檔案沒有用，歷史裡還在。

  1. 1立刻告訴助教或老師。
  2. 2到發鑰匙的地方（Google Cloud、WPORT）把那把鑰匙刪掉重發，這才是真的止血。
  3. 3請 AI 用 git rm --cached 把檔案從 git 移除，再把檔名加進 .gitignore。只加 .gitignore 沒用，已經 commit 過的檔案還是會被追蹤。

都不是？貼這段求救

貼到 ChatGPT 或 Gemini，附上截圖。這段已經寫好「一次只給一步」和「不要叫我關防毒」，不會被帶去做危險的事。

複製 → 貼到 ChatGPT 或 Gemini → 附截圖

我在學校電腦教室的 Windows 電腦上安裝軟體卡住了。
軟體：（OpenCode／Claude Code／Orca／Obsidian／Git／GitHub CLI／Node.js，填一個）
我做到哪一步：（例如：按兩下安裝檔之後）
畫面上的字：（照抄，或直接貼截圖）
這台電腦我可能沒有系統管理員權限。
請一次只給我一步，等我回報結果再給下一步。
不要叫我關防毒、改登錄檔或改系統安全設定；如果一定要管理員權限，直接跟我說，我去找助教。

公用電腦

下課前，清乾淨再走

電腦教室的電腦下一個坐的人不是你。登入資料和鑰匙留在上面，等於把帳號借給陌生人。

  1. 1全部 commit＋push，到 GitHub 重新整理看到檔案。
  2. 2瀏覽器登出 GitHub、Vercel、WPORT、Google。
  3. 3叫 AI 清掉這台電腦裡 GitHub 的登入：gh 和 Windows 認證管理員各存一份（複製下面那段）。
  4. 4第 2 週有做 Google 的話：刪 client_secret.json、gws auth logout、刪 .config/gws。
  5. 5回家後到 Google 帳號 → 安全性 → 第三方連結，移除 my-ai-helper。

清掉登入資料 → 複製 → 貼到 OpenCode

這是公用電腦，幫我清掉我的登入資料：
1. 執行 gh auth logout，登出 GitHub CLI（gh 的登入是另外存的）。
2. 刪掉 Windows 認證管理員裡 GitHub 的登入：cmdkey /delete:git:https://github.com
3. 確認這個倉庫的 git config 沒有寫進 --global。
4. 告訴我還有哪些地方要我自己手動登出（瀏覽器的 GitHub、OpenCode、Claude Code 的帳號）。

要連程式一起移除？

電腦是借來的要還人，或想從頭重裝一次時用。只移除這堂課裝的程式；你的 my-portfolio 資料夾和 GitHub 上的作品不會動。學校電腦教室通常會自己還原，不用跑。跳出要管理員同意就按「是」，要密碼就找助教。

Windows：貼到 PowerShell

"SST.OpenCodeDesktop","SST.opencode","Anthropic.ClaudeCode","StablyAI.Orca","Obsidian.Obsidian","Git.Git","GitHub.cli","OpenJS.NodeJS.LTS" | ForEach-Object { winget uninstall --id $_ -e }

Mac：貼到終端機

for c in opencode-desktop claude-code stablyai/orca/orca obsidian; do brew uninstall --cask "$c"; done; for f in opencode git gh node@26; do brew uninstall "$f"; done

電腦準備好了，腦袋也先熱一下

上課會聽到一堆新名詞。先翻一遍「名詞卡」，課堂上就能把力氣放在做東西。