零基礎AI輔助程式設計

九成是沒有重開終端機。電腦只有在終端機「打開的那一刻」才會讀取 PATH（找程式的路徑清單），所以安裝軟體或改 PATH 後，要把終端機整個關掉再開——包含 Antigravity 裡的終端機（最保險是把 Antigravity 整個關掉重開）。還是不行就重新開機。

重開後仍然不行，代表該軟體沒裝好或沒加進 PATH，請看下面對應步驟的問題（例如 Python 看「1」、Claude 看「4」）。

看提示字元開頭：PowerShell 會是 PS C:\Users\你的名字>，有「PS」；命令提示字元則是 C:\Users\你的名字>，沒有「PS」。本課程的 Windows 指令都是給 PowerShell 用的，在 CMD 貼 irm ... | iex 會出現「'irm' 不是內部或外部命令」。請按 Win 鍵搜尋「PowerShell」重新開；Antigravity 的終端機可以按右上角「＋」旁的小箭頭選 PowerShell。

Mac 的「終端機」預設是 zsh，提示字元長得像 student@MacBook ~ %。本課程 Mac 指令都是給它用的，不需要切換。

• PowerShell 與 Antigravity 終端機可用 Ctrl+V 或按滑鼠右鍵貼上。
• Mac 終端機用 ⌘+V 貼上。
• 貼上後要按 Enter 才會執行；多行指令有時最後一行要再按一次 Enter。
• 不要連「PowerShell」「Terminal」這種標籤字一起複製——請用每個指令框右上角的「複製」按鈕。
• 從聊天軟體或 Word 複製的指令，引號可能被換成彎引號 “ ”，會導致錯誤；改從本頁複製。

可能是程式正在執行（例如網站伺服器、安裝程式）。安裝中請耐心等到出現新的提示字元；如果是自己啟動的網站要停止，按 Ctrl+C。

Windows 小陷阱：在 PowerShell 視窗裡用滑鼠點一下可能會進入「選取模式」讓程式暫停，按 Esc 或 Enter 就會繼續。

安裝 Python／Node.js／Git 需要系統管理員權限。請資訊組先幫忙裝好，或改用學生自己的筆電。Claude Code 原生安裝器裝在使用者資料夾，通常不需要管理員權限。

很多電腦教室裝了還原卡／還原軟體，重開機就會回到原始狀態。請資訊組在上課前把軟體裝進「保護範圍」，或每次上課只在同一次開機中完成；最推薦使用自己的筆電，專案也請隨時推上 GitHub（步驟 8）備份。

學校網路常有防火牆或 Proxy，會擋下 claude.ai、github.com 等網站或憑證驗證，出現 SSL、TLS、certificate、timed out 之類字樣。先試著用手機熱點重做一次：熱點能成功就是學校網路的限制，請資訊組協助開放。

若你的使用者資料夾是 C:\Users\王小明 或 C:\Users\Wang Xiao，部分工具處理中文或空格會出問題。專案資料夾可以改放在沒有中文、沒有空格的地方，例如 C:\code\my-first-app。

專案資料夾請放在像 ~/Documents/my-first-app 這種全英文、無空格的路徑；不要放在名稱含中文或空格的資料夾底下。

請確認檔案是從本頁連結的官方網站下載（python.org、nodejs.org、git-scm.com、claude.ai、antigravity.google）。官方檔案被誤判時，可以在防毒軟體選擇「允許」；不確定時先問老師，不要為了安裝而整個關掉防毒。

錯誤訊息通常在最後幾行，紅字或含有 Error、failed、not found、denied 的那幾行最重要。把整段（不要只截一行）複製下來貼給 Claude Code，並說「我在做第 X 步，跑了什麼指令，出現這個錯誤，請用簡單的話解釋並告訴我怎麼修」。

先看垃圾郵件／促銷內容資料夾；等 1–2 分鐘再按「重新寄送」。學校信箱常會擋外部來信，建議改用個人 Gmail 註冊。也請確認信箱沒有打錯字。

不行。Claude Code 需要 Claude Pro 或 Max 付費方案（或 Anthropic Console 的 API 額度）。上課前請先在 claude.ai 完成訂閱，登入時才不會卡住。

