Codex Plugin
在 Codex 中通过对话创建、修改和分析二维码，内置场景工作流与 CodeBox MCP
简介
CodeBox Codex Plugin 将二维码生成、模板匹配、动态链接和扫码统计封装成对话式工作流。安装后可以直接描述业务目标，Codex 会整理需求、搜索模板、展示执行计划，并在需要积分或修改现有数据时先请求确认。
如果还没有明确需求，也可以说“启动 CodeBox，先告诉我你能做什么”。Plugin 会先在内置浏览器打开空白的完整编辑器，不创建二维码、不占用静态码额度，也不消耗积分；随后在 Codex 中介绍二维码制作与设计、动态投放与数据优化、批量运营与交付三类能力，再询问你已有的链接、文案、Logo、品牌色和投放场景。
与直接连接 MCP 相比，Plugin 额外提供：
- 根据用途自动推荐静态码或动态码
- 餐饮菜单、活动推广、社媒引流、打印物料等场景化模板匹配
- 生成前展示名称、链接、模式、模板、纠错等级和积分成本
- 在同一段对话中继续修改动态链接或查询扫码效果
- 批量操作、删除和积分消费前的确认保护
- 针对额度、权限、模板和部分批量失败的恢复流程
安装
1. 添加 Marketplace 并安装
从 GitHub 安装：
codex plugin marketplace add gdfsdjj145/codebox
codex plugin add codebox@personal在 CodeBox 仓库本地开发时：
codex plugin marketplace add /path/to/codebox
codex plugin add codebox@personal安装完成后重新打开 Codex 或新建任务，让新的 Skill 和 MCP 工具进入上下文。
2. 登录 CodeBox
首次使用时，在 Codex 中直接说“生成一个二维码”。Codex 会打开 CodeBox 登录：
- 浏览器已经登录过 CodeBox：自动完成连接并返回 Codex
- 尚未登录：显示现有微信扫码登录，扫码成功后自动继续连接
不需要创建、复制或配置私人 API Key。Codex 会安全保存短期访问令牌，并在需要时自动刷新。
实际交互流程
- 用户在 Codex 说“帮我生成二维码”。
- CodeBox Plugin 自动识别请求。
- 未登录时，Codex 内置浏览器打开 CodeBox 微信扫码登录；已经登录则直接继续。
- Codex 调用 CodeBox 创建二维码。
- 内置浏览器自动打开 CodeBox 完整编辑器并载入真实结果。
- 用户可以继续在 Codex 对话修改，也可以直接点击编辑器调整。
先启动，再逐步制作
在 Codex 中选择或输入：
启动 CodeBox，打开编辑器，先告诉我你能做什么，再问我有哪些素材、想做什么二维码。CodeBox 会先打开完整编辑器并介绍三类能力：
- 二维码生成与设计：网址、文本、Wi-Fi 等类型，以及模板、配色、码点、Logo、背景、纠错、扫码检测和印刷尺寸
- 动态投放与优化：可更换目标链接、UTM、有效期、扫码统计、设备与地域洞察
- 批量运营与交付：渠道版本、已有二维码管理、扫码明细导出、下载以及 API/MCP 工作流
接着 Codex 会询问已有材料和目标；收到具体内容后才开始创建。制作过程中可以继续用自然语言逐步修改，也可以随时进入已打开的 CodeBox 编辑器，像传统二维码编辑器一样直接调整内容、模板、颜色、码点、Logo、背景、纠错等级、检测和下载设置。
授权由 Codex MCP Host 处理并在原任务中继续，不需要运行 CLI 登录、复制回调地址或新建私人 Key。聊天只发生在 Codex，CodeBox 浏览器页面只负责完整预览和编辑。
生成成功后，Codex 会复用当前内置浏览器中的 CodeBox 标签页，直接打开官网现有二维码编辑器。页面完整保留实时二维码、类型、内容、模板、颜色、码点、Logo、背景、扫描检测和下载等原有能力，不再显示 Agent 对话栏，也不维护另一套精简参数面板。预览 URL 只包含二维码 ID 与尺寸，不会暴露二维码正文或 Wi-Fi 密码。
编辑器载入的是 MCP 刚创建的同一二维码；用户点击常用视觉参数后会自动保存，继续在 Codex 中说“改成黑金、圆点、1200px”时，Codex 也会更新同一 ID 并刷新当前标签页。网页点击和 Codex 指令因此共享同一个项目状态，只有明确要求下载时才导出本地 PNG。
使用示例
生成活动二维码
给 8 月深圳开发者大会做一个海报二维码，
链接是 https://example.com/shenzhen，科技蓝风格，需要统计扫码效果。CodeBox 会推荐动态码、搜索合适模板，并在展示 10 积分成本后等待确认。
连续修改
把刚才二维码的链接换成 https://example.com/shenzhen-2026，名字改成“深圳大会最终版”。Codex 会沿用上一条二维码 ID，不需要重新查找或创建。
批量生成渠道码
为小红书、抖音和线下海报分别生成一个渠道二维码，统一使用暖色活动风格。Plugin 会先列出数量、名称、模式和模板，确认后调用批量生成。
查询效果
看看刚才活动二维码最近 30 天效果怎么样，给我三个优化建议。安全和计费
- 静态码不消耗积分，但占用月度静态码额度。
- 动态码每次创建消耗 10 积分；Plugin 会在调用前明确展示成本。
- 更新、删除和批量创建需要用户确认。
- Codex Plugin 使用 OAuth 2.1 + PKCE，通过现有 CodeBox 登录会话授权，不读取私人 API Key。
- 访问令牌仅对 CodeBox MCP 有效，短期过期；刷新令牌轮换并支持撤销。
- 所有涉及用户二维码的操作都由服务端继续执行归属与权限验证。
排查问题
找不到 CodeBox 工具
codex plugin list
codex mcp list确认 codebox 已安装并启用，然后新建一个 Codex 任务。
鉴权失败
在 Codex 中重新连接 CodeBox；浏览器会打开现有登录页。已经登录的账号会直接完成授权，未登录账号扫码后自动继续。
如果此前授权页提示客户端无效或回调地址不匹配，请先升级到最新部署，再执行 codex mcp logout codebox 后重新连接。CodeBox 会重新注册 Codex 客户端，不需要创建 API Key。
额度不足
前往额度充值查看余额。Plugin 不会在额度错误后自动重复调用。