Bỏ qua tới nội dung
Ông T.vn

Claude-Code-Game-Studios: tạo game từ một câu mô tả — hướng dẫn cài đặt và dùng

12 phút đọcCập nhật

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 →

Claude-Code-Game-Studios: tạo game từ một câu mô tả — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

Claude-Code-Game-Studios là một repo mẫu (template) cho Claude Code, gồm 49 agent AI và hơn 70 skill để làm game từ ý tưởng đến bản hoàn thiện. Bạn gõ /prototype kèm ý tưởng, nó hỏi vài câu, viết brief và dựng game chạy trên trình duyệt. Cài không khó: clone repo, mở Claude Code ở thư mục gốc, nhưng cần sẵn Git, Claude Code, Python 3 và Bash.

Claude-Code-Game-Studios là một repo mẫu (template) giúp Claude Code làm việc như một xưởng làm game nhỏ. Bên trong có 49 agent AI và hơn 70 skill (lệnh làm sẵn) được tổ chức theo kiểu một studio thật. Bạn không cần viết code từ đầu. Bạn mô tả game bằng lời, và nó dựng ra một game chơi được trên trình duyệt.

Repo này hợp với người chưa biết lập trình mà có ý tưởng game, chủ nhỏ muốn thử một mini game, và lập trình viên indie muốn có quy trình làm game có sẵn. Hiện repo có khoảng 38.752 sao và 5.037 fork, giấy phép MIT, và vẫn được cập nhật trong 3 tháng gần đây.

Điểm đáng giá nhất là bạn có thể đi từng bước. Gõ một câu, nhận game đầu tiên chơi được. Rồi bạn sửa, mở rộng, và nếu muốn thì chuyển sang Godot, Unity hoặc Unreal. Bạn không phải học cả hệ thống trước khi bắt đầu.

Framework

Donchitos/Claude-Code-Game-Studios

Mẫu dự án 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ơi được trên trình duyệt.

★ 39kShellMIT
Xem repo trên GitHub

I.Claude-Code-Game-Studios làm được gì

Theo README, luồng chính của repo như sau. Mình giải thích theo lợi ích để bạn dễ hình dung.

A.Từ một câu thành game chơi được

Bạn gõ /prototype kèm ý tưởng. Claude hỏi một vòng câu hỏi ngắn, chọn theo thể loại game: lựa chọn định hình game, cảm giác chơi, hình thức, độ khó, mục tiêu. Mỗi câu đều có đáp án thông dụng, nên bạn có thể trả lời 'bạn chọn đi'. Nếu ý tưởng quá mơ hồ (ví dụ 'một game đua xe'), nó đưa ra hai ba câu giới thiệu một dòng để bạn chọn trước.

B.Bản brief một trang

Các câu trả lời được viết thành file design/game-brief.md. File này giữ nguyên lời bạn gõ, rồi ghi thêm hình thức, phút đầu tiên của game, thử thách, tính năng và những gì để dành sau. Bạn đọc, rồi nói 'Build it' hoặc yêu cầu sửa trước. Bước này giúp bạn không phải nhận một game lệch ý.

C.Bản dựng đầu tiên, có kiểm tra

Game nằm trong prototypes/<tên>/ và mở bằng cách bấm đúp. README nói mọi hình đều được vẽ, không dùng emoji làm hình, không sao chép game khác và không dễ quá mức. Trước khi giao, repo chạy thử vài phím trong trình duyệt không giao diện (headless), chụp màn hình để bắt lỗi chữ quá nhỏ, chồng nhau, tràn màn hình hoặc màn hình đứng. Từng dòng của brief được đánh dấu là đã làm, thiếu, hỏng hoặc không đánh giá được. Cuối cùng là một thẻ bàn giao nói rõ cái gì đạt, cái gì còn hỏng, cái gì là đoán, và kết bằng 'Not yet played by a person'. Tức là việc chơi thử thật vẫn là của bạn.

