企业官网建设流程全解析

1. 为什么单个 Claude Code 会话撑不起一个游戏项目

你可能已经用 Claude Code 写过一些小游戏 Demo，单个会话里让它写个贪吃蛇、打砖块，体验确实不错。但一旦项目稍微复杂一点，问题就来了：昨天让它设计的战斗公式，今天它已经忘了；上周定好的美术风格，这周写 UI 的时候它又给你整出另一套配色；更别提那些悄悄被硬编码进代码里的魔法数字，等你发现的时候已经散落在十几个文件里了。

这不是模型能力的问题，而是结构缺失的问题。一个真实的游戏工作室里，有创意总监盯着愿景不跑偏，有主程管代码架构，有 QA 在提交前拦一道，有制作人跟踪进度。而单个 Claude Code 会话里，这些角色全都不存在，你面对的就是一个"什么都懂一点、但什么都不负责"的通用助手。

Claude Code Game Studios 这个项目想解决的就是这件事。它把单个 Claude Code 会话扩展成一个49 个专业代理、72 个技能命令、12 个自动化钩子的虚拟工作室。代理按三层组织：Opus 模型担任总监层负责愿景和架构决策，Sonnet 模型担任部门负责人管各自领域，Sonnet/Haiku 模型担任一线专家做具体实现。每个代理有明确职责、升级路径和质量门控。

它适合谁？我实测下来，最适合两类人：一是独立开发者或小团队，想用 AI 把游戏从概念推到可玩版本，但苦于没有流程约束；二是想研究多智能体协作编排的技术人，这个项目本身就是一份很好的"AI 组织架构"参考实现。它不是自动开发机，你仍然是每个决策的拍板人，代理负责提问、给选项、等你批准。

下面我会从环境准备、配置落地、协作流程验证到排障，完整走一遍。中间涉及模型调用和 API Key 的部分，我用 TaoToken 来做接入演示，因为它的接口格式和 Anthropic 官方一致，配置起来不用改代码。

2. 前置准备：Claude Code 安装与 TaoToken 接入配置

在开始编排 48 个代理之前，得先把 Claude Code 本身跑起来，并且让它能稳定调用模型。这一步很多人卡住，我踩过的坑主要在两个地方：一是 Claude Code 的安装路径，二是 API 接入的 Base URL 和 Key 配置。

先说安装。Claude Code 通过 npm 全局安装：

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

装完之后验证一下：

claude --version

能打印出版本号就说明 CLI 就绪了。接下来是接入配置。Claude Code 默认走 Anthropic 官方接口，但你可以通过环境变量把 Base URL 指向兼容接口。TaoToken 的 API 地址是https://taotoken.net/api，接口格式与 Anthropic 保持一致，所以 Claude Code 不需要任何代码改动，改环境变量就行。

在项目根目录创建.env或者直接写进 shell 配置。我习惯在项目里放一个.claude/settings.json，把环境变量和权限一起管起来。先看环境变量方式：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="你的TaoToken密钥"

密钥在 TaoToken 控制台的 API Keys 页面生成，地址是https://taotoken.net/console/api-keys。生成后复制出来，注意别提交到 git 仓库里，建议用.env文件并加进.gitignore。

如果你用的是 Claude Code 的 settings.json 配置方式，可以这样写：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的密钥" }, "permissions": { "allow": [ "Bash(git *)", "Read", "Write", "Edit" ] } }

这里有个细节要注意：Claude Code Game Studios 的钩子脚本会调用git commit、git push等命令，所以权限里得放行 Bash 的 git 操作，否则钩子会静默失败。我一开始没加，结果提交验证钩子一直不触发，排查了半天才发现是权限拦住了。

配置完成后，用一条最简单的请求验证连通性：

curl https://taotoken.net/api/v1/messages \ -H "x-api-key: 你的密钥" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-sonnet-4-20250514", "max_tokens": 64, "messages": [{"role": "user", "content": "回复 OK"}] }'

如果返回里能看到content字段和正常的文本，说明接入通了。这一步别跳过，后面 48 个代理全靠这条链路。

关于模型选择，Claude Code Game Studios 的代理定义里会指定model: opus、model: sonnet或model: haiku。TaoToken 支持这些模型 ID 的映射，你在控制台确认一下可用模型列表即可。总监层用 Opus 是因为要做重大创意和技术决策，需要更强的推理；一线专家用 Haiku 是因为任务明确、执行量大，用轻量模型控制成本。这个分层设计本身就是项目的一个亮点。

3. 克隆模板并落地 48 个代理的目录配置

环境通了之后，把工作室模板拉下来。项目地址在 GitHub 上，直接 clone：

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

进去之后先别急着跑，花两分钟看一下目录结构，这决定了后面所有配置往哪放：

