1. 一个人做微信小游戏，为什么先搭 ECS 骨架再写玩法

微信小游戏这个赛道，对个人开发者最友好的地方在于：不用上架 App Store，不用等审核排期，写完点一下「预览」就能在手机上跑。但真正动手之后你会发现，卡住进度的往往不是玩法本身，而是「代码写到第三个功能就乱成一团」。我见过太多个人项目，第一版能跑，加第二个武器系统就开始改一处崩三处。

这篇要解决的就是这个问题：用 Claude 先把 ECS 架构想清楚，再用 Trae 把微信小游戏骨架生成出来，最后把 Trae 里的模型调用统一改到 TaoToken 的 Key/API 通道。整套流程走完，你会得到一个能跑通、能扩展、接口连通性验证过的小游戏骨架。

先说清楚 ECS 是什么，用一句话类比：传统 OOP 像「家族继承」，僵尸必须继承 Character 才能有血量；ECS 像「乐高积木」，实体只是一个空壳 ID，想要血量就插一块 HealthComponent，想要移动就插一块 MoveComponent，系统负责遍历所有带某组件的实体去执行逻辑。这样加新能力就是「加一块积木」，而不是「改族谱」。

适合谁看：有 JavaScript 基础、想做微信小游戏但没搭过工程结构的个人开发者；已经在用 AI 写代码、但每次生成完不知道怎么组织文件的同学；以及想把模型调用收敛到一个统一通道、不想在多个平台之间来回切 Key 的人。

整篇的节奏是：先讲清楚 Claude 做架构设计时该给它什么提示词，再讲 Trae 生成骨架后目录长什么样，然后重点落在「怎么把 Trae 的模型请求改到 TaoToken」——这一步会给出可复制的配置片段和验证命令。最后把几个真实会撞上的报错摊开讲，包括 401、local proxy failed、reading choices 这几类。

我试过把架构设计和编码实现混在一起让一个工具做，结果是它既想不清楚又写不干净。分开之后，Claude 负责「想清楚」，Trae 负责「动手做」，效率差别很明显。

2. TaoToken 前置准备：统一 Key 与 API 通道怎么配

在动 Trae 之前，先把 TaoToken 这条通道准备好。为什么要单独做这一步？因为 Trae 默认可能走的是它自带的模型通道，而你想让项目里的模型调用统一走一个 Key、一个 Base URL，方便后面换模型、算成本、做多项目隔离。TaoToken 在这里扮演的就是「统一入口」的角色。

先明确三个东西，后面配置里会反复出现：

• Base URL：https://taotoken.net/api，这是所有请求的前缀，注意不要带 UTM 参数，配置里写干净的地址。
• API Key：在控制台生成，形如sk-开头的一串字符，只显示一次，生成后立刻复制存好。
• Model ID：你要调用的具体模型标识，比如claude-sonnet-4-5这类，填错会直接报模型不存在。

获取 Key 的路径是：打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，登录后进控制台，找到 API Keys 页面新建一个。控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API Keys 管理页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。建议给每个项目单独建一个 Key，命名带上项目名，比如wechat-zombie-game，这样后面看用量能分清是哪个项目在烧。

这里有个容易踩的点：很多人拿到 Key 之后直接往代码里硬编码，然后提交到 Git。正确做法是放进环境变量或者本地配置文件，并且把配置文件加进.gitignore。Trae 的项目里我会建一个.env.local，里面写：

TAOTOKEN_API_KEY=sk-你的key TAOTOKEN_BASE_URL=https://taotoken.net/api TAOTOKEN_MODEL=claude-sonnet-4-5

然后在.gitignore里加一行.env.local。这样即使后面把项目传到 GitHub，Key 也不会泄露。

如果你用的是 Claude Code 这类命令行工具，它的配置方式不太一样，需要走 Anthropic 兼容的接入方式，可以参考接入文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 里的说明。文档里把不同客户端的配置都列了，包括 Claude Code、Cline、Codex 这几类，按你的工具对号入座就行。

还有一个概念要提前说清楚：TaoToken 是模型调用的统一通道，不是「代理」也不是「中转」这种灰色说法，它就是一个正常的 API 服务入口，你把它理解成「一个 Base URL 加一个 Key 就能调多个模型」即可。配置的时候只填 Base URL 和 Key，不要填任何额外的网络层参数。

准备阶段做完，你手上应该有三样东西：一个可用的 API Key、确认过的 Base URL、以及你要用的 Model ID。这三样凑齐，下一节就能直接往 Trae 里填了。

3. 可复制配置：Trae 项目骨架与 TaoToken 接入参数

这一节是整篇最实操的部分。先让 Claude 出架构，再让 Trae 生成骨架，最后改配置。

3.1 给 Claude 的架构提示词

把下面这段直接贴给 Claude，让它输出 ECS 的模块划分和目录结构：

