# Claude-Code-Game-Studios: biến Claude Code thành studio game — hướng dẫn cài đặt và dùng

> Claude Code Game Studios là một template biến Claude Code thành hệ thống hỗ trợ làm game theo quy trình của một studio thực tế. Bạn có thể bắt đầu bằng một ý tưởng, để Claude hỏi thêm, viết brief, tạo game trình duyệt rồi phát triển tiếp với Web, Godot, Unity hoặc Unreal. Cài đặt không quá khó nếu bạn đã có Git, Claude Code, Python 3 và Bash.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-05-03 · Cập nhật: 2026-11-14
- URL: https://ongt.vn/bai-viet/donchitos-claude-code-game-studios

Claude Code Game Studios là một template giúp Claude Code hoạt động như một studio phát triển game hoàn chỉnh. Bạn mô tả ý tưởng bằng ngôn ngữ tự nhiên, hệ thống sẽ hỏi thêm vài câu, viết brief một trang, tạo bản game đầu tiên và kiểm tra bản đó trong trình duyệt.

Repo phù hợp với indie game dev, người mới học làm game, designer muốn thử ý tưởng nhanh và lập trình viên muốn có quy trình rõ ràng khi phát triển bằng AI. Điểm đáng giá nhất là repo không chỉ cung cấp vài prompt rời rạc. Nó có agent, skill, hook, luật dự án, cấu hình engine và các bước kiểm tra để biến ý tưởng thành công việc có thể theo dõi.

Repo hiện có khoảng 38.834 sao và 5.046 fork, dùng giấy phép MIT. Bạn nên xem nó như một bộ khung để clone rồi tạo game riêng, không phải một game hoàn chỉnh có sẵn để chơi.

```repo
- repo | Donchitos/Claude-Code-Game-Studios
- kind | Framework
- desc | Biến Claude Code thành studio phát triển game với 49 agent, hệ thống skill và quy trình kiểm thử từ ý tưởng đến bản chơi được.
- stars | 39k
- lang | Shell
- license | MIT
```

## Claude Code Game Studios làm được gì

### Bắt đầu game từ một câu mô tả

Bạn có thể gõ một yêu cầu như `/prototype a fishing game where the rare fish only bite at dusk`. Claude 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 quá rộng, hệ thống đưa ra vài hướng ngắn để bạn chọn.

Cách này hữu ích khi bạn có ý tưởng nhưng chưa biết biến nó thành phạm vi công việc cụ thể. Bạn không cần viết ngay một tài liệu thiết kế dài.

### Viết brief một trang trước khi xây dựng

Sau phần hỏi đáp, hệ thống tạo `design/game-brief.md`. Brief giữ lại lời mô tả của bạn, đồng thời làm rõ giao diện, phút chơi đầu tiên, thử thách, tính năng và phần để sau.

Bạn có thể đọc brief rồi nói xây dựng, hoặc yêu cầu sửa trước. Đây là điểm quan trọng với người mới vì nó giúp phát hiện ý tưởng chưa rõ trước khi AI viết nhiều mã nguồn.

### Tạo bản game trình duyệt có thể mở trực tiếp

Bản prototype đầu tiên nằm trong `prototypes/<name>/` và có thể mở bằng cách double-click. Theo README, hệ thống tự vẽ các hình, không dùng emoji làm hình ảnh, không sao chép một game khác và cố gắng tránh tạo trò chơi quá dễ.

Bạn có thể chọn mức nỗ lực như `build it at medium`. Mức này ảnh hưởng đến độ dày và chi phí của bản dựng. Sau khi mở game, bạn có thể chơi thử rồi yêu cầu thay đổi từng phần.

### Tự kiểm tra bản dựng trước khi bàn giao

Claude dùng một số phím bấm được lập trình sẵn trong trình duyệt headless để kiểm tra game có mở được, có lỗi hay không và có phản hồi hay không. Hệ thống cũng kiểm tra chữ quá nhỏ, thành phần chồng lên nhau, nội dung nằm ngoài màn hình và màn hình bị treo.

