Claude-Code-Game-Studios: tạo game chạy trên trình duyệt từ một câu mô tả — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về Donchitos/Claude-Code-Game-Studios — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: Claude-Code-Game-Studios: biến Claude Code thành studio làm game →

Tóm tắt nhanh
Claude-Code-Game-Studios là một mẫu dự án (template) cho Claude Code, gồm 49 agent AI và hàng chục skill, giúp bạn đi từ ý tưởng đến game chơi được trên trình duyệt. Bạn chỉ cần gõ lệnh /prototype kèm mô tả game. Cài đặt khá nhẹ: clone repo, mở Claude Code trong thư mục đó, nhưng cần chuẩn bị Git, Python 3, Bash và một trình duyệt Chrome/Edge.
Claude-Code-Game-Studios là một mẫu dự án (template) dành cho Claude Code. Nó biến Claude Code thành một "xưởng làm game" thu nhỏ: có 49 agent AI, hàng chục skill (lệnh dạng /tên-lệnh) và một hệ thống phối hợp mô phỏng cách một studio thật chia việc. Bạn mô tả game muốn làm, Claude hỏi vài câu, viết một bản brief một trang rồi dựng bản game đầu tiên chạy ngay trên trình duyệt.
Repo này hợp với ai? Người chưa biết code nhưng có ý tưởng game, chủ shop muốn làm một trò nhỏ để tương tác với khách, và lập trình viên mới muốn có quy trình làm game bài bản thay vì mò mẫm. Bạn không cần biết Godot, Unity hay Unreal để bắt đầu. Bản đầu tiên là game web, mở bằng cách bấm đúp vào file.
Điểm đáng giá nhất là cách nó làm việc từng bước nhỏ. Mỗi lần bạn đổi gì đó, nó kiểm tra lại theo những điều bạn đã dặn giữ hoặc tránh, và mỗi thay đổi bạn chấp nhận sẽ thành một điểm có thể quay lại. Repo hiện có khoảng 38.7 nghìn sao và 5.037 fork trên GitHub, giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây.
Donchitos/Claude-Code-Game-Studios
Bộ khung biến Claude Code thành xưởng làm game: bạn mô tả ý tưởng, nó hỏi vài câu, viết bản brief một trang rồi dựng game chạy được trên trình duyệt.
I.Claude-Code-Game-Studios làm được gì
Phần này nói những tính năng chính theo thứ tự bạn sẽ gặp khi dùng.
Hỏi trước, làm sau. Khi bạn gõ /prototype kèm ý tưởng, nó hỏi một lượt câu hỏi chọn theo thể loại game: lối chơi, cảm giác, hình ảnh, độ khó, mục tiêu. Câu nào cũng có đáp án thường dùng, nên bạn trả lời "bạn chọn giúp" là xong. Nếu ý tưởng quá mơ hồ (ví dụ chỉ "game đua xe"), nó đưa ra hai ba câu giới thiệu ngắn để bạn chọn hướng trước.
Bản brief một trang. Nó ghi vào design/game-brief.md: lời bạn nói được giữ nguyên, kèm giao diện, phút đầu tiên của người chơi, thử thách, tính năng và những thứ để dành sau. Bạn đọc rồi nói "Build it" hoặc sửa trước. Lợi ích thực tế là bạn không bị cuốn vào một game khác hẳn thứ mình nghĩ.
Bản build đầu tiên chạy trên trình duyệt. Game nằm trong prototypes/<tên>/, mở bằng cách bấm đúp. README cam kết hình vẽ thật chứ không dùng emoji làm đồ hoạ, không sao chép game khác và không dễ đến mức nhàm.
Tự kiểm tra trước khi giao. Một trình duyệt không giao diện (headless) bấm thử vài phím để xem game có mở không lỗi và có phản hồi không. Chữ quá nhỏ, chồng lên nhau, tràn khỏi màn hình hoặc màn hình bị đứng sẽ được sửa trong một vòng. Từng dòng trong brief được đánh dấu là đã làm, thiếu, hỏng, hoặc chưa kiểm tra được. Cuối cùng là tấm "thẻ bàn giao" nói thẳng cái gì đã qua, cái gì còn hỏng, cái gì là đoán, và kết bằng câu "Not yet played by a person" (chưa có người thật chơi thử).
Sửa, chia sẻ, phát triển, hoàn thiện.
- Sửa bằng cách nhờ. Nếu bạn nhờ chỉnh thông số, game có thêm bảng tinh chỉnh với thanh trượt cho từng giá trị.
- Chia sẻ: tạo bản sạch (không có bảng chỉnh và file làm việc) để đưa lên itch.io hoặc gửi bằng đường link.
- Phát triển: khi ưa game, nó thành một dự án web thật (Vite và TypeScript, thông số nằm trong file dữ liệu, có test và build). Bạn thêm mỗi lần một tính năng; sau mỗi tính năng, một lượt chơi cố định (seeded) được chạy lại và mọi thay đổi được báo cho bạn.
- Hoàn thiện: lệnh
/cutđề xuất thứ nên cắt, danh sách việc đánh bóng, và một ngày phát hành nếu game dùng để bán.
Đi tiếp lên engine. Ngoài web, repo hỗ trợ Godot 4, Unity và Unreal Engine 5. README nói thẳng phần này đã xây và qua kiểm tra nội bộ của framework nhưng chưa được thử nghiệm kỹ như đường web.
Hệ thống an toàn kèm theo. Có các hook (tập lệnh Bash tự chạy) kiểm tra khi commit, push, ghi file, và các quy tắc quyền hạn. Bạn không phải làm gì thêm, nhưng cần hiểu vì sao chúng đòi bạn mở Claude Code đúng thư mục (xem phần lỗi hay gặp).
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Git để tải repo về.
- Claude Code. README khuyên dùng trình cài đặt gốc (xem trang hướng dẫn cài Claude Code của Anthropic). Cách khác là
npm install -g @anthropic-ai/claude-code, yêu cầu Node.js 22 trở lên. README không nói chi tiết về tài khoản hay gói dùng; bạn xem thêm ở trang cài Claude Code. - Python 3. Mọi skill và hook dùng nó để đọc file
project.yaml. Thiếu Python thì mọi cài đặt lặng lẽ quay về mặc định. - Bash. Mọi hook chạy bằng Bash. macOS và Linux có sẵn. Trên Windows, Bash đi kèm Git for Windows. Thiếu Bash trên Windows thì hook tự bỏ qua và lúc mở phiên sẽ có thông báo là các kiểm tra đang tắt.
- Chrome, Edge hoặc Chromium. Lệnh
/prototypedùng nó để chơi thử và chụp màn hình. Không có thì các bước kiểm tra này ghi là "chưa đánh giá". - Nên có thêm: Node.js (để phát triển game thành dự án web, game 3D dùng three.js, và build/test của engine web) và jq (để kiểm tra hook).
README không đề cập yêu cầu phần cứng như GPU hay dung lượng RAM.
Claude Code chạy nhiều bước và có thể tốn chi phí sử dụng. README cho biết bạn có thể yêu cầu "build it at medium" để rẻ hơn, đổi lại bản game mỏng hơn. Hãy theo dõi mức dùng của mình khi thử lần đầu.
III.Cài đặt từng bước
- Cài công cụ nềnGit, Claude Code, Python 3, Bash (Windows dùng Git for Windows) và Chrome hoặc Edge
- Tải repo vềClone repo thành thư mục dự án game của bạn rồi cd vào
- Mở Claude Code đúng chỗChạy claude ngay trong thư mục gốc có CLAUDE.md và project.yaml
- Bắt đầuGõ /prototype kèm ý tưởng, hoặc /start để được dẫn đường
A.Cài các công cụ nền
Cài Git, Claude Code, Python 3 và một trình duyệt Chrome, Edge hoặc Chromium. Người dùng Windows nhớ cài Git for Windows vì nó mang theo Bash cho các hook. Nếu bạn chọn cài Claude Code bằng npm (cần Node.js 22 trở lên), README ghi lệnh:
npm install -g @anthropic-ai/claude-codeLệnh này cài Claude Code thành lệnh dùng toàn máy. README khuyên dùng trình cài đặt gốc hơn; cách làm nằm ở trang hướng dẫn cài của Claude Code.
B.Tải repo về làm dự án của bạn
Mở terminal (Windows: Git Bash hoặc PowerShell; macOS: Terminal) ở thư mục bạn muốn chứa dự án, rồi chạy:
git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-gameLệnh đầu tải repo và đặt tên thư mục là my-game (bạn đổi tên khác được). Lệnh thứ hai đi vào thư mục đó. Repo này là một mẫu để bắt đầu dự án của riêng bạn, nên game của bạn sẽ nằm trong chính thư mục này.
C.Mở Claude Code trong thư mục gốc
Đứng ở thư mục my-game (nơi có CLAUDE.md và project.yaml) và chạy:
claudeĐây là chỗ người mới hay vấp nhất. README nhấn mạnh: nếu bạn mở Claude Code trong một thư mục con như src/, các hook, quy tắc chặn và chế độ hỏi-trước-khi-làm của dự án sẽ không được dùng.
D.Bắt đầu tạo game
Trong phiên Claude Code, gõ /prototype kèm ý tưởng. Ví dụ đúng từ README:
/prototype a fishing game where the rare fish only bite at duskNếu chưa có ý tưởng rõ, gõ /start. Lệnh này hỏi bạn đang ở đâu (muốn làm ngay một game, có ý tưởng hoặc chưa có, đã có thiết kế rõ, hay đã có sản phẩm dở) rồi dẫn đến quy trình phù hợp. Các lối vào khác theo README:
/next-step
/brainstorm
/setup-engine godot 4.7
/project-stage-detectTheo thứ tự: /next-step chỉ ra một bước kế tiếp dù bạn đang ở đâu; /brainstorm giúp nghĩ ý tưởng từ đầu; /setup-engine godot 4.7 cấu hình engine nếu bạn đã biết mình muốn dùng engine nào; /project-stage-detect phân tích một dự án có sẵn.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra đơn giản nhất là chạy thử một vòng /prototype. Theo README, bạn sẽ thấy lần lượt:
- Một lượt câu hỏi ngắn về game của bạn.
- File
design/game-brief.mdxuất hiện để bạn đọc và duyệt. - Sau khi bạn đồng ý, thư mục
prototypes/<tên>/được tạo, chứa game mở được bằng cách bấm đúp. - Một tấm thẻ bàn giao nói rõ mục nào đã qua kiểm tra, mục nào còn hỏng, mục nào là đoán, kết bằng "Not yet played by a person".
Ngoài ra, lúc mở phiên, hook ở đầu phiên hiển thị nhánh Git hiện tại và các commit gần đây. Nếu bạn thấy thông báo rằng kiểm tra của hook đang tắt, nghĩa là Bash chưa có (trên Windows) và bạn nên xem lại Git for Windows. Để xem cấu hình đang áp dụng, gõ:
/project-settingsV.Dùng vào việc thật
A.Chủ shop làm một game nhỏ cho fanpage
Bạn bán đồ câu cá và muốn có một trò chơi vui để khách chơi khi ghé trang. Bạn mở Claude Code trong thư mục dự án và gõ ý tưởng giống ví dụ của README:
/prototype a fishing game where the rare fish only bite at duskBạn trả lời các câu hỏi (hoặc "bạn chọn giúp"), đọc bản brief, nói "Build it". Kết quả là một game trong prototypes/<tên>/ mở được bằng cách bấm đúp, kèm thẻ bàn giao nói những phần nào còn hỏng. Nhớ rằng đó là bản chưa có người chơi thử, nên bạn tự chơi vài lượt trước khi đưa cho ai.
Bản game đầu tiên chưa phải sản phẩm, nó là thứ để bạn chơi thử và biết mình thật sự muốn gì.
Ông T
B.Nhân viên văn phòng sửa game theo góp ý của đồng nghiệp
Bạn làm game vui cho phòng ban, đồng nghiệp nói game hơi khó. Bạn không cần mở code: chỉ nhờ Claude chỉnh. Theo README, mỗi thay đổi được kiểm tra với điều bạn đã dặn giữ hoặc tránh, và mỗi thay đổi bạn chấp nhận là một điểm có thể quay lại. Nếu muốn tự chỉnh các con số, bạn nhờ nó thêm bảng tinh chỉnh với thanh trượt cho từng giá trị. Khi xong, bạn nhờ tạo bản chia sẻ sạch để đăng lên itch.io hoặc gửi bằng đường link.
C.Lập trình viên mới biến bản thử thành dự án thật
Bạn đã chơi bản thử và thích. README nói game sẽ thành một dự án web thật với Vite và TypeScript, thông số để trong file dữ liệu, có test và build. Sau đó bạn chỉ nói tính năng tiếp theo, mỗi lần một cái: nó được dựng, kiểm tra và commit. Sau mỗi tính năng, một lượt chơi cố định được chạy lại để bạn thấy mọi thay đổi. Cách này giúp bạn học dần cấu trúc dự án mà không bị ngợp. Khi cần quy trình truyện (story) thì bạn tự gọi /create-stories, /dev-story, /story-done.
D.Người đã có game web muốn đưa vào quy trình
Nếu bạn đã có một game chạy trên trình duyệt, README nói lệnh /prototype --from (kèm nguồn game; phần tham số bị lược trong tư liệu mình đọc, bạn xem đúng cú pháp trong README) sẽ đưa một bản sao vào nguyên trạng để sau đó sửa và phát triển như các game khác. Khi gần xong, gõ /cut để nhận danh sách thứ nên cắt, việc đánh bóng và ngày phát hành nếu game để bán.
Nếu dự án lớn dần, bạn có thể tăng độ chặt của quy trình bằng một lệnh:
/project-settings modes.rigor=fullMặc định là minimal (nhẹ nhất). standard và full yêu cầu nhiều phần tài liệu thiết kế hơn và nhiều agent duyệt hơn, nên tốn chi phí hơn.
VI.Lỗi hay gặp và cách xử lý
A.Hook và quy tắc không có tác dụng
Nguyên nhân thường gặp: bạn chạy claude trong thư mục con như src/. README nói thẳng làm vậy sẽ bỏ qua hook, quy tắc chặn và chế độ hỏi-trước của dự án. Cách xử lý: thoát phiên, cd về thư mục gốc có CLAUDE.md và project.yaml, rồi chạy lại claude.
B.Cài đặt quay về mặc định mà không báo lỗi
Nếu máy không có Python 3, mọi cài đặt trong project.yaml lặng lẽ dùng giá trị mặc định. Hơn nữa, một commit có đưa file JSON dữ liệu vào sẽ bị chặn khi không có Python để kiểm tra. Cách xử lý: cài Python 3 và mở lại phiên.
C.Trên Windows, hook tự bỏ qua
Hook chạy bằng Bash. Windows không có sẵn, README nói nó đi kèm Git for Windows. Nếu thiếu, hook tự bỏ qua và lúc mở phiên có thông báo các kiểm tra đang tắt. Cách xử lý: cài Git for Windows rồi mở lại terminal.
D.Các bước chơi thử và chụp màn hình ghi "chưa đánh giá"
Lệnh /prototype cần Chrome, Edge hoặc Chromium để tự chơi và chụp ảnh game. Không có thì các mục kiểm tra đó được đánh dấu chưa đánh giá. Cách xử lý: cài một trong ba trình duyệt trên, rồi nhờ kiểm tra lại.
E.Bản build đầu quá mỏng hoặc quá tốn
Bản dựng chạy theo mức nỗ lực của phiên Claude Code của bạn. README nói "build it at medium" thì rẻ hơn nhưng mỏng hơn. Nếu bản đầu chưa ưng, bạn nhờ sửa từng phần thay vì làm lại từ đầu, vì cách này có kiểm tra và có điểm quay lại.
VII.Có nên dùng không
Điểm mạnh. Bạn đi từ ý tưởng đến một game chơi được mà không cần tự dựng môi trường. Quy trình hỏi rồi viết brief rồi build rồi kiểm tra rồi bàn giao rất rõ, và tấm thẻ bàn giao nói trung thực chỗ nào còn hỏng. README cũng nói rõ cái gì đã được thử: trong một so sánh mù trên ba ý tưởng game, brief sinh từ các câu hỏi được chọn hơn brief viết tay cả ba lần; còn trên chính các game được dựng thì hai loại brief hoà nhau. Giấy phép MIT nên bạn dùng tự do.
Giới hạn. Bằng chứng về việc phát triển game lâu dài còn mỏng: README nói một game được nuôi qua sáu story chỉ là một trường hợp, chưa thành quy luật. Đường Godot, Unity, Unreal chưa qua thử nghiệm như vậy. Repo cũng không kèm sẵn game nào để bạn tham khảo. Công cụ phụ thuộc vào Claude Code, nên bạn cần quen với chi phí và quyền truy cập của nó. Cuối cùng, mọi thứ vẫn cần một người thật chơi thử, vì bản đầu luôn ghi là chưa có người chơi.
Khi nào chọn cách khác. Nếu bạn chỉ cần một đoạn code nhỏ hoặc không muốn cài nhiều công cụ nền, dùng thẳng Claude Code không cần mẫu này có thể gọn hơn. Nếu bạn đã quen một engine và có quy trình riêng, hãy xem repo này như nơi tham khảo cách tổ chức agent và skill hơn là thứ phải theo trọn bộ.
Câu hỏi thường gặp
Repo này có miễn phí không?
Repo dùng giấy phép MIT nên bạn tải và dùng tự do. Tuy nhiên nó chạy bên trong Claude Code, và README không nói chi tiết về chi phí hay gói đăng ký của Claude Code. Bạn nên xem trang cài đặt của Claude Code để biết điều kiện sử dụng.
Có cần biết lập trình để dùng không?
Để làm bản game đầu tiên thì không bắt buộc: bạn mô tả ý tưởng, trả lời vài câu hỏi và duyệt bản brief. Khi muốn phát triển game thành dự án web thật, bạn sẽ gặp Vite, TypeScript, test và build, nên biết một chút sẽ có ích. Bạn vẫn có thể tiếp tục bằng cách nhờ Claude làm từng tính năng.
Chạy được trên Windows không?
Có, nhưng cần Git for Windows vì nó đi kèm Bash để chạy các hook. Thiếu Bash, hook tự bỏ qua và lúc mở phiên bạn sẽ thấy thông báo các kiểm tra đang tắt. README cũng nhắc thông báo của repo hiển thị bằng toast của Windows qua PowerShell.
Cần GPU hay máy mạnh không?
README không nêu yêu cầu phần cứng như GPU hay RAM. Game đầu tiên là game chạy trên trình duyệt, và bạn cần Chrome, Edge hoặc Chromium để chơi và chụp màn hình kiểm tra. Về cấu hình máy cụ thể thì chưa có thông tin trong tư liệu.
Game làm ra có thể bán hoặc đăng lên itch.io không?
README nói bạn có thể tạo bản chia sẻ sạch (không có bảng tinh chỉnh và file làm việc) sẵn sàng cho itch.io hoặc một đường link. Lệnh /cut còn đề xuất việc đánh bóng và một ngày phát hành nếu game dùng để bán. Về bản quyền của nội dung do AI tạo, tư liệu chưa nói gì.
Mình dùng Godot, Unity hoặc Unreal được không?
Được. Repo hỗ trợ Web (mặc định), Godot 4, Unity và Unreal Engine 5, cấu hình bằng /setup-engine. Tuy nhiên README nói thẳng đường engine này đã xây và qua kiểm tra của framework nhưng chưa có thử nghiệm như đường web.
Khác gì so với việc chỉ nhờ Claude Code viết game?
Repo thêm một quy trình có cấu trúc: hỏi theo thể loại, bản brief một trang, bản build có tự kiểm tra, thẻ bàn giao, và các điểm quay lại sau mỗi thay đổi. Nó cũng có 49 agent, hàng chục skill, hook và quy tắc quyền hạn. Còn so sánh trực tiếp với các công cụ khác thì tư liệu chưa có thông tin.