my-game/ ├── CLAUDE.md # 主配置，代理和引擎设置在这 ├── .claude/ │ ├── settings.json # 钩子、权限、环境变量 │ ├── agents/ # 49 个代理定义（markdown + YAML frontmatter） │ ├── skills/ # 72 个斜杠命令 │ ├── hooks/ # 12 个钩子脚本 │ └── rules/ # 11 条路径范围编码标准 ├── design/ # GDD、叙事、关卡、UX ├── src/ # 游戏源码 ├── assets/ # 美术、音频、着色器、数据 ├── tests/ # 测试套件 └── production/ # 冲刺、里程碑、史诗

代理定义文件长这样，以gameplay-programmer.md为例：

--- name: gameplay-programmer description: 实现游戏玩法系统和功能代码 model: sonnet tools: Read, Glob, Grep, Write, Edit, Bash --- # Gameplay Programmer 你负责游戏玩法代码的实现。所有玩法数值必须外部化到配置文件， 禁止在代码中硬编码魔法数字。所有时间相关操作必须使用 delta time。

这个 frontmatter 里的model字段就是控制成本的关键。你可以把一些执行类代理改成haiku，把需要深度推理的保留sonnet或opus。我实测下来，把qa-tester、sound-designer、community-manager这类任务边界清晰的代理改成 haiku，整体 token 消耗能降不少，产出质量没有明显下降。

接下来配置引擎专家。项目内置了 Godot 4、Unity、Unreal Engine 5 三套专家代理。如果你做 2D 小游戏，Godot 是最轻的选择。在CLAUDE.md里指定：

## Engine Specialists - **Primary**: godot-specialist - **Language/Code Specialist**: godot-gdscript-specialist - **Shader Specialist**: godot-shader-specialist

如果你不用内置引擎，把对应的代理文件删掉，自己写一个。删除很简单：

rm .claude/agents/live-ops-designer.md

添加自定义代理就是新建一个 markdown 文件，按上面的 frontmatter 格式写。这里有个容易忽略的点：代理的tools字段决定了它能调用哪些工具。如果你给一个只做文档的代理开了Bash，它可能会去跑一些你不想让它跑的命令。最小权限原则在这里同样适用。

路径规则系统也值得配置一下。.claude/rules/里的规则会在编辑匹配路径的文件时自动生效。比如gameplay-code.md的规则是：