Mỗi dòng trong brief được đánh dấu là đã làm, còn thiếu, bị lỗi hoặc chưa đánh giá được. Thẻ bàn giao cho biết phần nào đã đạt, phần nào còn hỏng và phần nào là phỏng đoán. README nhấn mạnh rằng game vẫn cần người thật chơi; kết quả tự động không thay thế playtest.

### Thay đổi game theo từng checkpoint

Khi yêu cầu chỉnh sửa, hệ thống đối chiếu thay đổi với những điều bạn muốn giữ lại và tránh làm. Mỗi thay đổi được chấp nhận là một checkpoint để bạn có thể quay lại.

Nếu yêu cầu tinh chỉnh nhiều giá trị, game có thể được bổ sung một bảng điều chỉnh với slider cho từng giá trị. Điều này phù hợp khi bạn muốn thử tốc độ, độ khó hoặc thông số gameplay mà không sửa tay từng dòng mã.

### Phát triển từ prototype thành dự án web

Khi bản thử nghiệm đã ổn, bạn có thể phát triển thành dự án web thật với Vite và TypeScript, đưa giá trị vào các file dữ liệu, thêm test và build. Mỗi lần chỉ thêm một feature, sau đó hệ thống xây dựng, kiểm tra và commit.

Các story như `/create-stories`, `/dev-story` và `/story-done` chỉ được dùng khi bạn yêu cầu. Cách này giúp dự án nhỏ không bị kéo vào quy trình nặng ngay từ đầu.

### Hỗ trợ nhiều hướng engine

Web là hướng mặc định cho game mới. Bạn có thể dùng `/setup-engine web` để chọn starter không thêm thư viện, three.js, Phaser hoặc PixiJS.

Repo cũng có cấu hình cho Godot 4, Unity và Unreal Engine 5. Với Godot, mã nguồn có thể là GDScript, C# hoặc GDExtension. Unity dùng `Assets/`, còn Unreal xây dựng từ `Source/<Module>/`. Lệnh `/setup-engine` ghim phiên bản engine và tạo tài liệu tham chiếu tương ứng.

### Điều chỉnh mức độ nghiêm ngặt của quy trình

File `project.yaml` là nguồn cấu hình chính cho engine, quy ước đặt tên, mục tiêu dự án và các mode làm việc. Ba mức `minimal`, `standard` và `full` điều khiển độ sâu tài liệu, QA, review, story và quy mô đội AI.

`minimal` là mặc định, phù hợp cho người mới hoặc game thử nghiệm. `standard` yêu cầu nhiều phần tài liệu hơn. `full` áp dụng kiểm tra và review kỹ hơn cho dự án lớn. Bạn cũng có thể dùng `system_overrides` để một hệ thống, chẳng hạn combat, được kiểm tra kỹ hơn phần còn lại.

## Cần chuẩn bị gì

Bạn cần Git để clone repo hoặc dùng repo làm template. Bạn cũng cần Claude Code. README khuyến nghị native installer; cách cài qua npm cũng được hỗ trợ với Node.js 22 trở lên.

Bạn cần Python 3. Repo dùng Python để đọc `project.yaml` cho từng 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ệ quan trọng: commit có stage dữ liệu JSON sẽ bị chặn nếu không có Python để kiểm tra.

Bạn cần Bash để chạy các hook. Trên macOS và Linux, Bash thường có sẵn. Trên Windows, README nói Bash đi kèm Git for Windows. Nếu Windows không có Bash, hook sẽ tự bỏ qua và thông báo lúc bắt đầu phiên rằng việc kiểm tra đang tắt.

Bạn cần Chrome, Edge hoặc Chromium nếu muốn `/prototype` chơi và chụp ảnh màn hình để kiểm tra tự động. Không có một trong các trình duyệt này, phần kiểm tra đó được ghi là chưa đánh giá.

