MIXXIN Vibe Coder 入門課
LESSON 02 · 午餐揪團頁主線

把工作現場搬到你的電腦

第 1 堂你在瀏覽器上傳檔案;今天把 repo 搬到你自己的電腦,裝好兩個工具——一個負責「說」(Claude Code,用白話請它改東西)、一個負責「看」(GitHub Desktop,看它改了哪、確認 OK 才送上線)。做完你就能在自己電腦上:用講的改功能 → 看它改了哪 → 一鍵送上線。

把環境搬到本機 GitHub Desktop × Claude Code 說 × 看 雙工具 產出:本機改一版並上線
完成定義 · Definition of Done
學員的電腦上有課程 repo 的本機副本,找到並搬好自己第 1 堂的檔案,完成兩次「說 → 看 → 送出」的小改動,並實際開過一個連結 issue 的 PR——親身體會「動自己的檔案」跟「動大家共用的檔案」在 issue/PR 用法上的差別。
給講師:這堂是「環境畢業典禮」——第一次把 repo 搬到自己電腦、真的用 git 送出(不再手動上傳),摩擦點最多。三個前置務必課前確認:①第 1 堂裝的 Claude Code 還能登入可用(需付費方案)②GitHub Desktop 已依課前信裝好並登入 ③每人都已受邀進課程 repo。自己務必先完整跑一遍。
01為什麼要搬到本機

第 1 堂用 GitHub 網頁上傳檔案,夠簡單——但有天花板:你沒辦法讓 AI 在你電腦上連續、對話式地改一整包檔案,也很難看清楚每次到底改了哪幾行。今天把 repo 拉到本機,就打開了這個能力。

🗣️兩個工具、兩個角色(延續上一堂的「說 vs 看」)

Claude Code=你「」的工具:用白話請它改東西,它動手。GitHub Desktop=你「」的工具:看它改了哪一行、確認沒問題,再一鍵送上線。你不用會寫程式,但要會看懂與把關——這就是危險雷達。

02確認 GitHub Desktop、Clone repo 到本機

GitHub Desktop 你應該已經照課前信裝好——它是一個圖形介面 App,把雲端的 repo 下載一份到你電腦,並幫你處理登入、上傳、下載。今天要做的只是確認裝好、登入,然後把課程 repo clone 下來。

  • 打開 GitHub Desktop,確認顯示已 Sign in to GitHub.com(沒登入就現在登入,不用產金鑰、不用密碼貼來貼去)
  • File → Clone repository → 選課程 repo → 選一個本機資料夾 → 按 Clone(這一步就是「把 repo 綁到本機」)
  • 完成後按 Show in Finder,看得到那個資料夾——這就是你電腦上的工作現場
給講師:GitHub Desktop 的安裝已經在課前信請學員完成——今天不重講安裝,只處理「忘記裝」「忘記登入」的個案,把時間留給後面的動手練習。它會順便裝好 git 與認證,所以等一下 Claude Code 要 push 時直接就能推、不用再設金鑰。
一人專注操作筆電、螢幕上是版本歷史畫面的氛圍照
圖 2.1把 repo clone 到本機——你的檔案、每一次改動的紀錄,從今天起都活在你自己的電腦裡
03把 Claude Code 接上你的本機 repo

Claude Code 你第 1 堂已經裝好了——它是能讀你整個資料夾、照你講的話改檔案的 AI 助手。今天唯一的新動作,是讓它對準你剛剛 clone 下來的那個資料夾工作。

  • 打開 Claude Code 桌面版 App → 用「開啟資料夾」指到剛剛 clone 的專案資料夾
  • 確認還登得進去(需付費方案;第一次可能要再用瀏覽器登入一下)
  • 隨口問它「這個資料夾裡有什麼?」——它答得出你的檔案,就代表接上了
給講師:不用再教安裝(第 1 堂已裝)。這段唯一目的是讓每個人的 Claude Code 對準本機 repo 資料夾、且確認還登得進去。最常見的兩個坑:登入過期、以及 Claude Code 開錯資料夾(看不到專案檔案)。
04存檔點心智模型

搬到本機後,你會真的開始存檔。玩過遊戲都知道:不會每走一步就存,而是做完一個段落存一次——存檔的意義是「這裡是一個我想得回的點」。

COMMIT
存檔點
做完一個有意義的小段落存一次。在 GitHub Desktop 左下角寫一句話、按 Commit。
PUSH
上傳雲端
按 Push,把本機的存檔送回 GitHub(也才會更新線上網址)。
BRANCH
平行時空
想試危險打法?開個副本去試,成功再帶回正式線(main)。
commit = 存檔點 加了卡片 換了顏色 現在 history=時光機,隨時跳回去 branch = 平行時空 main 在副本上做實驗,main 不受影響
圖 1.1Git 三個核心概念:commit 存檔點history 時光機branch 平行時空
05定位:把你的第 1 堂作品搬進新家