按 Win 鍵搜尋「關於您的電腦」（或「設定 → 系統 → 關於」），看「系統類型」是否寫「64 位元作業系統」。32 位元的 Windows 無法使用 Claude Code。同一頁也看得到 Windows 版本。

點左上角 →「關於這台 Mac」：「晶片」寫 Apple M1／M2／M3… 就是 Apple Silicon；寫「處理器 Intel…」就是 Intel。同一頁也看得到 macOS 版本（需要 13 Ventura 以上）。

學校配發的 Google 帳號可能被管理員限制使用部分服務或第三方應用程式。遇到無法登入或權限不足，改用個人 Gmail 帳號最省事。

至少要留 5 GB。先清空資源回收筒、「下載」資料夾裡的舊安裝檔垃圾桶、「下載項目」裡的舊 .dmg／.pkg，再重新安裝。

電腦裡可能本來就有別的版本，PATH 先找到它。最簡單是到「設定 → 應用程式」解除安裝不需要的舊 Python，再重開終端機；或用 py -3.11 指定版本。

Mac 可能有 Homebrew 或 Xcode 附的 Python。確認你裝的版本：輸入 python3.11 --version。若想讓 python3 指向 3.11，可以雙擊「應用程式 → Python 3.11」資料夾裡的 Update Shell Profile.command，再重開終端機。

版本略有不同其實大多能跑，但部署時 Zeabur 會用 ZBPACK_PYTHON_VERSION 指定的版本，本機與線上一致最不容易出怪問題。

改用「讓 Python 自己呼叫 pip」的寫法，最不會出錯：

python -m pip install -r requirements.txt

python3 -m pip install -r requirements.txt

虛擬環境是 Claude 可能會幫你建立的「專案專用套件箱」，不是必要的。

在 PowerShell 執行 .venv\Scripts\Activate.ps1 出現「因為這個系統上已停用指令碼執行」：照步驟 3 的方法執行一次 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 就能解決。

Mac 啟用指令是 source .venv/bin/activate。

啟用成功後，提示字元前面會出現 (.venv)。記得 .venv 要寫進 .gitignore，不要推上 GitHub。

按 Ctrl+Shift+P⌘+⇧+P 打開命令選擇區，輸入 Configure Display Language → 選 中文(繁體) zh-tw → 重新啟動。

• Antigravity 的延伸模組市集和 VS Code 不完全相同，請用英文搜尋 Chinese Traditional，認明發行者 MS-CEINTL。
• 搜尋結果一片空白：多半是網路被擋，換網路（例如手機熱點）再試。
• 不小心裝成「簡體」（Chinese (Simplified)）：在延伸模組清單把它解除安裝，再裝繁體版。

• 確認瀏覽器跳出的登入頁有完成，並按允許；完成後切回 Antigravity。
• 學校或組織帳號可能被限制，改用個人 Gmail。
• 瀏覽器沒自動跳出：檢查是否被彈出視窗攔截，或換預設瀏覽器再試。

選單「終端機」→「新增終端」，或按 Ctrl+`⌃+`（Esc 下面那顆鍵）。選單列是英文時，對應的是「Terminal → New Terminal」。

Antigravity 內建的是 Google 的 AI 代理；本課程用的是在終端機裡執行的 Claude Code。兩個都是 AI 助理，但為了跟著課程走，請在下方終端機輸入 claude 來對話，避免兩個 AI 同時改同一份檔案。

先關掉並重開終端機（Antigravity 也要重開）。還是不行，重新執行 Node.js 安裝檔（確認安裝過程中 “Add to PATH” 沒有被取消），裝完再重開終端機。

沒關係，版本號會隨時間更新。只要是官網標示 LTS 的版本、能顯示版本號就算成功。若顯示很舊的版本（例如 v16、v18），代表電腦裡有舊版，請到 nodejs.org 重新安裝 LTS 版覆蓋。

先重開終端機（Antigravity 也要重開）。還是不行就重新執行 Git for Windows 安裝檔，選項全部用預設值（預設就會把 Git 加進 PATH）。

還沒裝好命令列開發者工具，執行 xcode-select --install 並等安裝完成（約 5–10 分鐘），再重開終端機。

還沒設定名字與 Email。執行步驟 3+ 的這兩行（換成你自己的），之後再 commit 一次：