Node.js được khuyến nghị khi bạn muốn phát triển game thành dự án web, dùng three.js 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, nhưng các công cụ tùy chọn thường không làm toàn bộ hệ thống dừng lại; bạn chỉ mất một phần validation.

README không nêu yêu cầu GPU, tài khoản dịch vụ riêng, API key riêng cho repo hay phần cứng đặc biệt. Phần đăng nhập và quyền sử dụng Claude Code cần làm theo hướng dẫn của chính Claude Code.

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

```steps
- Chuẩn bị công cụ | Cài Git, Claude Code, Python 3 và Bash; thêm trình duyệt Chromium nếu muốn kiểm tra prototype
- Clone template | Tải repo về một thư mục game riêng và đi vào thư mục gốc
- Mở Claude Code đúng chỗ | Khởi động trong thư mục có CLAUDE.md và project.yaml
- Tạo prototype | Dùng /prototype với ý tưởng game hoặc chạy /start để được hướng dẫn
- Kiểm tra và phát triển | Chơi bản đầu tiên, chỉnh sửa rồi chọn engine hoặc phát triển tiếp
```

### Chuẩn bị môi trường

Cài Git, Claude Code, Python 3 và Bash trước. Nếu dùng Windows, hãy cài Git for Windows để có Bash. Nếu muốn `/prototype` chụp ảnh và kiểm tra game, hãy cài Chrome, Edge hoặc Chromium.

README ghi rõ cách cài Claude Code qua npm như sau:

```bash
npm install -g @anthropic-ai/claude-code
```

Cách này yêu cầu Node.js 22 trở lên. Nếu bạn dùng native installer thì làm theo hướng dẫn cài đặt của Claude Code. Repo không cung cấp thêm lệnh đăng nhập hoặc cấu hình API key riêng, nên không nên tự đoán thêm biến môi trường.

### Clone repo và đặt tên thư mục

Mở terminal tại nơi bạn muốn lưu dự án. Lệnh dưới đây là lệnh README cung cấp:

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

`git clone` tải template về thư mục `my-game`. `cd my-game` đưa terminal vào đúng thư mục. Bạn có thể đổi `my-game` thành tên dự án của mình.

Người mới thường mở Claude Code ở thư mục cha hoặc ở `src/`. Repo yêu cầu bạn mở trong thư mục gốc, nơi có cả `CLAUDE.md` và `project.yaml`. Nếu vào sai thư mục, hook, luật deny và chế độ hỏi trước có thể không được áp dụng.

### Khởi động Claude Code ở thư mục gốc

Sau khi đã chạy `cd my-game`, khởi động phiên bằng:

```bash
claude
```

Không chạy lệnh này trong `src/`, `Assets/` hoặc một thư mục con khác. Thư mục hiện tại phải là thư mục chứa `CLAUDE.md` và `project.yaml`.

Lúc này repo sẽ cung cấp cấu hình, agent, skill, hook và các luật theo phạm vi đường dẫn. Trên Windows, nếu hook báo bị tắt, kiểm tra lại Bash trong Git for Windows và Python 3.

### Tạo game đầu tiên

Trong phiên Claude Code, bạn có thể gõ:

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

Claude sẽ hỏi một vòng câu hỏi. Trả lời trực tiếp về thể loại, cảm giác, hình ảnh, độ khó và mục tiêu. Nếu bạn chưa muốn chọn chi tiết, README cho biết bạn có thể trả lời theo kiểu “you pick”.

Bạn cũng có thể dùng lối vào tổng quát:

```text
/start
```

`/start` hỏi bạn đang ở đâu: muốn tạo game, mới có ý tưởng, đã có thiết kế rõ, hay đã có sản phẩm. Sau đó nó dẫn tới quy trình phù hợp. Nếu đã biết muốn dùng engine, README có ví dụ:

```text
/setup-engine godot 4.7
```

