2026 Claude Code 遊戲開發最全教學：從環境安裝到 AI 協作，零基礎製作並執行小遊戲

2026 年「用 AI 做遊戲」最常見的失敗，不是模型不夠聰明，而是第一天就打開 Unity、Godot 和 Unreal 的對照文，卻連一個能按空白鍵動起來的視窗都沒有。Claude Code 是終端機裡的程式 Agent：它能改檔案、跑命令、讀報錯。把它用在遊戲開發上，關鍵不是讓它「一次性寫出 3A」，而是先鎖定一條能在本機執行的技術棧，再用小步協作把遊戲循環、輸入與碰撞補全。這篇教學從 Node 與 Claude Code 安裝寫到 pygame 與 HTML5 兩條零基礎路線，驗收標準是：別人依 README 也能啟動，並且你能連續玩至少一分鐘。若你之後要碰 iOS 或 Unity 行動匯出，工具鏈會要求 macOS，那一步請看遠端 Mac 租用，不要在 Linux 上找不存在的 Xcode。

為什麼做遊戲要先談「棧」，再談 AI

舊思路是向聊天機器人描述「做一個像某某的遊戲」，然後貼上一大段無法執行的程式。新思路是把倉庫當成真實工程：有 main.py 或 index.html、有固定幀率循環、有 git 歷史。Claude Code 在這種工程裡才能反覆執行「改一個檔案 → 執行 → 讀 traceback → 再改」。矛盾不在模型智商，而在執行邊界：AI 改的是哪份檢出、執行命令在哪台機器跑、失敗時有沒有可回滾的 commit。

遊戲還多一層：美術、音效、物理與關卡資料往往比業務 CRUD 更亂。零基礎更要把範圍壓到一個矩形、一個速度向量、一個得分。2D 橫版或打磚塊足夠練協作流程；3D、連線、Steam 上架屬於後面的帳。日常 2D 練習在現有筆電上即可完成；只有當流程真的需要 Apple 工具鏈時，才值得切換到 macOS 節點。

先把「小遊戲棧」分成三類

按「執行環境 + 渲染 + 分發」分類，不要按流行度排名。第一類是腳本 + 桌面視窗（Python pygame、Love2D）；第二類是瀏覽器 Canvas/WebGL（原生 Canvas、Phaser、Pixi）；第三類是引擎編輯器（Godot、Unity、Unreal）。Claude Code 對第一、二類最友善，因為工程主要是文字檔，diff 清晰；第三類要先熟悉編輯器按鈕，AI 容易和 .import / Library 目錄打架。

本篇預設你在 Windows、macOS 或 Linux 上開發。pygame 需要 Python 3.10+；HTML5 路線需要 Node 只是為了跑本機靜態伺服器，不是為了把遊戲編譯成 Node 服務。

協作入口才是分水嶺，不是模型

模型能力不是分水嶺，誰持有可執行檢出才是。Cursor 在 IDE 裡改檔案；Claude Code 在終端機裡依你的許可跑命令。做遊戲時，兩者都能寫循環，但若執行命令只在 AI 對話裡「描述」而不執行，你仍會卡在 ImportError。

CLI 選型細節見 Pi、Claude Code 與 Codex 實測。重複性的「每次開專案都解釋 pygame 規範」可以裝 Skill，見 Agent Skills 指南。

依場景選棧與協作方式

零基礎推薦組合（pygame 路線）

作業系統：任選。Python 3.11+ 與 pip install pygame。Node 22 LTS 僅用於安裝 Claude Code CLI（依 Anthropic 目前文件執行 npm install -g @anthropic-ai/claude-code 或官方安裝器）。API 金鑰放在 ~/.config/game-dev/anthropic.env，目錄 700、檔案 600，並在 .gitignore 忽略。

倉庫根目錄放 GAME.md：用五句話寫清操作鍵、失敗條件、得分規則、目標幀率、驗收截圖描述。Claude Code 每次改程式前先讀它，避免 scope creep。執行命令固定為 python main.py；HTML5 路線則為 npx --yes serve . 開啟提示的 localhost 連埠。

五個會讓專案作廢的誤區

1. 第一天選 Unity 3D。 匯入、光照、物理預設會吞掉整週，AI 也難以一次 diff 正確。
2. 不讓 Agent 跑命令。 只看產生程式不執行，ImportError 會堆到無法定位。
3. 一次 prompt 要「完整遊戲」。 應拆：視窗 → 輸入 → 碰撞 → 得分 → 音效。
4. 不做 git commit。 AI 重寫全檔案時無法回滾，協作信任會崩。
5. 在錯誤 OS 上追 Xcode。 iOS 建置從 macOS 節點開始，定價見 Mac mini 定價 與 說明中心。

從環境安裝到第一個可執行小遊戲的七步

1. 安裝 Node 22 LTS 與 git。 終端機執行 node -v、git --version，版本號可見才算完成。
2. 安裝 Claude Code CLI。 依官方文件完成登入或 API 設定；金鑰不進 shell 歷史。
3. 建立專案目錄並 git init。 寫入 .gitignore（含 env、__pycache__）、空 README.md 與 GAME.md。
4. 選 pygame 或 HTML5。 pygame：建立虛擬環境並 pip install pygame。HTML5：建立 index.html + game.js。
5. 讓 Claude Code 產生最小骨架。 要求「可執行、單檔或雙檔、無占位 TODO」；在對話內執行命令直到無報錯。
6. 迭代玩法。 每次只加一個機制（例如碰撞或得分），每步 commit；手感不對就改常數而不是重寫架構。
7. 寫清 README。 列出安裝依賴、執行命令、已知 bug；請朋友依 README 重現，成功即驗收。

python3 -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install --upgrade pip pygame
python -c "import pygame; print(pygame.ver)"

cd my-first-game
git add GAME.md README.md .gitignore
git commit -m "chore: bootstrap game spec"
claude   # 依官方文件登入後，在對話中要求產生 main.py 並執行 python main.py

npx --yes serve .
# 瀏覽器開啟終端機提示的 http://localhost:3000（連埠以實際為準）

常見問題

完全不會程式可以做嗎？

可以，但要把範圍壓到一個小遊戲：一種操作、一種失敗條件、一個得分。先跑通官方安裝與執行命令，再讓 AI 改單檔。

Claude Code 和 Cursor 做遊戲哪個更好？

Cursor 適合你在編輯器裡邊看邊改；Claude Code 適合在終端機裡按步驟執行、跑測試。零基礎第一條可執行路線，用 Claude Code 把命令與檔案結構寫清楚往往更快。

一定要學 Unity 嗎？

不必。Unity 適合 3D 與複雜資源管線。第一個作品用 pygame 或 HTML5 Canvas 更容易在本機當天看到結果。

AI 寫的程式跑不起來怎麼辦？

把完整報錯貼回對話，並要求只改相關檔案。每次只修一個錯誤，commit 後再繼續。

怎樣算「做完第一個小遊戲」？

他人依 README 安裝依賴後能啟動；核心循環可玩至少 60 秒；倉庫裡有清晰的操作說明與已知問題列表。

總結

Claude Code 做遊戲，拼的是可執行棧 + 小步 commit + 允許 Agent 執行命令，不是一次產生「完整 3A」。先 pygame 或 HTML5 跑通七步，再考慮 Godot、Unity 或 iOS。工具鏈一旦碰到 Xcode，就切換到 macOS 節點；日常 2D 練習在現有筆電上即可完成。

延伸閱讀

• Claude Code 與 Cursor、Codex 的執行邊界 →
• 替重複流程裝 Agent Skills →
• 長任務放到 VPS + tmux →