我要做一个微信小游戏，俯视角僵尸塔防射击，纯 Canvas 2D 不用引擎。 核心玩法：白天部署防御塔和道具，夜晚僵尸波次进攻，玩家自动射击防守。 要求： 1. 用 ECS（Entity-Component-System）架构，实体只存 ID 和组件列表 2. 组件只存数据，系统只存逻辑 3. 给出完整的目录结构，按功能域分层 4. 说明事件总线和服务定位器怎么用 5. 预判 3 个最容易踩的性能坑

Claude 会给你一份带目录树的方案。核心目录大概长这样，你可以照着建：

game/ ├── game.js ├── game.json ├── project.config.json └── js/ ├── main.js ├── core/ │ ├── entity.js │ ├── component.js │ ├── eventBus.js │ └── serviceLocator.js ├── entities/ │ ├── player.js │ └── monster.js ├── systems/ │ ├── moveSystem.js │ ├── damageSystem.js │ └── renderSystem.js ├── world/ │ └── world.js └── data/ └── weaponData.js

关键点是core/放基础设施，entities/放实体定义，systems/放逻辑，data/放数值配置。这样分层之后，加一个新武器只需要在data/weaponData.js加一条记录，加一个新系统只需要在systems/新建文件。

3.2 Trae 里的模型配置

Trae 支持自定义模型通道。打开设置，找到模型配置那一栏，把三个字段填上：

{ "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的key", "model": "claude-sonnet-4-5" }

如果你用的是 Trae 的配置文件方式（部分版本支持settings.json），路径通常在用户目录下的.trae/settings.json，内容写成：

{ "models": { "custom": { "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的key", "modelId": "claude-sonnet-4-5" } } }

注意baseUrl结尾不要带斜杠，modelId要和 TaoToken 支持的模型标识完全一致。填完之后 Trae 的模型请求就会走 TaoToken 这条通道。

3.3 微信小游戏的 game.json 配置

骨架跑起来还需要game.json，横屏和网络超时都要配：

{ "deviceOrientation": "landscape", "networkTimeout": { "request": 10000, "connectSocket": 10000, "uploadFile": 10000, "downloadFile": 10000 }, "workers": "workers" }

deviceOrientation设成landscape是横屏游戏必须的，不设的话真机上触摸坐标会错乱。networkTimeout里的request设 10 秒，是因为模型调用有时候会慢，超时太短会误报失败。

3.4 三件套对照表

把 Base URL、Key、Model ID 这三件套整理成一张表，配置的时候对着填：

这三样在 Trae、Claude Code、Cline 里的填法大同小异，区别只是字段名。Claude Code 走的是 Anthropic 兼容格式，需要设ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY两个环境变量，具体看接入文档。

配置改完之后，先别急着写玩法，下一节先验证接口能不能通。

4. 验证请求：骨架跑通与接口连通性检查

配置填完不代表能用，必须验证。这一步分两个层面：先验证 TaoToken 通道本身通不通，再验证 Trae 生成的骨架能不能跑。

4.1 用 curl 验证通道

最直接的方式是用 curl 打一个请求，看返回：

curl -X POST https://taotoken.net/api/v1/messages \ -H "Content-Type: application/json" \ -H "x-api-key: sk-你的key" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "claude-sonnet-4-5", "max_tokens": 64, "messages": [{"role": "user", "content": "回复 ok"}] }'

如果返回里能看到content字段和一段文本，说明通道是通的。如果返回 401，检查 Key 有没有复制全、有没有多余空格。如果返回模型不存在，检查 Model ID 拼写。

4.2 在 Trae 里发一条测试请求

Trae 的对话窗口里直接发一句「用一句话说明 ECS 架构」，如果它能正常回复，说明 Trae 已经走通了 TaoToken 通道。这时候你可以让它生成第一个文件，比如：

在 js/core/entity.js 里写一个 Entity 基类，要求： 1. 构造函数接受一个 cfg 对象 2. 内部维护 components 数组 3. 提供 addComponent、getComponent、hasComponent 三个方法 4. 用 ES6 class 写法

Trae 生成完之后，检查一下文件路径对不对、方法名有没有拼错。

4.3 跑通小游戏骨架

在微信开发者工具里打开项目，点「编译」。如果控制台没有红色报错，模拟器里能看到一个空白画布，说明骨架跑通了。这时候在main.js里加一行日志：

console.log('game boot ok', Date.now());

重新编译，控制台能看到这行日志，就说明入口文件执行正常。

4.4 验证模型调用在游戏里也能用

如果你想在小游戏里直接调模型（比如做动态难度），可以用wx.request发请求：

wx.request({ url: 'https://taotoken.net/api/v1/messages', method: 'POST', header: { 'Content-Type': 'application/json', 'x-api-key': 'sk-你的key', 'anthropic-version': '2023-06-01' }, data: { model: 'claude-sonnet-4-5', max_tokens: 128, messages: [{ role: 'user', content: '生成一个僵尸波次配置' }] }, success(res) { console.log('model resp', res.data); }, fail(err) { console.error('model fail', err); } });