Không cần chọn engine ngay khi làm prototype trình duyệt. README khuyến nghị có thể chơi bản web trước rồi mới chọn engine.

### Kiểm tra cấu hình và chọn bước tiếp theo

Sau khi Claude tạo hoặc cập nhật dự án, bạn có thể xem cấu hình bằng:

```text
/project-settings
```

Xem riêng một thiết lập:

```text
/project-settings modes.review_mode
```

Đổi mức rigor cho cả nhóm:

```text
/project-settings modes.rigor=full
```

Đổi review mode riêng cho máy hoặc người dùng hiện tại:

```text
/project-settings --local modes.review_mode=solo
```

Cấu hình cục bộ được ghi vào `project.local.yaml`, còn thiết lập chung ghi vào `project.yaml`. README nói file cục bộ dành cho các override cá nhân và nằm ngoài phần chia sẻ chung.

## Kiểm tra đã chạy được chưa

Cách kiểm tra đầu tiên là xem Claude Code khởi động trong đúng thư mục gốc và nhận diện được `CLAUDE.md`, `project.yaml`. Khi phiên bắt đầu, hook session có thể hiển thị nhánh hiện tại và các commit gần đây. Hook cũng kiểm tra dự án mới hoặc tài liệu thiết kế còn thiếu.

Sau khi chạy `/prototype`, kết quả mong đợi là:

- Có câu hỏi làm rõ ý tưởng.
- Có file `design/game-brief.md` để bạn đọc và duyệt.
- Có một thư mục prototype trong `prototypes/<name>/`.
- Game có thể mở bằng double-click.
- Kiểm tra trình duyệt cho biết game mở được, phản hồi với phím bấm và không có lỗi được phát hiện.
- Thẻ bàn giao nêu phần đã đạt, phần còn hỏng, phần được phỏng đoán và ghi rõ game chưa được người thật chơi.

Nếu thiếu Chrome, Edge hoặc Chromium, kết quả kiểm tra trình duyệt có thể ghi là chưa đánh giá. Điều đó không nhất thiết có nghĩa game hỏng; nó có nghĩa môi trường chưa đủ để chạy phần kiểm tra đó.

Bạn cũng có thể dùng các lệnh kiểm tra framework nếu đang sửa skill hoặc agent:

```text
/skill-test static [name]
/skill-test category [name]
/skill-test spec [name]
/skill-test audit
/skill-improve [name]
```

Các lệnh này kiểm tra framework, không kiểm tra game của bạn. Test game nằm trong `tests/`.

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

### Chủ shop muốn thử một game nhỏ cho thương hiệu

Một chủ shop muốn làm game câu cá đơn giản để khách chơi trên trang giới thiệu. Bạn có thể bắt đầu bằng:

```text
/prototype a relaxing fishing game for a small shop, with rare fish appearing only at dusk
```

Claude hỏi thêm về cảm giác chơi, giao diện và mục tiêu, sau đó tạo brief và prototype. Chủ shop có thể mở game bằng double-click, xem một phút chơi đầu tiên rồi yêu cầu chỉnh màu sắc, tốc độ hoặc độ hiếm của cá.

Kết quả phù hợp ở giai đoạn này là một bản thử nghiệm để kiểm tra ý tưởng, chưa phải sản phẩm thương mại hoàn thiện.

### Người mới học game muốn đi từ ý tưởng đến bản chơi được

Một người mới chưa biết bắt đầu từ GDD hay mã nguồn có thể chạy:

```text
/start
```

Khi được hỏi, họ chọn hướng tạo game từ ý tưởng. Hệ thống dẫn qua brief, bản dựng đầu tiên và các bước kiểm tra. Sau khi chơi, họ có thể nói rõ một thay đổi, chẳng hạn “tăng thời gian né chướng ngại vật nhưng giữ nguyên cảm giác nhanh”.

Điểm hữu ích là người mới có một bước tiếp theo cụ thể thay vì phải tự đoán nên viết tài liệu, code hay test trước.