第 1 堂是用網頁上傳,檔名沒有固定規則——現在要在本機資料夾裡工作,第一件事是先找到「哪個檔案是我的」。

  • 打開 submissions/u/你的帳號.html(你的個人頁),點「開啟完整作品 →」——網址列顯示的檔名就是你的檔案
  • 在 clone 下來的資料夾裡新增 submissions/你的帳號/lesson-02/ 資料夾
  • 把剛剛找到的檔案複製進去,改名為 index.html
從今天起,這個資料夾就是你的專案家。下一堂會再複製一份到新的 lesson-XX/ 資料夾延續改——每堂課都是接著上一堂的存檔點繼續,不是從零重來。
06動手練習:兩個安全的小改動

接下來兩個改動都只動你自己的 index.html,不會跟任何人的東西衝突——先把「說 → 看 → 送出」的手感練熟,各自完成一次 commit → push。

①🗣️取用共用資料改自己的

用下面的 Prompt A 請 Claude Code 打開 submissions/lunch-locations.json(全班第 1 堂收集到的真實地點),挑一個補進你的揪團卡。看 GitHub Desktop 的 diff → 寫一句 commit 訊息 → push。

②🔗解決一個真的痛點:加「回作業索引」連結

逛過同學作業應該碰過:直接打開別人的頁面,沒辦法點回作業列表。用下面的 Prompt B 請它幫你的頁面也加一個「← 回作業索引」的小連結。看 diff → commit → push。

這兩次改動都不會跟別人「打架」,所以可以直接開分支、開 PR,不太需要先開 issue——s7 會告訴你為什麼有些情況不一樣。

對著 Claude Code 用自己的話講

A取用共用地點資料
請打開 submissions/lunch-locations.json,這是我們班第 1 堂收集到的真實店家清單。
挑一個地點,把它的名稱、地址(如果有)等資訊,補進我目前的揪團卡片裡,取代原本寫死的範例資料。
改完用一兩句話告訴我你補了哪一家、動了哪個檔案。
B加一個回作業索引的連結
我的這個檔案放在 submissions/我的帳號/lesson-02/index.html。
請幫我在頁面右上角加一個小小的「← 回作業索引」連結,連到 submissions/index.html
(注意相對路徑要從我這個檔案的位置往上算兩層)。
07交付進階:issue 跟 PR 差在哪

剛剛兩次改動只動自己的檔案。但現在要做一件不一樣的事:把一個新地點加進 submissions/lunch-locations.json——這個檔案全班都會動到

📋一句話分清楚

issue=留一句話紀錄「我打算加什麼」,尤其是要動大家共用的東西時——方便之後回頭追蹤是誰、為什麼加的。PR=我已經做完了,拿出來給大家看、等講師合併。動自己的檔案通常可以省略 issue 直接開 PR;動共用資源,留一個 issue 紀錄比較好追。

Issue 提出想法 / 報修單 分支 + 實作 用 AI 完成改動 PR 改了什麼 / 為什麼 Review 留言 → 合併 從今天起,每一份作業都是這個迴圈的一次練習
圖 4.1完整的協作迴圈:issue 提出 → 分支實作 → PR 交付 → review 合併
  • 找一個 lunch-locations.json 清單上還沒有的真實地點
  • 開一個 issue:「新增地點:[店名]」,一句話寫清楚要加什麼
  • 開分支 → 用 Claude Code 把這個地點加進 submissions/lunch-locations.json(格式跟現有的一樣)→ commit → push
  • push 後開 PR,描述裡連結剛剛的 issue(例如 Closes #12

對著 Claude Code 用自己的話講

C把新地點加進共用清單
請幫我在 submissions/lunch-locations.json 裡新增一筆地點:
[店名、地址等你知道的資訊]
格式要跟檔案裡現有的其他筆一致,加完幫我確認整份 JSON 還是合法的。
撞到同學選一樣的地點是正常的:不用自己處理重複或 conflict——這份清單全班共用,最後由講師課後統一看過再決定合併或請你晚一點再補。你的工作只要負責把 PR 開出來就好。課後互評:前往至少一位同學的 PR,留一句鼓勵 + 一句具體回饋。
·作業與檢核

作業:完成本堂兩個「自己檔案」的 commit + push,再加一個「新增地點到共用清單」的 issue + PR。PR 描述請 AI 幫你寫,說明你新增的地點是什麼、為什麼選它。課後到至少一位同學的 PR 留言。

講師 / 助教檢核重點

  • 個人資料夾 submissions/你的帳號/lesson-02/index.html 已建立且能開啟
  • 完成至少兩次「自己檔案」的 commit + push(補資料 + 回索引連結)
  • 1 張 issue(新增地點)+ 1 個連結該 issue 的 PR(改動 lunch-locations.json)
  • 學員能說出「動自己的檔案」跟「動共用檔案」在 issue/PR 用法上的差別
  • 課後每個 PR 收到至少一則同學留言