--- globs: src/gameplay/** --- # Gameplay Code Rules - 所有玩法数值必须外部化到配置文件 - 禁止硬编码魔法数字 - 所有时间相关操作必须使用 delta time - 玩法代码不得直接引用 UI 组件

这意味着当代理去改src/gameplay/下的文件时，这些规则会自动注入到它的上下文里。这是保证多代理协作不跑偏的核心机制之一，比在每个代理提示词里重复写规则要优雅得多。

配置审查强度也在这一步做。项目支持三种模式：full（所有总监门控）、lean（仅阶段门控）、solo（无门控）。新手建议先用lean，不然每个决策都弹总监审查会很累：

echo "lean" > production/review-mode.txt

4. 验证多智能体协同：从 /start 到第一个可玩原型

配置就绪后，进入项目目录启动 Claude Code：

claude

第一次会话，直接输入/start。这个技能会问你当前处于什么状态：没有想法、模糊概念、清晰设计、还是已有工作。它不做假设，根据你的回答引导到对应工作流。我建议第一次拿一个超轻量的小游戏练手，比如"一个用方向键控制方块躲避下落障碍物"这种，目的是把整个流程跑通，而不是真的做一款游戏。

假设你选了"模糊概念"，系统会引导你走概念阶段。核心命令是/brainstorm，它用 MDA 框架、自我决定理论和 Bartle 玩家类型来引导创意。你会看到类似这样的交互：

creative-director: 你希望玩家在游戏中获得什么核心情感体验？ 选项 A：紧张刺激的躲避快感 选项 B：解谜后的成就感 选项 C：探索未知的好奇心

你选一个，代理继续往下问。注意，每个决策都是你做的，代理只负责提问和展示选项。这就是项目强调的"协作系统而非自动执行系统"。

概念确定后，用/setup-engine配置引擎和版本，然后/map-systems把概念拆成系统并排依赖顺序。接着进入系统设计阶段，用/design-system逐个写 GDD。每个 GDD 必须包含 8 个章节：概述、玩家幻想、详细规则、公式、边缘情况、依赖、调参旋钮、验收标准。这个强制结构是保证后续实现不跑偏的关键。

到了预制作阶段，用/prototype在隔离工作树里构建一次性原型验证核心机制。这一步很重要，因为原型代码和正式代码是隔离的，prototypes/目录下的标准会放宽，允许你快速试错。验证完乐趣之后，用/create-epics和/create-stories把设计转成可实现的故事文件。

制作阶段就是循环执行：/sprint-plan计划冲刺，/story-readiness验证故事是否准备好，/dev-story实现故事（它会自动路由到正确的程序员代理），/code-review做架构审查，/story-done关闭故事。

这里验证多智能体协同是否真的在工作，有个很直接的观察点：当你运行/dev-story实现一个战斗系统时，看看它调用了哪些代理。正常情况下，gameplay-programmer会负责核心逻辑，ai-programmer会处理敌人行为，technical-artist会处理特效，sound-designer会列出音效事件。你可以在会话日志里看到代理的调用记录，log-agent.sh钩子会自动记录每次子代理调用的时间戳。

验证产出是否协同的另一个方法是跑/consistency-check，它会扫描所有 GDD 和实体注册表，检测跨文档不一致。如果战斗系统 GDD 里写的伤害公式和数值配置表里的对不上，这个命令会标出来。我实测下来，这个检查在项目超过 5 个系统之后特别有用，人脑根本记不住所有交叉引用。

5. 常见报错排查：401、代理不触发与钩子静默失败

配置和运行过程中，最容易撞上的几类问题我整理一下，都是真实遇到过的。

401 认证失败。最常见的原因是ANTHROPIC_API_KEY没生效。先确认环境变量在当前 shell 里能打印出来：

echo $ANTHROPIC_API_KEY

如果是空的，说明.env没被加载，或者你写在了别的 shell 配置里。Claude Code 读取的是进程环境变量，不是项目里的.env文件自动加载。你可以在启动前手动 source，或者写进~/.bashrc/~/.zshrc。另一个原因是 Base URL 写错了，注意是https://taotoken.net/api，不要多加/v1，Claude Code 会自己拼路径。

代理不触发，/dev-story直接自己写了代码。这通常是因为代理定义文件的 frontmatter 格式有问题。YAML frontmatter 必须以---开头和结尾，name、description、model、tools四个字段缺一不可。如果model写了一个不存在的值，代理会静默回退到默认模型，但路由逻辑可能失效。检查方法是用/skill-test验证技能文件结构合规性。

钩子静默失败。钩子设计为快速失败，如果命令不匹配就exit 0。但如果你发现git commit时validate-commit.sh完全没反应，先检查.claude/settings.json里的权限配置有没有放行Bash(git *)。另一个可能是钩子脚本没有执行权限：

chmod +x .claude/hooks/*.sh

reading choices相关报错。这个通常出现在模型返回格式不符合预期时，比如代理提示词里要求输出特定结构但模型没遵守。排查方法是看会话日志里该代理的原始输出。如果频繁出现，考虑把该代理的模型从 haiku 升到 sonnet，haiku 在复杂指令遵循上确实弱一些。

OAuth 相关报错。如果你之前登录过 Anthropic 官方账号，Claude Code 可能缓存了 OAuth token，导致它优先走官方认证而不是你的 API Key。清理方法是删除~/.claude/下的认证缓存文件，然后重新用 API Key 启动。

local proxy failed。这个报错说明 Claude Code 尝试走本地代理但没找到。检查你的 shell 里有没有残留的HTTP_PROXY/HTTPS_PROXY环境变量，有的话 unset 掉。Claude Code 直连https://taotoken.net/api即可，不需要额外代理层。

排查完这些，如果还有问题，用/help命令，它会读取当前阶段并显示下一步该做什么，同时把当前项目状态打印出来，对定位问题很有帮助。

6. 把工作室跑起来：从练手项目到正式创意

整套流程走下来，我的建议是分两步走。第一步，拿一个你完全不在意的小游戏练手，比如"点击屏幕让小鸟穿过管道"这种，目的是把/start→/brainstorm→/design-system→/prototype→/dev-story这条链路跑通，熟悉每个命令的产出物长什么样。这一步不要追求游戏好玩，追求的是流程顺畅。

第二步，等你对工作流有感觉了，再正式构思你的游戏创意。这时候你会发现，前面练手时建立的目录结构、规则配置、代理组合，可以直接复用。你只需要重新跑概念和设计阶段，制作阶段的流程是一样的。

关于成本控制，48 个代理全开确实会消耗不少 token。几个实用的降本技巧：把执行类代理的模型改成 haiku；用lean审查模式减少总监门控调用；在/dev-story时只激活当前故事需要的代理，而不是全部。项目本身支持按需精简，小型项目可能只需要game-designer、gameplay-programmer和qa-tester三个代理就能跑起来。

如果你在接入模型时想要一个和 Anthropic 接口完全兼容、配置不用改代码的方案，可以试试 TaoToken 的 API 接入，密钥在控制台生成后直接填进环境变量即可。模型对话调试可以在https://taotoken.net/models先验证模型可用性，长期做编码和 Agent 编排的话 Coding Plan 会更划算。接入文档在https://taotoken.net/doc，里面有各语言的调用示例。

最后说一个我自己的体会：这个项目最大的价值不是"48 个代理"这个数字，而是它把真实工作室的质量门控和协作协议用代码固化下来了。代理会提问、会展示选项、会等你批准，这个"不擅自行动"的设计，恰恰是让 AI 辅助开发从玩具走向工程的关键。你先拿小项目把流程跑顺，再往大了做，会稳很多。