AI之从零开始做专业级游戏设计
03/29186 浏览开发心得 包含 AI 合成内容
Claude Code Game Studio Agent 架构 — 硬核教程
目标读者：想用这套开源架构来制作游戏设计文档（GDD）的独立开发者、策划、学生团队
读完本文你能做到：从零开始，用 Claude Code + 这套架构，完整地产出一套专业级游戏设计文档
一、这套架构是什么
这是一套用 Claude Code 写游戏设计文档的自动化工作流。
它包含：
48 个专业化 AI Agent（类比游戏公司中的不同岗位：策划、程序、美术、音效、QA 等）
37 个斜杠命令，每个命令对应一个专业工作流程
28 个文档模板，覆盖游戏开发的各个阶段
协作规范：Agent 之间如何分工、如何避免冲突、如何记录决策
你不需要懂代码。这套架构的核心用途是：
用自然语言和 AI 对话，让 AI 帮你写出专业级别的游戏设计文档
它输出的文档是纯 Markdown 格式，任何人可以直接阅读、打印、或交给其他人去实现。
二、前置准备
在开始之前，你需要在电脑上安装几个工具。整个安装过程大约需要 15-30 分钟，一次搞定，之后就不用再装了。
本教程提供了两种配置方式：
方式一（推荐新手）：CC Switch + 第三方 API（DeepSeek / MiniMax / GLM 等），便宜省钱，国内网络可直接使用
方式二（Anthropic 官方）：官方 Claude Key，质量最高但需要科学上网，且按用量计费
详细的图文安装步骤在下一章（第 3 章），按顺序跟着做就能完成。
需要安装的工具一览：
Git — 版本控制工具，用来克隆项目模板（必装）
Node.js — CC Switch 的运行环境（用方式一必装）
CC Switch — API 路由工具，一个软件管理多个 API（强烈推荐）
Claude Code — AI 对话助手，本架构的核心工具（必装）
VS Code — 代码编辑器，Claude Code 的最佳界面（推荐）
API Key — 你选用的 AI 服务凭证（方式一在 CC Switch 里配，方式二用官方 Key）
三、初始化项目（详细步骤）
在开始之前，你需要先把这套架构的模板仓库下载到你的电脑上。这一步叫做"克隆"（Clone）。整个过程分三步：
第一步：在你的电脑上安装必要的工具
如果你是第一次使用，请按顺序安装以下工具：
1. 安装 Git（必装）
Git 是一个版本控制工具，用来管理你的项目文件，也是克隆仓库的必备工具。
Windows 安装步骤：
验证安装是否成功：
在 Git Bash 中输入以下命令，按回车：
git --version
看到类似 git version 2.xx.x 的字样就说明安装成功了。
2. 安装 Node.js（使用 CC Switch 必装）
CC Switch 是一个 API 路由工具，可以让你在 Claude Code 中使用各种第三方 API（如 DeepSeek、GLM、阿里百炼、MiniMax 等），比只用一个官方账号更灵活省钱。安装 CC Switch 之前，需要先装 Node.js。
node --version
npm --version
看到版本号（如 v18.x.x 和 9.x.x）就说明安装成功。
3. 安装 CC Switch（强烈推荐）
CC Switch 是一个免费的桌面工具，它可以：
聚合多个 API：DeepSeek、MiniMax、GLM（智谱）、阿里百炼、硅基流动等都可以配置进来
一键切换：不同项目、不同需求随时换 API，不用重新配置
省钱灵活：不用绑死在 Anthropic 官方，用国内平价 API 也能跑通 Claude Code 工作流
自带测试：在工具内就能测试 API 是否生效
配置 API Key：
CC Switch 支持很多国内外的 API 平台，以下是几个常用的：
DeepSeek — 性价比最高，推荐首选
MiniMax — 2.7 模型够用，第三方优选
仁者见仁智者见智，目前 MiniMax-2.7 模型写出的方案够用；如果追求更高质量，可选 Claude Opus-4.6、GLM-5.1 等自行配置。
MiniMax 注册充值还有 9 折优惠，邀请链接：https://platform.minimaxi.com/subscribe/token-plan?code=6pHzvwP3Hq&source=link
智谱 GLM — 清华系，兼容性好
阿里百炼 — 聚合平台，支持通义千问、MiniMax 等
硅基流动 — 注册送积分，可白嫖
Anthropic 官方 — 原厂模型，质量最高（但贵）
配置完成后，不需要在 Claude Code 里登录官方账号，直接运行 claude 即可，CC Switch 会自动接管流量。
如果你之前已经用 claude auth 登录过官方账号，建议先退出：claude /logout，然后再启动 CC Switch，避免冲突。
注意：如果你已经配置好了 CC Switch，在启动 Claude Code 时会提示跳过登录，直接使用 CC Switch 路由即可。
第二步：克隆（下载）项目模板
克隆，就是把 GitHub 上的这个仓库下载到你的电脑里。
方法一：命令行克隆（适合有一点点动手能力的同学）
第一步：确定你的工作目录
找一个你放项目的文件夹，比如"我的文档"里新建一个叫"游戏策划"的文件夹。
第二步：打开 Git Bash
在文件夹空白处右键，选择"Open Git Bash here"（如果看不到这个选项，说明前面的 Git 安装可能有问题，重装 Git 试试）。
第三步：执行克隆命令
在 Git Bash 窗口中输入以下命令，按回车：
等待几秒到几十秒（取决于网速），看到类似下面的文字就说明成功了：
Cloning into 'Claude-Code-Game-Studios'...
Receiving objects: 100%, done.
第四步：进入项目文件夹
克隆完成后，在 Git Bash 中输入：
cd Claude-Code-Game-Studios
现在你在终端里看到的路径前面有 (main) 或 (master) 字样，说明你已经在项目里了。
第五步：确认文件结构正确
在 Git Bash 中输入以下命令，可以查看项目里有哪些文件：
ls
方法二：GitHub 网页下载（纯图形界面，适合完全不想用命令行的同学）
如果你实在不想用命令行，可以用这个方法：
第三步：启动 Claude Code，开始使用
方法一：在 Git Bash 中启动
方法三：直接双击启动（Windows）
在项目文件夹里，新建一个文本文件，命名为 start-claude.bat，内容是：
start claude
双击这个文件即可启动。
常见问题排查
Q：克隆时报错 "Failed to connect to github.com"
这是网络问题，可能是：
你的网络无法访问 GitHub（在国内有时会遇到）
解决方法：开启 VPN/代理，或者用 Gitee 镜像（需要先把仓库 Fork 到 Gitee）
Q：克隆时报错 "Permission denied"
说明你没有这个仓库的访问权限。如果你只是想用模板做自己的项目，可以：
先 Fork 到你自己的 GitHub 账号下（点 GitHub 页面右上角的 Fork 按钮）
然后克隆你 Fork 后的仓库地址
Q：clone 速度很慢怎么办
GitHub 在国内访问有时较慢，可以：
耐心等待（一般 1-5 分钟）
开启代理并配置 Git：git config --global http.proxy http://127.0.0.1:端口号
Q：安装 Git Bash 后右键菜单没有 "Open Git Bash here"
可能是安装时没有勾选相关选项。解决方法：重新运行 Git 安装包，选择 "Modify" → 勾选 "Windows Explorer integration" → 完成安装。
快速检查清单
完成以上步骤后，对照以下清单确认一切就绪：
[ ] Git Bash 中输入 git --version 有版本号输出
[ ] VS Code 已安装并能打开
[ ] Node.js 已安装（node --version 有输出）
[ ] CC Switch 已安装并在运行中
[ ] CC Switch 中已配置好至少一个 API（如 DeepSeek）
[ ] 克隆仓库成功，文件夹里有 CLAUDE.md 等文件
[ ] 在项目文件夹里运行 claude，AI 对话助手启动成功
全部打勾后，你就可以开始用 /start 或 /brainstorm 开始你的第一个游戏设计文档了！
项目目录结构
克隆下来后，你会看到以下文件夹结构：
Claude-Code-Game-Studios/
├── CLAUDE.md ← 主配置文件（每次对话 AI 都会读取它）
├── .claude/ ← Agent 架构配置（48个 AI 角色定义）
│ ├── settings.json ← Claude Code 钩子配置
│ ├── agents/ ← 48个 Agent 角色定义文件
│ ├── skills/ ← 37个斜杠命令定义
│ ├── hooks/ ← 自动化钩子脚本
│ └── docs/ ← 架构文档和模板
│ └── templates/ ← 28个文档模板
├── design/ ← 游戏设计文档放这里
│ └── gdd/ ← GDD 子目录（你的游戏文档都放这）
├── src/ ← 源代码（开始写代码后才用到）
├── assets/ ← 美术/音效资源（开始做资源后才用到）
└── production/ ← 开发计划、里程碑管理文档
每个文件夹的用途会在后续教程中逐步讲解。现在你只需要知道：所有游戏策划文档都放在 design/gdd/ 文件夹里，先在这里工作即可。
开始第一个项目：运行 /start
工具安装完毕、仓库克隆成功之后，就可以开始创建你的游戏了！
在 Claude Code 对话框中输入：
/start
Claude 会问你几个问题来了解你的情况：
你想做什么类型的游戏？
你是一个人做还是有团队？
你有没有游戏开发的经验？
根据你的回答，Claude 会帮你完成后续所有步骤。
如果已经有明确想法，可以直接跳过 /start，输入：
/brainstorm
开始头脑风暴，Claude 会引导你把一个模糊的想法变成完整的游戏概念文档。
四、核心工作流：5步设计法
不管你做什么游戏，都遵循同样的 5 步流程：
第1步 头脑风暴
工具：/brainstorm
第2步 概念评审
工具：/design-review
第3步 系统分解
工具：/map-systems
第4步 单系统设计
工具：/design-system [系统名]
第5步 文档审查
工具：/design-review [文档路径]
每一步都由 AI 引导你完成，你只需要回答问题、做出选择。
五、每个技能的用法详解
5.1 /brainstorm — 头脑风暴，找游戏方向
什么时候用：你有一个模糊的游戏想法，或者完全没想法
用法：
/brainstorm
或者加一个主题提示：/brainstorm roguelike、/brainstorm 太空生存、/brainstorm open
流程：
1. Phase 1：了解你 — AI 问你喜欢什么游戏、想要什么感觉、团队规模和经验
2. Phase 2：生成概念 — AI 提出 3 个不同方向的游戏概念，各有特色
3. Phase 3：核心循环设计 — 选定方向后，细化 30 秒循环、5 分钟循环、整局循环
4. Phase 4：Pillar 定义 — 提炼 3-5 个设计支柱（这是防止团队跑偏的核心）
5. Phase 5：玩家类型验证 — 确定目标玩家群体
6. Phase 6：范围评估 — 估算工期、MVP 定义、风险
输出：game-concept.md（游戏概念文档）、game-pillars.md（设计支柱文档）
5.2 /design-review — 审查游戏概念
什么时候用：brainstorm 结束后，验证概念文档的质量
前置条件：design/gdd/game-concept.md 已存在
用法：/design-review design/gdd/game-concept.md
或审查所有系统文档：/design-review design/gdd/
审查维度：完整性、内部一致性、可实现性、跨系统一致性、平衡性
输出：一份结构化的审查报告，告诉你哪里需要修改。
5.3 /map-systems — 拆解系统，列出依赖关系
什么时候用：概念文档通过审查后，把游戏拆成若干子系统
前置条件：design/gdd/game-concept.md 已存在
用法：/map-systems
流程：
1. AI 读取你的游戏概念
2. 从概念中推导出所有需要的系统
3. 标出每个系统依赖哪些其他系统
4. 按 MVP / Alpha / Full Vision 分层
5. 输出系统索引
输出：design/gdd/systems-index.md，包含所有系统列表、优先级、依赖关系、推荐实现顺序。
5.4 /design-system — 设计单个游戏系统
什么时候用：要写某个具体系统的详细设计文档
前置条件：design/gdd/systems-index.md 已存在
用法：/design-system combat-system
或 /design-system 战斗系统
流程：每个系统文档分为 8 个章节，AI 会依次问你：
第 1 步 Overview — 这个系统是什么？一句话描述
第 2 步 Player Fantasy — 玩家玩到这个系统时应该感受到什么？
第 3 步 Detailed Design — 核心规则是什么？状态机怎么转？
第 4 步 Formulas — 数值怎么算？给出公式
第 5 步 Edge Cases — 边界情况怎么处理？
第 6 步 Dependencies — 这个系统依赖哪些其他系统？
第 7 步 Tuning Knobs — 设计师需要调哪些参数？
第 8 步 Acceptance Criteria — 怎么测试这个系统是否正确实现？
重要规则：AI 不会替你做决定。每章都会问你问题，你回答后 AI 才写内容。你也可以说"我不知道"，AI 会给出选项让你选。
输出：design/gdd/[系统名].md — 完整的系统设计文档
5.5 其他常用斜杠命令
/start — 第一次使用，完全不知道从哪里开始
/design-review [路径] — 审查任意设计文档
/gate-check pre-production — 检查是否可以开始正式开发
/prototype [核心机制] — 快速搭建一个可玩原型验证手感
/sprint-plan new — 规划第一个开发周期
/architecture-decision — 记录一个技术决策
/playtest-report — 整理和报告试玩反馈
/scope-check — 检查是否在范围蔓延
六、设计文档的8个标准章节
每个游戏系统文档（GDD）必须包含这 8 个章节。格式不强制，但内容必须有。
6.1 Overview（一句话概述）
这一章回答：这是什么系统？
用一句话说清楚系统的核心职责。读者读完这节，应该能用一句话向别人解释这个系统。
6.2 Player Fantasy（玩家幻想）
这一章回答：玩家感受到什么？
描述玩家与这个系统交互时，应该产生的情感体验。不要写机制，要写感觉。
不好：碰撞到平台后速度反向
更好：每一次弹跳都带来轻微的弹力感，玩家感觉嗒嗒啦像真的在蹦床上一样有韧性
6.3 Detailed Design（详细设计）
这一章回答：这个系统怎么工作的？
这是文档最核心的部分，包含：
核心规则：最基础的规定（编号列出）
状态机：系统有哪些状态，各自之间怎么转换
接口：与其他系统的数据交换方式
6.4 Formulas（公式）
这一章回答：数字怎么算的？
所有涉及数值的计算都必须在这里列出，包括：变量定义、公式本身、典型输入输出的例子、数值范围说明。
不好：伤害根据攻击力计算
更好：damage = baseDamage × (1 + ATK/100) × critMultiplier
其中 baseDamage=50, ATK=角色攻击力(0-999), critMultiplier=1.5(暴击时)/1.0(普通)
6.5 Edge Cases（边缘情况）
这一章回答：出了问题怎么办？
列出所有非正常情况：零值、最大值、负数、并发、极端输入等。
不好：其他情况应该妥善处理
更好：当 maxHealth≤0 时，角色直接进入 DEAD 状态，不执行任何伤害计算
6.6 Dependencies（依赖关系）
这一章回答：谁依赖我，我依赖谁？
列出：
上游依赖（我需要先有这些系统才能工作）
下游依赖（这些系统需要我的输出）
并且注明每个依赖传递的具体数据。
6.7 Tuning Knobs（调参旋钮）
这一章回答：设计师要调什么？
所有需要数值调整的参数都列在这里，每项包含：参数名、默认值、安全范围、调大会怎样、调小会怎样。
6.8 Acceptance Criteria（验收标准）
这一章回答：怎么证明这个系统做对了？
列出可测试的条件，每条必须能用"通过/不通过"判断。
不好：手感流畅
更好：从按住到释放延迟 ≤ 16ms，无可见卡顿（帧率≥55fps）
七、常见问题 FAQ
Q1：GitHub 是什么？如何访问？
GitHub 是一个存放代码和文档的网站，全球开发者都在用。访问 https://github.com 即可。如果国内打开慢或打不开，需要开启 VPN，或者用国内替代品 Gitee（gitee.com）。注意：用 Gitee 需要先把 GitHub 上的仓库"导入"到 Gitee。
Q2：如何把自己的项目同步到 GitHub？
克隆模板后，你自己的项目应该推送到你自己的 GitHub 仓库，而不是直接推到这个模板仓库。正确流程是：
1. 去 github.com 注册一个账号
2. 点击右上角 "+" → "New repository" 创建一个新仓库
3. 给仓库起个名字（比如 "my-game-gdd"）
4. 创建后，把仓库地址记录下来
5. 在你本地项目里执行：git remote set-url origin 你自己的仓库地址
6. 以后用 git push 就能把自己的文档同步上去了
Q3：我不懂 Git，能用这套架构吗？
能。Git 只是用来存放文件的工具，核心工作完全在 Claude Code 对话里完成。你只需要学会三个命令：克隆（git clone）、保存（git add + git commit）、上传（git push）。本教程的第三章已经给出了完整的傻瓜式操作步骤，照着做就行。
Q4：我不懂游戏开发，能用这套架构吗？
能，但更适合有以下基础的人：玩过足够多的游戏，能描述自己喜欢的游戏哪里好玩；有基本的逻辑思维，能把自己的想法说清楚。
如果你是完全零基础，建议先：读几款你喜欢的游戏的 Design Document；用 /brainstorm open 让 AI 从零开始引导你。
Q5：这套架构只能做游戏设计文档吗？
主要用途是游戏设计文档，但架构本身是通用的。你可以用 /architecture-decision 记录任何技术决策，用 /sprint-plan 规划任何类型的项目。
Q6：AI 写的文档会不会有错误？
有可能。这套架构设计了多层审查机制：/design-review 会在写完后审查文档，每个章节写完后让你确认，AI 会标记 "provisional（暂定）" 假设并提醒你验证。建议对关键数值和规则，至少找有经验的人复审一遍。
Q7：需要配置什么 API Key？
有两种方式：
方式一：Anthropic 官方 Key（贵但质量最高）
创建 API Key
终端运行 claude auth 粘贴 Key
赠送 $5 免费额度
方式二：CC Switch + 第三方平价 API（推荐，省钱）
下载 CC Switch：https://github.com/farion1231/cc-switch/releases
在 CC Switch 中配置 DeepSeek、MiniMax、GLM、阿里百炼等平台的 API Key
DeepSeek、MiniMax 等平台注册就送额度，性价比极高
配置好后直接运行 claude，CC Switch 自动接管，不需要官方 Key
新手建议：如果你在国内、或者想省钱，用 CC Switch + DeepSeek 或 MiniMax 是最经济的选择。MiniMax 2.7 模型实际够用，注册充值还有 9 折优惠：https://platform.minimaxi.com/subscribe/token-plan?code=6pHzvwP3Hq&source=link 如果你想用最原生的 Claude 模型体验，再用官方 Key。
Q8：Token 用量和费用大概是多少？
以嗒啦啦大蹦床项目为例（23个系统 GDD）：
整个设计过程约消耗 50-80 万 Token
用 DeepSeek / MiniMax 等平价 API，每百万 Token 约 ¥1-2 元，总费用约几毛钱
用 Anthropic 官方（Sonnet 4 约 $3/百万 Token），费用约 $0.15-0.24
用 CC Switch 接入第三方 API，预算控制在 ¥5 以内基本够用
Q9：文档写完后怎么交给别人？
文档格式是 Markdown（.md），可以：直接发 .md 文件（用 VS Code、Obsidian、Notion 等都可以打开）；打包成 ZIP；推送到 GitHub；打印成 PDF。
Q10：引擎配置（/setup-engine）是必须的吗？
不是。/setup-engine 只在你要写技术设计文档或开始写代码时才需要。如果你只需要游戏设计文档（策划案），完全不需要配置引擎。
Q11：能不能只做部分系统？
可以。用 /map-systems 生成的系统索引中，每个系统都有优先级标注：
MVP：核心玩法必需
Vertical Slice：单关体验完整
Alpha：全部内容可玩
Full Vision：完整发布版
你可以只做 MVP 部分，先验证核心循环是否好玩。
Q12：如何自定义 Agent 的行为？
在 .claude/agents/ 目录下，每个 Agent 都有一个 Markdown 文件，定义了 Agent 的角色定位（role）、可用工具（tools）、专业领域（expertise）。你可以修改这些文件来定制 Agent 的行为。
Q13：协作模式下多人能同时用这套架构吗？
能，但要注意：所有 .claude/ 配置和 design/ 文档最好放在 Git 上协同；避免多人同时编辑同一个 .md 文件（会合并冲突）；建议分工：每人负责不同的系统 GDD，写完后 /design-review 合并。
八、文件结构说明
8.1 必读文件
CLAUDE.md — 项目主配置，AI 每次对话都会读取 ⭐⭐⭐ 必须
.claude/docs/quick-start.md — 架构快速参考 ⭐⭐ 建议
design/gdd/game-concept.md — 你的游戏概念 ⭐⭐⭐ 必须
design/gdd/systems-index.md — 系统总览（相当于目录） ⭐⭐⭐ 必须
8.2 目录用途速查
design/gdd/ — 游戏设计文档（GDD）
design/narrative/ — 叙事/世界观/角色设定
design/levels/ — 关卡设计文档
design/balance/ — 数值平衡表
.claude/agents/ — Agent 行为定义（可定制）
克隆项目模板（一次性）
cd Claude-Code-Game-Studios
启动 Claude Code
claude ← 启动 Claude Code
/start ← 引导初始化
设计流程
/brainstorm [主题] — 头脑风暴
/design-review — 审查概念
/map-systems — 拆解系统
/design-system [系统名] — 设计单个系统
/design-review [路径] — 审查文档
典型项目完整流程
安装 Git + Node.js + CC Switch + Claude Code + VS Code
↓
↓
cd Claude-Code-Game-Studios
↓
claude
↓
/start 或 /brainstorm
↓
回答问题，Claude 生成游戏概念文档
↓
/design-review design/gdd/game-concept.md
↓
/map-systems
↓
/design-system [第一个系统名]
↓
重复 /design-system 直到所有系统完成
↓
/design-review design/gdd/
↓
/gate-check pre-production
附录：嗒啦啦大蹦床的文档清单（我自己做的一款游戏设计）
以下是该架构实际输出的文档包结构，供你参考：
design/
├── README-for-TapTap.md ← 使用指引（本包附带）
├── gdd/
│ ├── game-concept.md ← 游戏概念
│ ├── systems-index.md ← 系统总览（23个子系统）
│ ├── 01-touch-input-system.md ← 触摸输入
│ ├── 02-game-state-machine.md ← 游戏状态机
│ ├── 03-level-data-system.md ← 关卡数据
│ ├── 04-projectile-physics-system.md ← 弹射物理
│ ├── 05-collision-detection-system.md ← 碰撞检测
│ ├── 06-character-state-system.md ← 角色状态
│ ├── 07-character-animation-system.md ← 角色动画
│ ├── 08-aiming-trajectory-system.md ← 瞄准轨迹
│ ├── 09-level-loading-system.md ← 关卡加载
│ ├── 10-star-collection-system.md ← 星星收集
│ ├── 11-audio-system.md ← 音效
│ ├── 12-particle-system.md ← 粒子特效
│ ├── 13-main-menu-system.md ← 主菜单
│ ├── 14-level-select-system.md ← 关卡选择
│ ├── 15-level-complete-system.md ← 过关结算
│ ├── 16-save-system.md ← 存档
│ ├── 17-moving-platform-system.md ← 移动平台
│ ├── 18-bounce-pad-system.md ← 弹力跳板
│ ├── 19-timed-mechanism-system.md ← 时机机关
│ ├── 20-hidden-achievement-system.md ← 隐藏成就
│ ├── 21-character-appearance-system.md ← 角色形象
│ ├── 22-character-ability-system.md ← 角色特性
│ └── 23-achievement-integration-system.md ← 成就对接
共 26 份文档，总大小约 104 KB（纯文本）。