注意微信小游戏里请求域名需要在game.json或后台配置里加白名单，taotoken.net要加进去，否则真机上会请求失败。开发者工具里可以勾选「不校验合法域名」先测通，上线前再去后台配。

验证通过的标准是：curl 能返回文本、Trae 能正常对话、小游戏能编译、wx.request能拿到content。四个都过，骨架就算真正跑通了。

5. 常见报错排查：401、local proxy failed、reading choices

这一节把真实会撞上的报错摊开讲。每个报错给出触发场景和修复方式。

5.1 401 Unauthorized

最常见。触发场景有三种：Key 没填、Key 填错、Key 前面多了空格。排查顺序是先看配置里的 Key 是不是sk-开头，再看有没有复制到换行符。用 curl 单独测一次，如果 curl 也 401，那就是 Key 本身的问题，去控制台重新生成一个。

还有一种情况是 Base URL 写成了https://taotoken.net/api/（结尾带斜杠），有些客户端拼接路径时会变成双斜杠导致鉴权失败。改成不带斜杠的https://taotoken.net/api。

5.2 local proxy failed

这个报错通常出现在客户端尝试走本地代理但代理没起来的时候。触发场景是你之前配过某个本地代理端口，后来关掉了但配置没清。修复方式是检查 Trae 或 Claude Code 的配置里有没有proxy相关字段，有的话删掉。TaoToken 的接入不需要任何本地代理，Base URL 直接填https://taotoken.net/api即可。

如果配置里确实没有代理字段但还是报这个错，检查系统环境变量里有没有HTTP_PROXY、HTTPS_PROXY，有的话临时清掉再试。

5.3 reading choices 报错

这个报错一般出现在解析响应的时候，提示读取choices字段失败。原因是请求发出去之后，返回的结构和你预期的不一样。比如你用 OpenAI 格式的解析代码去解析 Anthropic 格式的响应，就会找不到choices。

修复方式是确认你调用的接口格式。TaoToken 的/api/v1/messages走的是 Anthropic 格式，响应里是content数组，不是choices。如果你的代码里写的是res.data.choices[0]，改成res.data.content[0].text。

5.4 OAuth 相关报错

如果你用的是 Claude Code 这类需要登录的工具，可能会撞上 OAuth 报错。触发场景是工具尝试走 OAuth 登录流程，但你配的是 API Key 模式。修复方式是在配置里明确指定用 API Key，不要触发登录流程。Claude Code 里需要设ANTHROPIC_API_KEY环境变量，并且不要执行登录命令。

5.5 模型不存在

报错信息里会带模型名。触发场景是 Model ID 拼错，或者你用的模型在当前通道不支持。去接入文档里核对支持的模型列表，把 Model ID 改成列表里的值。

5.6 真机上请求失败但开发者工具正常

这是微信小游戏的域名白名单问题。开发者工具里可以勾「不校验合法域名」，真机不行。去微信公众平台后台，把https://taotoken.net加到 request 合法域名里。注意要加 https 前缀，且不能带路径。

排查的时候记住一个原则：先隔离变量。用 curl 测通道，用 Trae 测客户端，用开发者工具测小游戏，一层一层排除。哪一层报错就修哪一层，不要混在一起猜。

6. 把通道固定下来，继续往下写玩法

骨架跑通之后，最重要的事情是「别再动配置」。很多个人项目死在反复折腾环境上，今天换个 Key，明天改个 Base URL，结果玩法一行没写。

我的建议是把三件套写进一个config.js，所有地方引用它：

// js/config.js export const MODEL_CONFIG = { baseUrl: 'https://taotoken.net/api', apiKey: process.env.TAOTOKEN_API_KEY, model: 'claude-sonnet-4-5' };

这样以后换模型只改一个地方。如果你后面要长期做编码和 Agent 类任务，可以考虑用 Coding Plan 这类按周期计费的方式，地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，适合调用量稳定的场景。如果只是想先验证模型效果，用模型对话页 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 直接试就行。

接下来你要做的是：在systems/里加第一个系统，比如moveSystem.js，让它遍历所有带MoveComponent的实体更新位置。然后加renderSystem.js，把实体画到 Canvas 上。这两个系统跑起来，你就能看到一个方块在屏幕上移动——这就是最小可玩版本。

从这一步往后，每加一个功能都是「加组件、加系统、注册事件」，不会再出现改一处崩三处的情况。ECS 的价值就在这里：它让扩展变成加法，而不是改法。

最后留一个实用技巧：每次让 Trae 写新模块之前，把 Claude 给的架构文档相关章节、已有代码、当前需求三样一起贴进去。上下文给够，生成质量会明显不一样。这个习惯坚持下来，一个人做完整款小游戏是完全可行的。