不需要 Codex 也能用:Chromatic 插件的 Claude Code 社区移植版
上一期讲过 ModRetro×OpenAI 的 Codex 掌机——很多玩家的遗憾是"得先花 200 美元买硬件才能用插件"。现在社区开发者李笑林把官方插件移植到了 Claude Code,让这套工作流可以直接装进你已有的工具箱。
本文依据
基于仓库 lixiaolin94/modretro-chromatic-claude 的 README 全文分析。项目定位:OpenAI DevDay 2026 发布的 ModRetro Chromatic Plugin for Codex(MIT 许可)的 Claude Code 社区移植版;非官方移植,与 ModRetro、OpenAI 无关联、未获背书。
它能做什么
和官方 Codex 版一致:用自然语言做 Game Boy / Game Boy Color 游戏(底层是 GB Studio 工程),在浏览器和 PyBoy 模拟器里试玩,再串流或烧录到 ModRetro Chromatic 掌机。内置 6 个技能:
| 技能 | 用途 |
|---|---|
| /modretro-chromatic:new-game | 从想法到可玩预览的一条龙入口 |
| /modretro-chromatic:authoring | 场景、角色、事件、对话、碰撞、变量 |
| /modretro-chromatic:pixel-art | 像素画(文本网格 ⇄ PNG)、调色板、瓦片预算 |
| /modretro-chromatic:rom-debugging | 构建、ROM 检查、PyBoy 逐帧试玩与调试 |
| /modretro-chromatic:deployment | 连接 Chromatic、串流试玩、烧录卡带、采集画面 |
| /modretro-chromatic:setup | 依赖安装与故障诊断 |
安装与使用
需要 Node.js 22+。在 Claude Code 里两条命令完成安装:
/plugin marketplace add lixiaolin94/modretro-chromatic-claude
/plugin install modretro-chromatic@modretro-chromatic-claude
然后直接 /modretro-chromatic:new-game 一个园丁收集三颗种子、种下后打开大门的小探索游戏——或者干脆说"帮我做一个 Game Boy 游戏",Claude 会自动调用对应技能。首次构建会自动安装 GB Studio CLI 4.3.2、GBDK 4.5.0、PyBoy 等开源依赖(与 Codex 版共用目录,装过直接复用)。预览方面:Claude 桌面版直接在内置 Browser 面板打开官方 Binjgb 播放器,终端版给出本地 URL。
移植版的独门增强:文本网格像素画
Codex 版的像素画依赖其内置图像生成;移植版没有这个私有 API,作者的解法非常聪明——新增 pixel-grid.mjs:Claude 用文本网格逐像素作画,再渲染成 PNG 并输出放大预览,附带 GB 硬件约束检查。字符画天生就是"所见即所得"的图块数据,这反而成了比图像生成更可控的方案。
与 Codex 版的差异(全表)
| 维度 | Codex 版 | Claude 移植版 |
|---|---|---|
| 插件格式 | .codex-plugin | .claude-plugin + .mcp.json + skills + hooks |
| MCP 工具 | 81 个 | 原样复用(仅改 "Codex" 措辞) |
| 浏览器预览 | Codex 内置浏览器 | Claude 桌面版 Browser 面板 / 终端版给 URL |
| 像素画 | 内置生图 + 网格识别 | 新增 pixel-grid.mjs 文本网格作画(增强) |
| Annotate game 注释 | 依赖 Codex 浏览器私有 API | 不可用,改用截图/模拟器帧/文字描述 |
| Chromatic CLI(闭源) | 随插件内嵌 | 不分发;经用户同意后从 npm 官方源下载并按 SHA-256 校验 |
| 画面采集 | macOS / Linux | 仅 macOS(Linux 依赖的 FFmpeg 为私有补丁版本) |
安全设计:值得抄的三处细节
工程与合规亮点
①闭源的 ModRetro CLI 不随插件分发——首次使用征求同意后从 npm 官方源下载,按上游记录的 SHA-256 逐字节校验;②"插件和 Claude 永远不会索要或处理激活码"——开发者模式激活仍由用户在官方更新器手动完成;③首次烧录前明确告知"会擦除卡带数据、存档可能丢失"并取得同意,且只烧自制游戏、拒绝商业游戏。
真机需求一览:串流、烧录、画面采集需要 ModRetro 的闭源 chromatic-cli;烧录卡带需要开发者模式激活(官方 Firmware Updater 里 Cmd-I 输入激活码)。
对 R36S 玩家:这套工作流产出的 GB/GBC ROM 同样可以直接拷进 TF2 卡游玩(流程见 添加游戏教程)——Chromatic 烧录是可选的"实体仪式",不是必需品。完整工作流拆解见 下篇。