git config --global user.name "你的英文名字"
git config --global user.email "你的GitHub信箱@example.com"

直接再執行一次同樣的 git config --global ... 指令就會覆蓋。想確認目前設定，輸入：

git config --global --list

名字中間有空格時一定要加英文雙引號，例如 "Wang Xiao Ming"。

那是 Git 請你寫合併說明時開啟的 Vim 編輯器（例如執行 git pull、git merge 時）。直接用預設說明離開：按 Esc，再輸入 :wq 按 Enter（存檔並離開）。以後交給 Claude 做 Git 操作就比較不會遇到。

原生安裝器把 claude 放在 %USERPROFILE%\.local\bin~/.local/bin，這個資料夾要在 PATH 裡。

1. 確認有執行步驟 4 的「② 設定 PATH」那段指令（只要執行一次安裝結束時若有提示才需要）。
2. 關掉並重開終端機（Antigravity 要整個重開）。
3. 輸入 claude --version 確認。

想檢查 PATH 裡有沒有這個資料夾，可以執行下面指令；沒有任何輸出就代表還沒加進去：

$env:PATH -split ';' | Select-String '\.local\\bin'

官方說明：Troubleshoot installation and login。

多半是網路（學校防火牆、Proxy）擋住下載。先換手機熱點再試一次。

Windows 也可以先開啟 TLS 1.2 再安裝（官方文件提供的寫法）：

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

Mac 請確認 macOS 有更新到最新（系統憑證會跟著更新）。

claude doctor 是健康檢查，會列出問題和建議。常見的是以前用 npm 裝過舊版，造成兩個 claude 打架。如果你確定以前用 npm 裝過，可以移除 npm 版，只留原生版：

npm uninstall -g @anthropic-ai/claude-code

看不懂警告就把整段輸出截圖或複製，請老師看。

Antigravity 是在你設定 PATH 之前打開的，還記得舊的 PATH。把 Antigravity 整個關掉（不是只關終端機面板）再重開。

在登入畫面按鍵盤 c，會把登入網址複製到剪貼簿，再自己貼到瀏覽器網址列打開，按「授權」後回到終端機。網址太長換行、點不到時也用這招。

Claude Code 需要 Claude Pro 或 Max 方案（免費方案不能用），或改選「Anthropic Console account」用 API 額度付費。請到 claude.ai/settings 確認訂閱有效、而且瀏覽器登入的是同一個帳號。在 Claude Code 裡輸入 /login 可以重新登入。

登入代碼過期或複製不完整。按 Enter 重試，瀏覽器開啟後盡快完成授權；瀏覽器沒開就按 c 複製完整網址。

官方建議「乾淨重登」：

1. 在 Claude Code 裡輸入 /logout 登出。
2. 輸入 /exit 離開。
3. 重新輸入 claude，選「Claude account with subscription」重新登入。

也要確認瀏覽器目前登入的 claude.ai 帳號就是有付費的那個。

官方說明：這通常是電腦裡設定了舊的 ANTHROPIC_API_KEY 環境變數，蓋過了你的訂閱登入。請把這個環境變數移除後重開終端機（不會的話把訊息貼給老師），再用 /login 登入。

選 No 會直接離開，重新輸入 claude 再選 Yes, proceed 即可。Claude 只能看到「啟動時所在資料夾」裡的檔案，請先確認終端機路徑是你的專案（例如提示字元出現 my-first-app）。不在的話先 /exit，再用 Antigravity「檔案 → 開啟資料夾」打開正確資料夾，從它的終端機啟動 claude。

在 Antigravity 終端機裡 Shift+Enter 可能無效。改用 \ 再按 Enter，或按 Ctrl+J，這兩個在所有終端機都能換行。