### Lập trình viên muốn phát triển prototype thành web game

Sau khi prototype ổn, lập trình viên có thể yêu cầu chuyển sang hướng web và dùng:

```text
/setup-engine web
```

README cho biết web starter có thể không thêm thư viện, hoặc dùng three.js, Phaser hay PixiJS. Game phát triển tiếp có thể dùng Vite và TypeScript, đưa giá trị vào file dữ liệu, thêm test và build.

Mỗi lần chỉ thêm một feature. Sau đó hệ thống chạy lại seeded run và cho thấy thay đổi, giúp lập trình viên biết feature mới có làm hỏng hành vi cũ hay không.

### Nhóm nhỏ cần quy trình rõ ràng hơn

Một nhóm có thể bắt đầu ở mức nhẹ rồi tăng độ nghiêm ngặt khi game lớn lên:

```text
/project-settings modes.rigor=standard
```

Nếu hệ thống combat cần tài liệu và QA kỹ hơn, nhóm có thể dùng `system_overrides` cho riêng hệ thống đó. Nếu mỗi thành viên cần review mode khác nhau, họ có thể đặt override trong `project.local.yaml` mà không sửa cấu hình chung.

> Một prototype tốt không chỉ là game chạy được; nó phải cho bạn biết điều gì đã được kiểm tra và điều gì vẫn chưa biết.
>
> — Ông T

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

### Claude Code được mở trong thư mục con

Nếu bạn chạy `claude` trong `src/` hoặc một thư mục khác, hook, luật deny và chế độ hỏi trước của dự án có thể bị bỏ qua. Hãy thoát về thư mục chứa `CLAUDE.md` và `project.yaml`, rồi khởi động lại.

### Hook bị bỏ qua trên Windows

Nguyên nhân thường là thiếu Bash. Cài hoặc mở Git for Windows để có Bash, sau đó khởi động lại phiên ở thư mục gốc. Nếu vẫn thiếu Python 3, nhiều thiết lập trong `project.yaml` có thể quay về mặc định.

### Prototype không được kiểm tra trên trình duyệt

Nếu máy không có Chrome, Edge hoặc Chromium, phần chơi và chụp ảnh bằng trình duyệt headless sẽ được ghi là chưa đánh giá. Cài một trình duyệt được README hỗ trợ rồi chạy lại quy trình kiểm tra.

### Cấu hình không có hiệu lực như mong đợi

Kiểm tra bạn đang sửa đúng file và đúng khóa. `project.yaml` là cấu hình chung; `project.local.yaml` dùng cho override cá nhân. Có thể dùng `/project-settings` để xem cấu hình hiệu lực trước khi thay đổi.

### Tưởng kết quả tự động đã thay thế playtest

Các phím bấm scripted và kiểm tra ảnh chỉ giúp phát hiện một số lỗi. README ghi rõ game vẫn chưa được người thật chơi ở bước bàn giao. Hãy tự mở game, chơi qua luồng chính và ghi lại những điểm còn khó hiểu trước khi chia sẻ.

### Sửa skill nhưng không kiểm tra lại framework

Nếu bạn chỉnh file trong `.claude/skills/`, hook sẽ khuyến nghị chạy `/skill-test`. Dùng các lệnh `static`, `category`, `spec` hoặc `audit` phù hợp với loại thay đổi. Đừng nhầm các bài test này với test gameplay trong `tests/`.

```note
Claude Code Game Studios có thể tạo và sửa file trong dự án của bạn. Hãy đọc diff trước khi chấp nhận thay đổi, đặc biệt là file cấu hình, hook và lệnh commit. README không nêu chính sách lưu trữ dữ liệu hay chi phí Claude Code; bạn nên kiểm tra tài khoản và quyền truy cập trước khi đưa mã nguồn riêng vào phiên làm việc.
```

## Có nên dùng không

