close

Claude Code Game Studios

Mã nguồn mở bởi Donchitos

AI mã nguồn mở

Claude Code Game Studios là mẫu dự án (template) cho Claude Code, dựng sẵn một "studio làm game" gồm 49 agent, 74 skill, các hook và quy tắc viết mã. Bạn clone repo làm khung cho game mới, rồi làm việc với Claude Code theo quy trình có phân vai: thiết kế, lập trình, QA, phát hành.

Claude Code Game Studios dùng để làm gì?

  • Lên ý tưởng game và viết tài liệu thiết kế (GDD) bằng các lệnh như /brainstorm, /design-system
  • Chia game thành epic, story rồi cho agent lập trình từng story với /create-stories, /dev-story
  • Kiểm tra mã và tài liệu tự động qua hook khi commit, push, sửa file dữ liệu
  • Chọn bộ agent chuyên cho Godot 4, Unity hoặc Unreal Engine 5
  • Chỉnh mức quy trình từ nhẹ (game jam) tới đầy đủ bằng một thiết lập modes.rigor

Cần biết trước khi dùng

  • Lưu ýChỉ có 1 người đóng góp: dự án phụ thuộc vào một người duy trì.
  • Lưu ýKhông tìm thấy docker-compose hay Dockerfile ở thư mục gốc: chưa thể gắn nút Deploy tự động.
  • Lưu ýTino chưa kiểm thử dự án này.

Kiểm tra tự động ngày 04/11/2026 từ dữ liệu GitHub, OSV.dev và docker-compose. Đây không phải chứng nhận bảo mật; Tino không phát triển hay bảo trì repo này.

Claude Code Game Studios là gì?

Làm game một mình với trợ lý AI thường thiếu cấu trúc: không ai nhắc viết tài liệu thiết kế, không có bước QA, mã dễ rối. Dự án này đưa cấu trúc của một studio vào phiên Claude Code. Thay vì một trợ lý chung, bạn có 49 agent chia ba tầng: giám đốc (creative-director, technical-director, producer) giữ định hướng, trưởng bộ phận phụ trách từng mảng, chuyên viên làm việc cụ thể như lập trình gameplay, thiết kế màn chơi, âm thanh.

Các agent phối hợp theo luật: giao việc từ trên xuống, tham khảo ngang hàng, bất đồng thì đẩy lên cấp trên, không sửa file ngoài phạm vi của mình. README nhấn mạnh đây không phải hệ tự lái: agent hỏi trước, đưa 2–4 phương án, bạn quyết định và duyệt trước khi ghi file. Chế độ guided, autonomous hoặc auto mode của Claude Code thì bớt các bước hỏi này.

Toàn bộ cấu hình nằm trong thư mục .claude (agent, skill, hook, rule) và file project.yaml. Thiết lập quan trọng nhất là modes.rigor: minimal (mặc định, nhanh kiểu game jam), standard hoặc full (đủ 8 mục GDD, QA đầy đủ, giám đốc duyệt mọi thứ). Tác giả tự đo và cho rằng mức nặng hơn tốn thời gian hơn mà không ra game tốt hơn, nên chọn minimal làm mặc định.

Repo không kèm game mẫu. Đây là template để bạn clone, sửa, thêm bớt agent cho phù hợp với dự án.

Nên dùng khi

  • Bạn làm game độc lập một mình hoặc nhóm nhỏ và đã dùng Claude Code
  • Bạn muốn Claude Code làm theo quy trình có tài liệu thiết kế, story và bước kiểm tra thay vì viết mã tuỳ hứng
  • Bạn dùng Godot 4, Unity hoặc Unreal Engine 5

Không nên dùng khi

  • Bạn chưa dùng Claude Code hoặc không có gói đăng ký, khoá API: mọi thứ chạy qua Claude Code
  • Bạn lo chi phí token: ba agent giám đốc yêu cầu mô hình Opus, 16 agent khác dùng Sonnet
  • Bạn chưa muốn để hook bash tự chạy trên mỗi lần agent đọc, ghi file hay chạy lệnh trong dự án
  • Dự án không phải game: phần lớn agent, rule và template viết riêng cho làm game

Tính năng chính

  • 49 agent chia ba tầng, có bộ chuyên cho Godot 4, Unity, Unreal Engine 5
  • 74 skill (lệnh gạch chéo) cho từng giai đoạn: thiết kế, kiến trúc, sprint, QA, phát hành
  • 15 hook kiểm tra commit, push, file dữ liệu JSON, tài liệu thiết kế và ghi nhật ký agent
  • 14 rule áp chuẩn viết mã theo thư mục (gameplay, core, AI, networking, UI)
  • 62 template tài liệu: GDD, UX spec, ADR, kế hoạch sprint
  • Quy định chặn force push, rm -rf và đọc file .env trong settings.json
  • Thiết lập modes.rigor (minimal, standard, full) và ghi đè riêng cho từng hệ thống
  • Bộ studio-tests để kiểm tra lại skill và agent sau khi bạn sửa

