Claude-Code-Game-Studios: biến Claude Code thành studio làm game

Tóm tắt nhanh
Claude-Code-Game-Studios là template biến Claude Code thành một studio phát triển game có quy trình từ ý tưởng, prototype đến phát triển và hoàn thiện. Repo hỗ trợ game web, Godot, Unity và Unreal Engine. Cài đặt chủ yếu là clone repo, mở Claude Code đúng thư mục và dùng các lệnh slash; người mới cần chuẩn bị thêm Python 3, Bash và trình duyệt Chromium.
Repo này là một template giúp biến Claude Code thành một studio phát triển game có quy trình rõ ràng từ ý tưởng đến bản chơi được. Bạn mô tả game bằng ngôn ngữ tự nhiên, Claude Code sẽ hỏi thêm vài câu, viết brief một trang, tạo prototype chạy trên trình duyệt và kiểm tra bản build bằng trình duyệt headless.
Repo phù hợp với chủ shop muốn tự làm một game nhỏ, người làm nội dung muốn thử ý tưởng game, designer, lập trình viên mới và nhóm indie cần một quy trình làm việc có sẵn. Điểm đáng giá nhất là bạn không chỉ nhận được một đoạn code đầu tiên. Mỗi bước đều có brief, kiểm tra, checkpoint và thông tin về phần đã đạt, phần còn lỗi hoặc phần đang được phỏng đoán.
Đây là framework chạy bên trong Claude Code, không phải một game hoàn chỉnh. Repo hiện có khoảng 38.834 sao và 5.046 fork, dùng giấy phép MIT. Các game tạo ra sẽ nằm trong project riêng của bạn, không được đóng sẵn trong repo mẫu.
Donchitos/Claude-Code-Game-Studios
Biến Claude Code thành studio game với 49 AI agent, quy trình phối hợp và các skill hỗ trợ làm game.
I.Claude-Code-Game-Studios làm được gì
A.Biến một ý tưởng ngắn thành prototype chơi được
Bạn có thể bắt đầu bằng một câu như /prototype a fishing game where the rare fish only bite at dusk. Claude Code sẽ hỏi một vòng câu hỏi về thể loại, cảm giác chơi, hình ảnh, độ khó và mục tiêu. Nếu ý tưởng còn mơ hồ, hệ thống đưa ra vài hướng ngắn để bạn chọn.
Sau đó, Claude Code ghi lại ý tưởng trong design/game-brief.md và chờ bạn xem lại. Khi bạn đồng ý, nó tạo một game trình duyệt trong prototypes/<name>/. Prototype có thể mở bằng cách double-click, nên bạn chưa cần chọn engine ngay từ đầu.
B.Làm việc theo brief thay vì đoán ý
Brief một trang giữ lại lời mô tả của bạn, phong cách hình ảnh, phút chơi đầu tiên, thử thách, tính năng cần có và phần để sau. Điều này giúp bạn phát hiện sớm game đang đi lệch ý tưởng trước khi viết quá nhiều code.
Trong quá trình kiểm tra, từng dòng trong brief được đánh dấu là đã làm, còn thiếu, bị lỗi hoặc chưa thể đánh giá. Bạn có thể biết rõ Claude Code đã hoàn thành phần nào và phần nào vẫn cần tự chơi thử.
C.Tự kiểm tra prototype bằng trình duyệt
Prototype được kiểm tra bằng một số phím bấm theo kịch bản trong trình duyệt headless. Hệ thống kiểm tra game có mở được không, có lỗi hay không, có phản hồi với thao tác không, chữ có quá nhỏ không, giao diện có bị chồng lên nhau hoặc nằm ngoài màn hình không.
Nếu một màn hình bị treo hoặc có lỗi hiển thị, framework cố gắng sửa trong cùng một vòng. Handover card ghi lại kết quả và kết thúc bằng trạng thái Not yet played by a person, nhắc bạn rằng kiểm thử tự động chưa thay thế được việc con người chơi thật.
D.Thay đổi game từng bước có checkpoint
Sau prototype đầu tiên, bạn có thể yêu cầu Claude Code chỉnh game. Mỗi thay đổi được đối chiếu với những điều bạn muốn giữ lại và muốn tránh. Thay đổi được chấp nhận trở thành một checkpoint để bạn quay lại khi cần.
Khi yêu cầu tinh chỉnh, game có thể được bổ sung tweak panel với slider cho từng giá trị. Cách này hữu ích khi bạn muốn thử tốc độ nhân vật, độ khó hoặc nhịp chơi mà không phải sửa trực tiếp nhiều file.
E.Phát triển prototype thành web project
Khi prototype ổn, bạn có thể phát triển thành project web dùng Vite và TypeScript. Giá trị được đưa vào data file, có test và quy trình build. Bạn thêm từng feature trong mỗi lần làm việc; hệ thống xây dựng, kiểm tra và commit feature đó.
Sau mỗi feature, cùng một lượt chạy có seed được chơi lại để phát hiện thay đổi ngoài ý muốn. Các workflow về story như /create-stories, /dev-story và /story-done chỉ được dùng khi bạn yêu cầu.
F.Hỗ trợ nhiều hướng engine
Repo có đường đi cho Web, Godot 4, Unity và Unreal Engine 5. Web là lựa chọn mặc định cho project mới. Godot dùng GDScript, C# hoặc GDExtension; Unity dùng thư mục Assets/; Unreal dùng C++ và Blueprints trong Source/<Module>/.
Lệnh /setup-engine ghim phiên bản engine và tạo tài liệu tham chiếu trong docs/engine-reference/<engine>/. Nếu chưa chọn engine, bạn có thể làm prototype trên trình duyệt trước rồi mới quyết định.
G.Điều chỉnh mức độ chặt của quy trình
File project.yaml là nguồn cấu hình chính. Thiết lập modes.rigor có ba mức minimal, standard và full, quyết định độ sâu của tài liệu, QA, review và quy mô team AI.
Mức minimal là mặc định, phù hợp để bắt đầu nhanh. Mức standard yêu cầu năm phần GDD và kiểm tra cân bằng hơn. Mức full yêu cầu đầy đủ tám phần GDD, bằng chứng QA chi tiết và review đầy đủ. Bạn có thể nâng mức khi project lớn dần.
H.Kiểm thử chính framework
Thư mục studio-tests/ kiểm tra chính các skill và agent của framework, không kiểm tra game của bạn. Bạn có thể dùng /skill-test static [name] để chạy linter cấu trúc, /skill-test category [name] để kiểm tra theo rubric, /skill-test spec [name] để chạy các assertion hành vi và /skill-test audit để xem độ bao phủ.
II.Cần chuẩn bị gì
Bạn cần Git để clone repo và quản lý các checkpoint. Bạn cũng cần Claude Code. README khuyến nghị native installer; cách cài qua npm là npm install -g @anthropic-ai/claude-code và cần Node.js 22 trở lên.
Python 3 được dùng để đọc project.yaml cho mọi skill và hook. Nếu thiếu Python, nhiều thiết lập sẽ âm thầm quay về giá trị mặc định. Có một ngoại lệ rõ ràng: commit có staging data JSON sẽ bị chặn nếu không có Python để kiểm tra.
Bạn cần Bash vì mọi hook đều chạy bằng Bash. Trên macOS và Linux, Bash thường có sẵn. Trên Windows, README ghi Bash đi kèm Git for Windows. Nếu thiếu Bash trên Windows, hook sẽ tự bỏ qua và lúc bắt đầu session sẽ báo các bước kiểm tra đang tắt.
Bạn cần Chrome, Edge hoặc Chromium để /prototype mở và chụp ảnh game. Nếu không có trình duyệt phù hợp, phần kiểm tra đó được đánh dấu là chưa đánh giá.
Node.js là thành phần được khuyến nghị khi bạn muốn phát triển game thành web project, dùng three.js cho game 3D hoặc chạy build và test của web engine. jq cũng được khuyến nghị cho việc kiểm tra hook. Hai công cụ này là tùy chọn theo README.
README không nói cần API key riêng, GPU hay tài khoản dịch vụ bên ngoài. Vì vậy, không nên tự thêm các biến môi trường hoặc key chưa được repo yêu cầu.
III.Cài đặt từng bước
- Chuẩn bị công cụCài Git, Claude Code, Python 3, Bash và trình duyệt Chromium
- Clone templateTải repo về và đặt tên thư mục project game
- Mở đúng thư mụcKhởi động Claude Code tại thư mục có CLAUDE.md và project.yaml
- Chạy workflow đầu tiênDùng /prototype hoặc /start để bắt đầu
- Chọn engine khi cầnDùng /setup-engine nếu muốn Godot, Unity, Unreal hoặc Web
A.Chuẩn bị môi trường
Cài Git, Claude Code, Python 3 và Git for Windows nếu bạn dùng Windows. Với Claude Code, README ghi native installer là lựa chọn được khuyến nghị. Nếu dùng npm, Node.js phải từ phiên bản 22 trở lên.
Sau đó kiểm tra bạn có một trình duyệt Chrome, Edge hoặc Chromium. Trình duyệt này không chỉ để xem game mà còn được /prototype dùng để chạy các lượt kiểm tra và chụp ảnh.
Nếu bạn dùng Windows, hãy mở Git Bash hoặc một môi trường có Bash để các hook của repo hoạt động. Mở PowerShell bình thường nhưng thiếu Bash có thể khiến hook tự bỏ qua.
B.Clone repo thành project riêng
Mở terminal tại thư mục bạn muốn lưu project, rồi chạy đúng các lệnh sau:
git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-gameLệnh đầu tải template về thư mục my-game. Lệnh thứ hai chuyển terminal vào thư mục đó. Bạn có thể đổi my-game thành tên project khác, nhưng nên dùng tên không có khoảng trắng để tránh lỗi khi chạy lệnh.
Sau khi clone, thư mục gốc phải có CLAUDE.md và project.yaml. Đây là dấu hiệu bạn đang đứng ở đúng cấp thư mục.
C.Mở Claude Code ở thư mục gốc
Từ chính thư mục chứa CLAUDE.md và project.yaml, chạy:
claudeĐiểm này rất quan trọng. Nếu bạn chạy Claude Code trong thư mục con như src/, các hook, quy tắc deny và chế độ hỏi trước của project sẽ không được áp dụng đầy đủ. Người mới thường mở terminal ngay trong thư mục mã nguồn rồi thắc mắc vì sao workflow không hoạt động đúng.
D.Tạo game đầu tiên bằng prototype
Trong session Claude Code, nhập ý tưởng theo mẫu README:
/prototype a fishing game where the rare fish only bite at duskBạn cũng có thể bắt đầu bằng:
/start/prototype đi thẳng vào workflow tạo prototype. /start hỏi bạn đang ở trạng thái nào, chẳng hạn muốn làm game mới, mới có ý tưởng, đã có thiết kế rõ hoặc đã có project. Hãy trả lời các câu hỏi, đọc file design/game-brief.md, rồi xác nhận trước khi build.
E.Chọn engine khi project đã rõ hướng
Nếu bạn biết trước muốn dùng engine nào, chạy lệnh tương ứng:
/setup-engine godot 4.7Nếu chưa chắc, hãy làm prototype Web trước. README nói đây là cách mặc định cho project mới, sau đó bạn có thể chọn engine khi đã chơi thử và hiểu game hơn.
Bạn có thể dùng các lệnh định hướng khác:
/next-step
/brainstorm
/project-stage-detect/next-step đề xuất bước tiếp theo. /brainstorm giúp khám phá ý tưởng game. /project-stage-detect phân tích project đang có để xác định giai đoạn.
F.Xem và thay đổi cấu hình
Dùng /project-settings để xem hoặc đổi cấu hình:
/project-settings # view effective config
/project-settings modes.review_mode # view one setting
/project-settings modes.rigor=full # write to project.yaml (team-wide)
/project-settings --local modes.review_mode=solo # write to project.local.yaml (just you)Các lệnh này có comment tiếng Anh trong README để mô tả mục đích. Lệnh đầu xem cấu hình hiệu lực. Lệnh thứ hai xem riêng một thiết lập. Lệnh thứ ba ghi mức review vào project.yaml cho cả team. Lệnh cuối ghi thiết lập cục bộ vào project.local.yaml cho riêng bạn.
Claude Code có thể tạo hoặc chỉnh sửa file trong project. Hãy đọc brief và kết quả kiểm tra trước khi chấp nhận thay đổi. Không đưa API key, mật khẩu hoặc dữ liệu riêng tư vào prompt nếu repo chưa nói rõ cách bảo vệ chúng.
IV.Kiểm tra đã chạy được chưa
Sau khi chạy /prototype, Claude Code cần hỏi bạn một vòng câu hỏi rồi tạo design/game-brief.md. Mở file này và kiểm tra ý tưởng, phong cách, phút chơi đầu tiên, thử thách và danh sách tính năng có đúng ý bạn không.
Khi build xong, prototype phải nằm trong prototypes/<name>/ và có thể mở bằng double-click theo mô tả của README. Bạn kiểm tra game có hiện lên trong trình duyệt, có phản hồi với thao tác và không bị treo.
Kết quả kiểm tra tự động cần cho biết game mở không lỗi, phản hồi với các phím được kịch bản gửi, chữ không quá nhỏ, thành phần không chồng lấn hoặc nằm ngoài màn hình. Handover card sẽ nêu phần nào đã đạt, phần nào còn lỗi, phần nào được đoán và phần nào không thể kiểm tra.
Nếu bạn thấy dòng Not yet played by a person, đó không phải lỗi cài đặt. Nó có nghĩa là lượt chơi tự động đã hoàn tất nhưng bạn vẫn cần tự chơi để đánh giá cảm giác và chất lượng game.
V.Dùng vào việc thật
A.Chủ shop thử game quảng bá sản phẩm
Một chủ shop có thể bắt đầu bằng ý tưởng ngắn như /prototype a cozy fishing game where rare fish appear at dusk. Claude Code sẽ hỏi về cảm giác chơi, hình ảnh và độ khó, sau đó tạo một prototype browser để bạn mở và chơi.
Bạn có thể yêu cầu sửa tiếp, chẳng hạn thêm mục tiêu thu thập cá hoặc thay đổi thời điểm xuất hiện cá hiếm. Mỗi lần chỉnh được kiểm tra lại và trở thành checkpoint nếu bạn chấp nhận.
B.Nhân viên văn phòng làm game nhỏ ngoài giờ
Một người mới chưa biết chọn Unity hay Godot có thể dùng /start, trả lời rằng mình có ý tưởng nhưng chưa có project, rồi dùng /prototype. Cách này giúp bắt đầu bằng game web đơn giản thay vì phải học toàn bộ engine trước.
Khi bản chơi thử có hướng rõ, bạn dùng /setup-engine web hoặc chọn engine khác. Với web engine, repo có thể tạo starter không dùng thư viện thêm hoặc dùng three.js, Phaser hay PixiJS theo lựa chọn được README liệt kê.
C.Lập trình viên phát triển prototype thành sản phẩm web
Khi prototype đã ổn, lập trình viên có thể yêu cầu phát triển thành project Vite và TypeScript. Các giá trị game được đưa vào data file, đồng thời bổ sung test và build.
Mỗi lần làm feature, bạn mô tả feature tiếp theo. Claude Code xây dựng, kiểm tra, commit và chạy lại lượt chơi có seed để cho thấy thay đổi. Đây là cách phù hợp khi muốn phát triển từng phần thay vì viết một project lớn ngay từ đầu.
D.Nhóm indie dùng Godot, Unity hoặc Unreal
Nếu nhóm đã có công nghệ, dùng /setup-engine godot 4.7 hoặc thiết lập engine phù hợp. Repo có bảng quy ước code root: Godot dùng src/, Unity dùng Assets/, còn Unreal dùng Source/<Module>/.
Sau đó nhóm có thể dùng project.yaml để thống nhất mức rigor, quy tắc đặt tên, workflow và thư mục. Thành viên riêng lẻ có thể ghi đè review_mode hoặc team.size trong project.local.yaml mà không sửa cấu hình chung.
Một ý tưởng game tốt cần được biến thành một lượt chơi có thể kiểm tra, không chỉ là một bản mô tả.
Ông T
VI.Lỗi hay gặp và cách xử lý
A.Chạy Claude Code trong thư mục con
Nếu bạn mở Claude Code trong src/ hoặc một thư mục con, repo có thể bỏ qua hook, quy tắc deny và chế độ hỏi trước. Hãy thoát session, chuyển về thư mục chứa CLAUDE.md và project.yaml, rồi chạy lại claude.
B.Windows không chạy hook
Nguyên nhân thường là thiếu Bash. README ghi Bash đi cùng Git for Windows trên Windows. Cài hoặc mở môi trường Bash phù hợp rồi khởi động lại session. Nếu vẫn thiếu Bash, hook có thể tự bỏ qua và session start sẽ báo phần kiểm tra đang tắt.
C.Không có Python 3
Khi thiếu Python 3, các thiết lập trong project.yaml có thể âm thầm quay về mặc định. Cài Python 3 rồi chạy lại workflow. Đặc biệt, commit có staging data JSON sẽ bị chặn khi không có Python để validate.
D.Prototype không được đánh giá bằng trình duyệt
Nếu không có Chrome, Edge hoặc Chromium, phần chạy và chụp ảnh trong /prototype sẽ được đánh dấu chưa đánh giá. Hãy cài một trình duyệt trong ba lựa chọn này rồi chạy lại bước kiểm tra.
E.Tự sửa sai cấu hình hoặc chọn mức rigor quá cao
project.yaml là nguồn cấu hình chính và có nhiều nhóm thiết lập. Người mới nên giữ mức minimal mặc định cho project nhỏ. Khi project lớn hơn, dùng /project-settings để xem cấu hình trước khi đổi; nếu chỉ muốn thử riêng, dùng tùy chọn --local để ghi vào project.local.yaml.
VII.Có nên dùng không
Bạn nên dùng Claude-Code-Game-Studios nếu muốn biến ý tưởng game thành prototype nhanh, cần một quy trình có brief và QA, hoặc muốn Claude Code hỗ trợ theo vai trò giống một studio. Repo cũng phù hợp với nhóm indie muốn có cấu trúc thư mục, hook, agent, skill và quy tắc làm việc sẵn.
Điểm mạnh là workflow khá đầy đủ: hỏi ý tưởng, viết brief, tạo game, kiểm tra bằng trình duyệt, chỉnh sửa có checkpoint, phát triển thành web project và hỗ trợ nhiều engine. Cấu hình modes.rigor giúp bạn chọn mức quy trình phù hợp với project. Repo cũng có các công cụ tự kiểm tra skill và agent của chính framework.
Giới hạn cần nhớ là đây không phải công cụ chứng minh game đã hay. README nói kết quả ban đầu được đánh giá trên số lượng thử nghiệm hạn chế; khả năng phát triển game chỉ mới được chứng minh qua một game, còn engine route và việc đào sâu một hệ thống chưa có bài kiểm tra tương tự. Game tạo ra cũng không nằm trong repo mẫu, nên bạn vẫn phải tự chơi, tự đánh giá và tự hoàn thiện.
Nếu bạn chỉ cần một thư viện game, một engine nhẹ hoặc muốn tự viết toàn bộ code mà không dùng quy trình AI, repo này có thể hơi nặng. Nếu bạn cần một người cộng tác AI có cấu trúc để đi từ ý tưởng đến bản chơi được, đây là lựa chọn đáng thử. Giấy phép MIT cũng cho phép bạn xem, chỉnh sửa và dùng template theo phạm vi giấy phép.
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. README được cung cấp không nói chi tiết về chi phí sử dụng Claude Code hoặc các công cụ bên ngoài, nên phần đó cần kiểm tra theo dịch vụ tương ứng.
Có cần GPU để chạy không?
Tư liệu không yêu cầu GPU. Repo cần Claude Code, Git, Python 3, Bash và Chrome, Edge hoặc Chromium cho workflow prototype.
Có chạy được trên Windows không?
Có thể chạy trên Windows nếu có Bash; README ghi Bash đi kèm Git for Windows. Nếu thiếu Bash, các hook sẽ tự bỏ qua và phần kiểm tra sẽ bị tắt.
Có cần API key riêng không?
README không nêu API key hay biến môi trường bắt buộc. Tư liệu chỉ yêu cầu Claude Code và các công cụ hệ thống được liệt kê.
Có cần cài Unity, Godot hoặc Unreal ngay từ đầu không?
Không cần nếu bạn bắt đầu bằng prototype Web. Bạn có thể làm game trình duyệt trước rồi dùng `/setup-engine` khi đã chọn Godot, Unity hoặc Unreal.
Prototype có được kiểm thử hoàn toàn tự động không?
Repo dùng phím bấm theo kịch bản trong trình duyệt headless để kiểm tra mở game, lỗi, phản hồi và một số vấn đề giao diện. README vẫn ghi rõ kết quả chưa được chơi bởi con người, nên bạn cần tự chơi trước khi xem là hoàn thành.
Repo có chứa sẵn game hoàn chỉnh không?
Không. Đây là template để clone và bắt đầu project riêng; các game được tạo ra không được đóng sẵn trong repo.