Bạn nên dùng nếu muốn biến Claude Code thành một quy trình làm game có cấu trúc, bắt đầu nhanh bằng prototype trình duyệt và có sẵn đường phát triển sang Web, Godot, Unity hoặc Unreal. Bộ agent, skill, hook và tài liệu giúp dự án bớt phụ thuộc vào những prompt ngẫu hứng. Việc có brief, checkpoint và kiểm tra trước bàn giao cũng hữu ích cho nhóm nhỏ hoặc người mới.

Giới hạn lớn nhất là đây là template cần Claude Code để vận hành. Nó không tự thay thế kiến thức thiết kế game, lập trình, nghệ thuật, âm thanh hay playtest. Kiểm tra headless có thể phát hiện lỗi giao diện và phản hồi cơ bản, nhưng không chứng minh game đã vui, cân bằng hoặc sẵn sàng bán.

README cũng nói rằng route engine cho Godot, Unity và Unreal đã được xây dựng và vượt qua các kiểm tra của framework, nhưng chưa được chứng minh bằng bài thử tương đương với hai phần đánh giá prototype và growing. Vì vậy, nếu bạn cần một engine chuyên nghiệp cho dự án lớn, hãy xem repo như lớp quy trình hỗ trợ, không phải sự thay thế cho tài liệu và pipeline chính thức của engine.

Giấy phép MIT làm repo dễ dùng và tùy biến. Tuy nhiên, hãy kiểm tra kỹ các thay đổi do AI tạo ra, quyền truy cập file và chi phí dịch vụ trước khi dùng trong dự án thương mại. Với một ý tưởng nhỏ, game jam hoặc prototype cần làm nhanh, đây là lựa chọn đáng thử. Với nhóm đã có pipeline ổn định và không muốn Claude can thiệp vào hook, permission hoặc cấu trúc dự án, cách làm hiện tại của nhóm có thể phù hợp hơn.

## 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 mã nguồn được phát hành theo giấy phép đó. README không nêu chi phí sử dụng Claude Code hoặc các dịch vụ liên quan, vì vậy bạn cần kiểm tra riêng phần tài khoản và dịch vụ mình dùng.

### Có cần GPU để chạy không?

Tư liệu được cung cấp không nêu yêu cầu GPU. Repo yêu cầu Git, Claude Code, Python 3, Bash và trình duyệt Chrome, Edge hoặc Chromium cho việc kiểm tra prototype.

### Có chạy được trên Windows không?

Có thể chạy trên Windows nếu có Bash; README nói Bash đi kèm Git for Windows. Nếu thiếu Bash, các hook sẽ tự bỏ qua và phiên làm việc báo rằng việc kiểm tra đang tắt.

### Có bắt buộc phải cài Node.js không?

Node.js không bắt buộc cho mọi workflow. README khuyến nghị Node.js cho việc cài Claude Code qua npm, phát triển web game, dùng three.js và chạy build hoặc test của web engine; cách cài npm cần Node.js 22 trở lên.

### Có cần API key riêng cho repo không?

README được cung cấp không nêu API key riêng, biến môi trường riêng hoặc tài khoản dịch vụ riêng cho repo. Bạn cần làm theo yêu cầu đăng nhập và quyền sử dụng của Claude Code.

### Repo có tạo game hoàn chỉnh để tải về chơi ngay không?

Không. Đây là template để bạn clone và bắt đầu dự án riêng; các game mẫu không được đóng gói trong repo. Hệ thống có thể tạo prototype trình duyệt trong `prototypes/<name>/`, sau đó bạn tiếp tục phát triển.

### Kiểm tra tự động có thay thế người chơi thử không?

Không. Hệ thống có thể chạy phím bấm scripted, kiểm tra lỗi và ảnh chụp trong trình duyệt headless, nhưng README vẫn ghi rõ bản bàn giao là chưa được người thật chơi. Bạn vẫn cần tự playtest trước khi chia sẻ hoặc phát hành.