貼圖片的快捷鍵是 Alt+V（不是 Ctrl+V）Ctrl+V（不是 ⌘+V），成功會出現 [Image #1]。也可以用步驟 6 的 /img 選擇圖片檔。

這是「權限模式」，按 Shift+Tab 可以切換，左下角會顯示目前模式：Manual（每步都問）→ acceptEdits（自動接受改檔）→ plan（只規劃）→ auto（新版預設，Claude 自行判斷安全的操作）。初學者想看清楚每一步就切到 Manual；想少按幾次就用 auto 或 acceptEdits。

• 還在執行中：按 Esc 打斷，再告訴它正確方向。
• 已經改完：輸入 /rewind（或輸入框空的時候按兩次 Esc），選擇要回到的時間點。
• 平常養成步驟 8 的「每完成一段功能就 commit」，改壞了也能用 Git 退回。

對話空間快滿了。輸入 /context 看用量，接著用 /compact 保留重要的討論 整理成摘要；換做另一件事就用 /clear 開新對話。重要的決定寫進 系統規劃.md 或用 /init 建立的 CLAUDE.md，新對話也不會忘。

Pro／Max 方案有一段時間內的使用量限制。輸入 /usage 可以看用量與重置時間。省用量的方法：一次把需求講清楚、換主題就 /clear、不要反覆要它重做整個專案。

對話會保存。回到同一個專案資料夾，輸入 claude -c 繼續上一次，或啟動後用 /resume 挑選之前的對話。

先按 Esc 打斷；沒反應就按 Ctrl+C。還是不行就關掉終端機重開，再用 claude -c 接回對話。也可能是網路斷線，檢查一下 Wi-Fi。

這是 Anthropic 伺服器暫時忙碌或出狀況，不是你弄壞的。等幾分鐘再重送一次訊息即可。

部分終端機對中文輸入法支援不完美。可以先在 Antigravity 的編輯器或記事本打好整段文字，再複製貼到 Claude Code 的輸入框。

原生安裝版會自動在背景更新。想手動更新，在終端機輸入 claude update；想全面檢查，在 Claude Code 裡輸入 /doctor（claude 打不開時改在終端機輸入 claude doctor）。

• 確認是在 Claude Code 的輸入框（有 > 的地方）輸入，而不是一般終端機。
• Claude Code 版本太舊：先 /exit，在終端機執行 claude update 再重新進入。

新增 marketplace 需要從 GitHub 下載，請確認：① 網路能連上 github.com；② 步驟 3+ 的 Git 有裝好（終端機輸入 git --version 有版本號）；③ 網址完整貼上 https://github.com/Yeachan-Heo/oh-my-claudecode，前後沒有多餘空格。

要先成功執行第一行 /plugin marketplace add ...，再執行 /plugin install oh-my-claudecode，順序不能顛倒。也可以輸入 /plugin 用選單瀏覽已加入的 marketplace 與外掛。

裝完外掛後一定要重新啟動 Claude Code 才會載入：先 /exit，再輸入 claude。也可以只打 /omc 看看自動補完清單有沒有出現。

OMC 官方 README 的建議：在 Claude Code 裡執行診斷，它會清掉舊的外掛快取；問題還在就重跑一次設定：

/oh-my-claudecode:omc-doctor

/oh-my-claudecode:omc-setup

OMC 會同時派出多個代理一起工作，所以比一般對話更耗用量。小修改直接跟 Claude 說就好，大功能再用 /autopilot 之類的多代理模式；隨時用 /usage 查看。

• claude-img 要在一般終端機安裝（不是在 Claude Code 輸入框），請確認右上角選對作業系統的指令。
• 裝完要 /exit 再重新輸入 claude，/img 才會出現。
• 安裝指令出現網路錯誤：換網路再試。

視窗可能開在 Antigravity 後面，看看工作列 Dock 或按 ⌘+Tab 有沒有新視窗。支援的圖片格式是 PNG、JPG、GIF、WebP、BMP、TIFF。真的不行也能直接用 Alt+VCtrl+V 貼上截圖。

依 claude-img 官方 README，在一般終端機執行：

Remove-Item "$env:LOCALAPPDATA\Programs\claude-img" -Recurse
Remove-Item "$env:USERPROFILE\.claude\skills\img" -Recurse

rm ~/.local/bin/claude-img
rm -r ~/.claude/skills/img

• 確認檔案建在專案資料夾最上層，而且有存檔（Antigravity 分頁標題旁的圓點消失才算存好）。
• 用 @ 直接指定檔案最準：請閱讀 @系統規劃.md，照裡面的需求做。
• 檔名打錯（例如變成 系統規劃.md.txt）也會找不到，在檔案總管裡確認一下。

這是好事，代表它在確認需求。看不懂就直接說「請用高中生聽得懂的話解釋，並給我建議選項」，或「這部分你幫我決定，說明原因就好」。

預覽放在 style-previews 資料夾。在 Antigravity 裡直接點 HTML 檔只會看到原始碼；要對檔案按右鍵 →「在檔案總管中顯示在 Finder 中顯示」，再雙擊用瀏覽器打開。資料夾不存在就跟 Claude 說「請先依照介面風格做出 5 種預覽」。

套件還沒安裝。在專案資料夾執行：

python -m pip install -r requirements.txt

python3 -m pip install -r requirements.txt

有用虛擬環境（.venv）的話，記得先啟用再安裝。也可以直接跟 Claude 說「幫我安裝需要的套件並啟動網站」。

• 網站程式要一直在終端機執行著才連得上；關掉那個終端機或按了 Ctrl+C，網站就停了。
• 確認網址與埠號跟終端機顯示的一致（例如 http://127.0.0.1:5000）。
• 終端機若有紅字錯誤，代表程式根本沒啟動成功，把錯誤貼給 Claude。

那個埠號被別的程式占用了——可能是你之前開的網站還在另一個終端機跑著（去那邊按 Ctrl+C 停掉）。Mac 的「AirPlay 接收器」也會占用 5000 埠，打開 localhost:5000 甚至會看到 403 錯誤。最簡單的做法是請 Claude「本機改用 5001 埠啟動」。

① 網站程式可能要重新啟動：在跑網站的終端機按 Ctrl+C 再重新執行；② 瀏覽器快取：按 Ctrl+F5⌘+⇧+R 強制重新整理；③ 確認 Claude 改的是你正在看的那個檔案。

通常是 HTML 沒有宣告 UTF-8 或檔案存成別的編碼。請 Claude「確認所有 HTML 範本都有 <meta charset="UTF-8">，檔案都存成 UTF-8」。

可以。進階版範本已要求「本機沒有設定 DATABASE_URL 時，自動改用 SQLite 檔案」，所以本機測試不用裝資料庫。記得請 Claude 把 SQLite 的資料庫檔加進 .gitignore，不要推上 GitHub。

把「你做了什麼、預期看到什麼、實際看到什麼」講清楚，附上錯誤訊息或截圖（Alt+VCtrl+V 貼圖）。例如：「在首頁選了排骨飯按送出，預期跳到成功頁，實際畫面沒變，終端機出現下面的錯誤：…」。

GitHub 上有你電腦沒有的內容，最常見是建立 repo 時勾了 README，或你在別台電腦推過。請 Claude Code：「git push 被拒絕，請幫我先拉下遠端內容合併再推送」。自己處理的話先 git pull 再 git push；第一次推送若出現「refusing to merge unrelated histories」，用：

git pull origin main --allow-unrelated-histories
git push -u origin main

GitHub 不接受用登入密碼推送。請照步驟 8-B 執行 gh auth login，依序選 GitHub.com → HTTPS → Yes → Login with a web browser。其中「Yes」就是讓 gh 幫 Git 處理登入，選了之後就不會再問密碼。檢查登入狀態：

gh auth status

遠端網址被設成 SSH 格式（git@github.com:...），但你沒有設定 SSH 金鑰。本課程用 HTTPS，把網址改回來即可（換成你的帳號）：

git remote set-url origin https://github.com/你的帳號/my-first-app.git

• 網址打錯：帳號名稱或 repo 名稱拼錯、大小寫不同。到 GitHub 的 repo 頁面複製正確網址，再用上一題的 git remote set-url 更新。
• 登入的帳號不對：private repo 只有擁有者看得到。用 gh auth status 確認登入的是建立 repo 的那個帳號。

之前已經加過遠端位址了。不用再 add，改用 git remote set-url origin 正確網址 更新即可，用 git remote -v 可以查看目前設定。

還沒有任何 commit（或分支不叫 main）。先確認 git add . 和 git commit -m "first commit" 有成功（commit 失敗常是沒設定名字與 Email，見 3+），再執行 git branch -M main 和 git push -u origin main。

終端機不在專案資料夾，或專案還沒 git init。確認提示字元路徑是 my-first-app；是的話執行 git init。

安裝完要重開終端機（Antigravity 也要重開）。若 winget 本身也無法辨識（學校電腦常見），改到 cli.github.com 下載 Windows 安裝檔（.msi）安裝。Mac 請確認 cli.github.com 下載的 .pkg 有安裝完成。

按 Enter 後會打開 github.com/login/device，把終端機上的 8 碼代碼貼進去 → 授權。授權前先看右上角頭像，確認是你自己的 GitHub 帳號（電腦教室的瀏覽器可能還登著上一位同學）。登錯了就執行 gh auth logout 再重新登入。

用啟用 2FA 時下載的復原碼（recovery codes）登入，之後重新設定 2FA。所以啟用時一定要把復原碼存好（印出來或存在安全的地方）。沒有復原碼就要照 GitHub 的帳號復原流程申請，會比較久。

到 repo 頁面 → Settings → 最下方 Danger Zone →「Change repository visibility」改成 Private。如果在公開期間推上了 API 金鑰，請照下一題處理。

1. 第一件事：立刻到該服務的網站把金鑰作廢（revoke），產生一把新的。金鑰一旦被推上去就要當作已經外洩，光從 GitHub 刪掉沒有用（舊紀錄裡還找得到）。
2. 新的金鑰只放在本機 .env 和 Zeabur 的環境變數。
3. 請 Claude：「把 .env 加進 .gitignore，並從 Git 追蹤中移除（保留本機檔案），然後 commit 和 push」。
4. 想連歷史紀錄都清乾淨，可參考 GitHub 官方文件 Removing sensitive data from a repository，或請老師協助（操作較進階）。

同一段程式在兩邊被改成不同內容，Git 不知道要留哪個。別慌，直接跟 Claude 說「幫我解決合併衝突，並說明你保留了哪些內容」，確認沒問題再 commit。

你有 N 個存檔點還沒上傳，執行 git push 就好。反過來顯示「behind」代表 GitHub 上比較新，先 git pull。

目前分支有還沒 commit 的修改。先把它們 commit（git add .、git commit -m "說明"），再 git switch main。不確定要不要保留，就請 Claude「先幫我看看有哪些未存檔的修改，再建議怎麼處理」。

代表 .gitignore 沒寫好或是後來才加。請 Claude「把 .gitignore 補齊，並把已經被追蹤的 node_modules、__pycache__、.venv 從 Git 移除（保留本機檔案），然後 commit 和 push」。

private repo 要授權 Zeabur App 才看得到。點「Configure GitHub」，在 GitHub 頁面的 Repository access 勾選 my-first-app（或改成 All repositories）→ Save，回到 Zeabur 重新整理。也要確認 Zeabur 登入的 GitHub 帳號就是 repo 的擁有者。

點服務的「部署日誌 / Logs」，把紅字整段複製給 Claude：「Zeabur 建置失敗，日誌如下，請幫我修正並推送」。常見原因：

• 沒有 requirements.txt，或少寫了某個套件（本機裝過所以能跑，線上沒有）。
• Python 版本不對：Zeabur 預設用 Python 3.10，請確認環境變數有 ZBPACK_PYTHON_VERSION = 3.11。
• 程式根本沒推上 GitHub：到 GitHub repo 頁面確認檔案都在。

Zeabur 會用 main.py、app.py、server.py 等常見檔名判斷 Python 入口。主程式檔名不同時，可以新增環境變數 ZBPACK_PYTHON_ENTRY（值填你的主程式檔名），或請 Claude「依照 Zeabur 文件調整，讓它正確偵測 Python 專案」。參考：Zeabur Python 部署文件。

程式有跑起來，但 Zeabur 連不到它。最常見是程式只聽 127.0.0.1 或寫死 5000 埠。請 Claude：「請把程式改成可以部署到 Zeabur：用 gunicorn 啟動，監聽 0.0.0.0 與環境變數 PORT」，推送後等重新部署。也請看「Logs」裡的執行期錯誤（不只建置日誌）。

• 本課程用 psycopg 3（psycopg[binary]），連線字串開頭要從 postgresql:// 轉成 postgresql+psycopg://，否則 SQLAlchemy 會去找舊的 psycopg2。請 Claude 依照「系統規劃.md」的連線設定修正。
• 確認 PostgreSQL 服務是「Running」，而且和網站在同一個專案裡。
• 確認網站服務的環境變數有 DATABASE_URL = ${POSTGRES_CONNECTION_STRING}（大小寫、大括號都要一樣）。

資料庫是空的，資料表還沒建立。請 Claude「確認程式啟動時會自動建立資料表（進階版規劃第 5 點），修好後推送」。

環境變數要在服務重新部署後才生效。存檔後到服務頁面按「重新部署 / Redeploy」，等狀態變回 Running。

• 確認推送的是 main 分支（還在功能分支上的話，要先合併回 main 再 push）。
• 到 GitHub 確認新的 commit 真的有上去（Claude 回報 push 成功才算）。
• 到 Zeabur 服務頁面看部署紀錄；必要時手動按「重新部署」。

網站可能在線上也用了 SQLite 檔案。雲端服務每次部署都是全新的環境，存在檔案裡的資料會消失。請確認 DATABASE_URL 有設定，讓網站使用 Zeabur 的 PostgreSQL。

.zeabur.app 的前綴是大家共用的，被別人用過就不能選。換一個，例如加上班級或名字：my-first-app-301。

需要信用卡綁定，未成年請家長協助。Zeabur 的免費共享叢集已在 2026 年 4 月 1 日停止建立新專案；只是想免費練習流程，請改用 步驟 10 推薦的免費平台（Render 或 Vercel，搭配 Neon 資料庫）。

伺服器要等狀態變成「運行中」才能選，剛購買請等幾分鐘後重新整理頁面。

用手機截圖，貼給 Claude（Alt+VCtrl+V 或 /img）：「手機上版面跑掉了，請修正成手機也好用的排版」，改好後一樣 commit → merge → push，Zeabur 會自動更新。

免費網站 15 分鐘沒人連線就會休眠，喚醒大約要 1 分鐘，這是正常的。等它載入完，之後一段時間內都會很快。上課展示前先自己打開一次。

要在 GitHub 安裝該平台的授權 App，並在 Repository access 勾選 my-first-app。Render 在建立 Web Service 時會出現設定連結；Vercel 在 Import 頁面點「Adjust GitHub App Permissions」。也要確認登入的 GitHub 帳號就是 repo 的擁有者。

Start Command 的 gunicorn 檔名:變數名 跟程式對不起來。例如主程式是 main.py，就要填 gunicorn main:app。不確定就把錯誤整段貼給 Claude：「Render 的 Start Command 要填什麼？」

• 確認專案的 Storage 已經連結 Neon，Settings → Environment Variables 裡有 DATABASE_URL，然後重新部署（Redeploy）。
• Vercel 線上不能寫檔案，所以不能用 SQLite。請 Claude 確認「有 DATABASE_URL 時一定用 PostgreSQL」。

Vercel 只支援 Python 3.12 以上，不支援 3.11。請 Claude「新增 .python-version 寫 3.12，並確認程式和套件在 3.12 可以執行」，推送後重新部署。

就算是 private repo 也要處理：到 Neon 專案重設資料庫密碼（產生新的連線字串），再把新的字串更新到 Render／Vercel 的環境變數並重新部署。之後請 Claude 從程式碼移除舊字串，並確認 .env 有寫進 .gitignore。

進度只存在這台電腦的這個瀏覽器裡。換電腦、換瀏覽器、用無痕模式或清除瀏覽資料，勾勾就會消失；不影響你實際裝好的東西。

直接跟 Claude 說你想加的功能，照「開分支 → 實作 → 本機測試 → commit 後合併回 main 並 push」的節奏一段一段做。遇到不懂的，用 /btw 順便問問題，不會打斷主要對話。

1. 把做到第幾步、輸入了什麼指令、完整錯誤訊息（截圖或複製文字）準備好。
2. 先貼給 Claude Code 問；Claude 自己出問題時，在 Claude Code 裡輸入 /doctor 檢查。
3. 再帶著資訊問老師或同學。帳號、訂閱、付款問題，請到 claude.ai 左下角帳號選單的「Get help」聯絡 Anthropic 客服。

把截圖存成本頁對應檔名放到網站的 public/ai-coding/ 資料夾（例如 01-python-win.png、02-antigravity-zh.png…），頁面會自動改顯示真實截圖。