Cách cài đặt Claude Code Game Studios

  1. Chuẩn bị Cần Git, Claude Code, Python 3 và Bash (Windows dùng Bash đi kèm Git for Windows); nên có jq. README khuyên dùng trình cài native của Claude Code; lệnh npm này cũng được, cần Node.js 22+. Thiếu Python thì mọi thiết lập trong project.yaml lặng lẽ quay về mặc định. 
    npm install -g @anthropic-ai/claude-code
  2. Clone template làm dự án mới Đổi my-game thành tên dự án của bạn. Có thể dùng repo làm template trên GitHub thay vì clone. 
    git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-game
  3. Mở Claude Code ở thư mục gốc dự án Phải đứng ở thư mục chứa CLAUDE.md và project.yaml. Mở trong thư mục con như src/ sẽ bỏ qua hook, quy tắc chặn và chế độ hỏi trước. 
    claude
  4. Bắt đầu Gõ trong ô chat của Claude Code. Hệ thống hỏi bạn đang ở giai đoạn nào rồi dẫn tới quy trình phù hợp. Biết rõ engine thì có thể gõ thẳng /setup-engine godot 4.7. 
    /start

Lệnh chép từ README của dự án. Đọc kỹ trước khi chạy và đối chiếu với README mới nhất, vì lệnh có thể đổi theo phiên bản.

Cấu hình quan trọng

MụcÝ nghĩa
project.yamlCấu hình chính của studio: engine, quy ước đặt tên, khối modes (rigor, review_mode, automation…); /start tự tạo
project.local.yamlGhi đè cá nhân, nằm trong .gitignore, ví dụ review_mode hoặc team.size của riêng bạn
.claude/settings.jsonKhai báo hook, quyền tự cho phép và quy tắc chặn lệnh nguy hiểm

Cách tích hợp và sử dụng

  1. Chọn mức quy trình/start hỏi modes.rigor một lần. Xem hoặc đổi sau bằng /settings, ví dụ /settings modes.rigor=full (ghi cho cả nhóm) hoặc /settings --local modes.review_mode=solo (chỉ cho bạn).
  2. Đi theo luồng mặc địnhỞ mức minimal: /setup-engine → /brainstorm (bản tóm tắt một trang) → /create-stories → /dev-story và /story-done lặp lại.
  3. Dùng nhóm agent cho một tính năngCác lệnh /team-combat, /team-ui, /team-audio, /team-qa… điều phối nhiều agent cùng làm một phần việc.
  4. Kiểm tra trước khi phát hành/code-review, /qa-plan, /release-checklist, /launch-checklist. Story thay đổi phần người chơi thấy chỉ đóng khi game đã chạy và có ảnh chụp lưu trong production/qa/evidence/.
  5. Sau khi sửa skill hoặc agentChạy /skill-test static [tên] hoặc /skill-test audit để kiểm tra phần đã sửa vẫn đạt yêu cầu.

Cập nhật và sao lưu

Khi đã dùng bản cũ, xem UPGRADING.md trong repo: file này nêu các bước chuyển đổi và file nào ghi đè an toàn, file nào phải gộp tay. Vì là template nằm trong chính repo game của bạn, việc sao lưu đi theo Git của dự án.

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

Dùng bộ này có tốn nhiều token hơn dùng Claude Code bình thường không?

README không đưa con số. Ba agent giám đốc yêu cầu Opus, 16 agent dùng Sonnet, số còn lại dùng mô hình của phiên. Mức rigor cao hơn sinh nhiều tài liệu hơn nên tốn hơn; mặc định là minimal.

Nó có tự làm ra game hoàn chỉnh không?

Không tự lái. Agent hỏi, đưa phương án và chờ bạn duyệt trước khi ghi file. Repo cũng không kèm game mẫu, bạn tự xây game trên template này.

Có dùng được trên Windows không?

Được. README nói tác giả phát triển chủ yếu trên Windows 10 với Git Bash, có thử trên macOS và Linux. Hook thông báo notify.sh chỉ chạy trên Windows.

Giấy phép là gì, có được dùng cho game thương mại không?

Giấy phép MIT. README không nói riêng về game thương mại; MIT cho phép dùng, sửa và phân phối, chỉ cần giữ thông báo bản quyền.

Nội dung được AI hỗ trợ soạn từ README và dữ liệu GitHub của dự án.

Ứng dụng liên quan

Miễn trừ trách nhiệm

Tino không phát triển, không sở hữu và không liên kết với Claude Code Game Studios hay nhóm phát triển Donchitos. Tên, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng; việc nhắc tới chỉ để mô tả, không có nghĩa là dự án xác nhận hay hợp tác với Tino.

Claude Code Game Studios được phân phối theo giấy phép MIT của nhóm phát triển. Tino không bảo đảm về tính năng, bảo mật hay mức độ phù hợp của phần mềm; bạn tự chịu trách nhiệm khi cài đặt, cấu hình và sử dụng.

Lệnh cài và thông tin trên trang lấy từ tài liệu công khai của dự án tại thời điểm cập nhật và có thể đã thay đổi. Đọc tài liệu chính thức và sao lưu dữ liệu trước khi chạy trên máy chủ thật.