D.Sửa, chia sẻ, mở rộng, hoàn thiện

  • Sửa bằng cách nhờ. Mỗi thay đổi được đối chiếu với những gì bạn dặn giữ và tránh. Mỗi thay đổi bạn chấp nhận là một điểm quay lại được. Nếu nhờ chỉnh thông số, game có thêm bảng tweak với thanh trượt cho từng giá trị.
  • Chia sẻ. Tạo một bản sạch, không có bảng chỉnh và file làm việc, sẵn sàng đưa lên itch.io hoặc gửi link.
  • Mở rộng. Khi ưa game, nó thành một dự án web thật (Vite và TypeScript, giá trị nằm trong file dữ liệu, có test và build). Mỗi lần bạn thêm một tính năng, 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 và mọi thay đổi được báo cho bạn.
  • Hoàn thiện. Lệnh /cut đề xuất cái nên cắt, danh sách việc đánh bóng, và một mốc ngày nếu bạn định bán game.

E.Hỗ trợ nhiều engine

Mặc định là Web. Ngoài ra có Godot 4 (GDScript, C# hoặc GDExtension), Unity và Unreal Engine 5 (C++ và Blueprints). Nếu chưa chọn engine, /prototype sẽ dựng trên trình duyệt trước, và bạn chọn engine sau khi đã chơi thử.

F.Mức độ quy trình chỉnh được

File project.yaml có mục modes.rigor với ba mức: minimal (mặc định, nhẹ nhất), standard và full. Dự án nhỏ cứ để mặc định. Khi dự án lớn hơn, bạn nâng mức bằng một lệnh /project-settings.

G.Móc kiểm tra và quy tắc an toàn

Repo có các hook (script chạy tự động) kiểm tra commit, push, ghi file, file JSON dữ liệu. README ghi rằng nếu thiếu công cụ phụ thì hook thường chỉ bỏ qua phần kiểm tra. Có một ngoại lệ: commit có file JSON dữ liệu sẽ bị chặn nếu máy không có Python để kiểm tra.

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 bộ cài gốc. Cách npm install -g @anthropic-ai/claude-code cũng chạy được, trên Node.js 22 trở lên. Bạn cũng cần tài khoản dùng được Claude Code (README không nói chi tiết loại gói nào).
  • Python 3. Mọi skill và hook dùng nó để đọc project.yaml. Thiếu Python thì các cài đặt lặng lẽ quay về giá trị mặc định.
  • Bash. Dùng để chạy hook. 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à phần kiểm tra đang tắt.
  • Chrome, Edge hoặc Chromium. /prototype dùng trình duyệt này để chơi thử và chụp màn hình. Không có thì các kiểm tra đó ghi là 'không đánh giá được'.
  • Nên có: Node.js (để mở rộng game thành dự án web, cho game 3D dùng three.js, và cho build/test của engine web) và jq (để kiểm tra hook).

README không nói gì về yêu cầu GPU hay dung lượng ổ đĩa, nên mình không đưa ra con số nào.

Claude Code chạy trên tài khoản của bạn nên mỗi lần dựng game sẽ dùng hạn mức hoặc tốn chi phí theo gói bạn đang dùng. README cho biết bạn có thể nhờ dựng 'ở mức medium' để rẻ hơn nhưng bản dựng sẽ mỏng hơn. Hãy kiểm tra gói của bạn trước khi dựng game lớn.

III.Cài đặt từng bước

  1. Cài công cụCó Git, Claude Code, Python 3, Bash và một trình duyệt Chrome/Edge/Chromium
  2. Tải repo vềClone repo về thành thư mục game của bạn rồi cd vào
  3. Mở Claude CodeChạy claude ngay tại thư mục gốc, nơi có CLAUDE.md và project.yaml
  4. 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

Bạn cài Git, Claude Code, Python 3 và (trên Windows) Git for Windows để có Bash. README chỉ dẫn tới các trang chính thức của từng công cụ. Nếu dùng npm để cài Claude Code, lệnh trong README là:

Terminal
npm install -g @anthropic-ai/claude-code

Lệnh này cần Node.js 22 trở lên. Nếu bạn dùng bộ cài gốc của Claude Code thì không cần lệnh này. Hãy theo hướng dẫn trên trang cài đặt Claude Code mà README liên kết tới.

B.Tải repo về

Mở terminal (trên Windows có thể dùng Git Bash hoặc PowerShell) tại nơi bạn muốn đặt thư mục game, rồi chạy:

Terminal
git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-game

Lệnh đầu tải repo về và đặt tên thư mục là my-game. Bạn đổi tên này thành tên game của mình cũng được. Lệnh thứ hai đưa terminal vào thư mục đó. README cũng nói bạn có thể dùng repo như một template, tức là tạo bản sao riêng của mình trên GitHub rồi tải về.

C.Mở Claude Code ở thư mục gốc

Terminal
claude

Đây là chỗ người mới hay vấp nhất. Bạn phải chạy lệnh này ở thư mục gốc, nơi có CLAUDE.md và project.yaml. README cảnh báo rằng nếu mở trong thư mục con như src/ thì hook, quy tắc chặn và chế độ hỏi trước của dự án sẽ không được áp dụng.

D.Bắt đầu bằng /prototype hoặc /start

Trong phiên Claude Code, bạn có hai cách vào. Nếu đã có ý tưởng, gõ thẳng:

Code
/prototype a fishing game where the rare fish only bite at dusk

Đây là ví dụ nguyên văn của README (câu bằng tiếng Anh). Bạn có thể thử gõ ý tưởng bằng tiếng Việt, nhưng README chưa nói rõ về ngôn ngữ, nên nếu kết quả lạ thì thử lại bằng tiếng Anh.

Nếu chưa chắc nên làm gì, gõ /start. Lệnh này hỏi bạn đang ở đâu: muốn làm một game, đã có ý tưởng hay chưa, có thiết kế rõ ràng, hay đã có công việc sẵn. Rồi nó dẫn bạn đến quy trình phù hợp. Các cửa vào khác theo README:

Code
/next-step
/brainstorm
/setup-engine godot 4.7
/project-stage-detect
  • /next-step chỉ ra đúng một bước tiếp theo, bạn đang ở đâu cũng được.
  • /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 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

README không có một lệnh kiểm tra cài đặt riêng, nên mình dựa vào những gì nó mô tả:

  • Khi mở phiên, hook session-start.sh hiện nhánh git hiện tại và các commit gần đây. Với dự án mới, detect-gaps.sh gợi ý bạn chạy /start. Thấy các thông tin này là hook đang chạy.
  • Nếu trên Windows thiếu Bash, phiên mở ra sẽ báo rằng các kiểm tra của hook đang tắt. Đó là dấu hiệu cần cài Git for Windows.
  • Gõ /start hoặc /next-step và nhận được câu hỏi hay gợi ý là skill đang hoạt động.
  • Sau /prototype, bạn sẽ có file design/game-brief.md và thư mục prototypes/<tên>/. Mở file HTML trong thư mục đó bằng cách bấm đúp, game mở ra trong trình duyệt là cài đặt đã thành công.

Nếu có thể, hãy xem thẻ bàn giao cuối cùng. Phần 'passed', 'still broken' và 'guessed' cho bạn biết game nào đáng tin tới đâu.

V.Dùng vào việc thật

A.Chủ shop muốn một mini game cho chiến dịch khuyến mãi

Bạn có một cửa hàng nhỏ và muốn một game đơn giản để khách chơi trên điện thoại. Bạn mở claude trong thư mục dự án và gõ ví dụ:

Code
/prototype a catch-the-falling-items game for my coffee shop

Claude hỏi một vòng câu hỏi. Bạn trả lời nhanh hoặc nói 'you pick'. Sau đó bạn đọc design/game-brief.md, thấy ổn thì nói 'Build it'. Kết quả là một game trong prototypes/ mở bằng bấm đúp. Khi đã ưng, bạn nhờ tạo bản chia sẻ sạch, không có bảng chỉnh và file làm việc, để đưa lên itch.io hoặc gửi link, đúng như README mô tả.

B.Nhân viên văn phòng thử ý tưởng cho team

Bạn không biết code nhưng muốn minh họa một ý tưởng bằng game cho buổi họp. Nếu ý tưởng còn mơ hồ, chỉ cần gõ /prototype a racing game. Repo sẽ đưa hai ba câu giới thiệu một dòng để bạn chọn hướng trước. Sau khi có bản đầu, bạn nhờ sửa bằng lời. README nói mỗi thay đổi được đối chiếu với những gì bạn dặn giữ hoặc tránh, và mỗi thay đổi bạn nhận là một điểm quay lại được. Vì thế bạn thử bạo tay cũng không sợ mất bản cũ.

Thử trước, quyết sau: chơi được một bản chạy thật rẻ hơn viết thêm mười trang kế hoạch.

Ông T

C.Lập trình viên mới muốn lớn dần một game

Bạn đã có bản prototype và thấy ưng. Khi bạn nói muốn mở rộng, README cho biết game trở thành dự án web thật (Vite và TypeScript, giá trị nằm trong file dữ liệu, có test và build). Từ đó mỗi lần bạn nêu một tính năng kế tiếp, nó được dựng, kiểm tra và commit. Sau mỗi tính năng, cùng một lượt chơi có hạt giống cố định được chạy lại và mọi thay đổi được hiển thị. Bạn học được cách một dự án web được tổ chức mà không phải tự dựng khung. Nếu muốn quy trình theo câu chuyện, README ghi các lệnh /create-stories, /dev-story và /story-done chỉ dùng khi bạn yêu cầu.

D.Dev indie chuyển sang Godot hoặc Unity

Sau khi chơi bản trình duyệt, bạn quyết định làm tiếp bằng engine. Bạn chạy lệnh cấu hình, ví dụ:

Code
/setup-engine godot 4.7

Lệnh này ghim phiên bản engine và viết tài liệu tham chiếu vào docs/engine-reference/<engine>/. Thư mục code khác nhau theo engine: src/ cho Godot và Web, Assets/ cho Unity, Source/<Module>/ cho Unreal. Lưu ý trung thực: README nói đường engine này đã được xây và qua kiểm tra của chính framework, nhưng chưa được thử nghiệm kiểu như đường prototype trên web. Hãy coi đây là phần còn mới.

VI.Lỗi hay gặp và cách xử lý

A.Hook không chạy hoặc báo kiểm tra đang tắt trên Windows

Nguyên nhân thường là máy chưa có Bash. README nói trên Windows Bash đi kèm Git for Windows. Cài Git for Windows, mở lại terminal rồi chạy claude lại.

B.Thiết lập dường như không được áp dụng

Có thể bạn mở Claude Code ở sai thư mục, ví dụ trong src/. README cảnh báo như vậy sẽ bỏ qua hook, quy tắc chặn và chế độ hỏi trước. Thoát ra, cd về thư mục gốc (nơi có CLAUDE.md và project.yaml) rồi chạy claude lại.

C.Cài đặt bị lặng lẽ về mặc định

Thiếu Python 3 thì skill và hook không đọc được project.yaml và mọi cài đặt quay về mặc định mà không báo lỗi to. Cài Python 3 rồi mở lại phiên. Cũng vì thế, commit có file JSON dữ liệu sẽ bị chặn khi không có Python. Đó là chủ ý của repo, không phải lỗi.

D.Các kiểm tra ghi 'không đánh giá được'

Nếu máy không có Chrome, Edge hoặc Chromium, bước chơi thử và chụp màn hình không chạy được. Cài một trong ba trình duyệt này và chạy lại. Trong lúc chưa cài, bạn vẫn phải tự chơi game để biết nó có ổn không.

E.Game dựng ra mỏng hoặc chưa như ý

README nói phiên của bạn dựng ở mức nỗ lực của chính nó, và dựng 'ở mức medium' thì rẻ hơn nhưng mỏng hơn. Nếu kết quả sơ sài, hãy nhờ sửa từng điểm cụ thể, vì mỗi thay đổi được kiểm tra theo những gì bạn dặn giữ hoặc tránh. Và hãy tự chơi, vì thẻ bàn giao luôn nhắc rằng chưa có người nào chơi.

VII.Có nên dùng không

Điểm mạnh. Bạn đi từ một câu đến một game chơi được mà không phải dựng gì trước. Quy trình có kiểm tra tự động, thẻ bàn giao trung thực, điểm quay lại sau mỗi thay đổi, và đường lên engine thật khi cần. Mức quy trình mặc định minimal nhẹ, phù hợp người mới. Giấy phép MIT cho bạn nhiều tự do.

Giới hạn. README nói thẳng các bằng chứng còn mỏng. Trong so sánh mù trên ba ý tưởng game, brief từ bộ câu hỏi được chọn hơn brief viết tay cả ba lần, nhưng về chất lượng game thì hai bên hòa. Việc mở rộng một game qua sáu câu chuyện chỉ là một trường hợp, chưa phải quy luật. Đường engine (Godot, Unity, Unreal) và việc đào sâu một hệ thống bằng tài liệu thiết kế chưa được thử như vậy. Repo cũng không kèm game mẫu nào, vì nó là template để bạn bắt đầu dự án của riêng mình.

Khi nào chọn cách khác. Nếu bạn chỉ muốn một game rất đơn giản mà không dùng Claude Code, repo này không phải lựa chọn nhẹ nhất vì bạn cần tài khoản và công cụ đi kèm. Nếu bạn cần game thương mại lớn với đồ họa phức tạp, hãy xem bản dựng AI là bản thử ý tưởng chứ không phải sản phẩm cuối, và chuẩn bị làm tiếp bằng engine cùng đội ngũ thật. Còn nếu bạn mới làm quen, cứ bắt đầu bằng /prototype với một ý tưởng nhỏ, chơi thử, rồi quyết định có đi tiếp hay không.

4.3/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

Claude-Code-Game-Studios 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 trên Claude Code, và README không nói về chi phí của Claude Code. Bạn cần xem gói tài khoản của mình để biết hạn mức hoặc phí.

Tôi có cần biết lập trình để dùng không?

Để làm bản prototype đầ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. Muốn mở rộng game thành dự án web hoặc dùng engine thì sẽ cần hiểu thêm, và README có hướng dẫn quy trình từng tính năng một.

Chạy được trên Windows không?

Được, nhưng cần Bash để chạy hook. README nói trên Windows Bash đi kèm Git for Windows. Nếu thiếu, các hook tự bỏ qua và phiên mở ra sẽ báo phần kiểm tra đang tắt.

Có cần máy có GPU không?

README không nhắc yêu cầu GPU hay cấu hình phần cứng. Repo chỉ yêu cầu các công cụ như Git, Claude Code, Python 3, Bash và một trình duyệt Chrome, Edge hoặc Chromium. Chưa có thông tin gì thêm về phần cứng.

Repo hỗ trợ những engine nào?

Mặc định là Web (có thể thêm three.js, Phaser hoặc PixiJS). Ngoài ra có Godot 4, Unity và Unreal Engine 5. README cho biết đường engine đã được xây và qua kiểm tra của chính framework, nhưng chưa được thử nghiệm kỹ như đường prototype trên web.

Game tôi làm ra có dùng ngay được không?

Bản dựng đầu là một game trình duyệt mở bằng bấm đúp, đã qua kiểm tra tự động. Nhưng thẻ bàn giao luôn ghi 'Not yet played by a person', nên bạn cần tự chơi để xác nhận. README không hứa game sẵn sàng để bán ngay.

Nếu đã có game trên trình duyệt thì sao?

README nói bạn có thể dùng lệnh /prototype với tùy chọn --from kèm đường dẫn game để đưa một bản sao vào nguyên trạng, rồi sửa và mở rộng như bình thường. Phần đường dẫn trong tư liệu mình có bị cắt, nên hãy xem README gốc để biết cú pháp đầy đủ.

Chuyển nhanh tới mục

  1. I.Claude-Code-Game-Studios làm được gì
    1. A.Từ một câu thành game chơi được
    2. B.Bản brief một trang
    3. C.Bản dựng đầu tiên, có kiểm tra
    4. D.Sửa, chia sẻ, mở rộng, hoàn thiện
    5. E.Hỗ trợ nhiều engine
    6. F.Mức độ quy trình chỉnh được
    7. G.Móc kiểm tra và quy tắc an toàn
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cài các công cụ nền
    2. B.Tải repo về
    3. C.Mở Claude Code ở thư mục gốc
    4. D.Bắt đầu bằng /prototype hoặc /start
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop muốn một mini game cho chiến dịch khuyến mãi
    2. B.Nhân viên văn phòng thử ý tưởng cho team
    3. C.Lập trình viên mới muốn lớn dần một game
    4. D.Dev indie chuyển sang Godot hoặc Unity
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Hook không chạy hoặc báo kiểm tra đang tắt trên Windows
    2. B.Thiết lập dường như không được áp dụng
    3. C.Cài đặt bị lặng lẽ về mặc định
    4. D.Các kiểm tra ghi 'không đánh giá được'
    5. E.Game dựng ra mỏng hoặc chưa như ý
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.