QuickDesign CI实战：token环境变量配置完整指南（claude-plugins-community）-平芜编程栈

QuickDesign CI实战：token环境变量配置完整指南（claude-plugins-community）

【免费下载链接】claude-plugins-communityCommunity plugin marketplace for Claude Cowork and Claude Code. Read-only mirror — submit plugins at clau.de/plugin-directory-submission.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-plugins-community

在 claude-plugins-community 社区插件市场中，QuickDesign 是最受欢迎的 AI 媒体生成插件之一。本文带你快速掌握在 CI 流水线中使用 QuickDesign 的关键——QUICKDESIGN_TOKEN等 token 环境变量的正确配置方法，让你无需浏览器登录，就能在无人值守的构建环境中完成图片与视频生成。

什么是 QuickDesign：把终端变成 AI 媒体工厂

QuickDesign 是一个为 Claude Code 设计的社区插件，它把 quickdesign 命令行工具封装成完整技能，支持一键生成 AI 图片（Nano Banana、GPT Image）和 AI 视频（Seedance 2.0、Kling、Sora 2），还能做竞品广告分析、品牌 DNA 提取和智能广告批量创建。

它的核心特点是对脚本和 CI 极其友好：JSON 输出到 stdout、诊断信息到 stderr、提供明确的退出码，可以直接嵌入流水线。技能文档的入口文件见 SKILL.md。

git clone https://link.gitcode.com/i/bea9b2df2bb9cdc50aaebe3aa3f570f3

为什么 CI 中必须用 token 环境变量

本地使用时，QuickDesign 通过浏览器 OAuth 完成登录，token 会写入本地配置文件~/.config/quickdesign/auth.json（权限 0600），后续命令会自动刷新会话。

但在 CI 环境里，没有浏览器、没有终端交互，传统的quickdesign login流程会直接卡住。好在官方提供了专门的 CI 认证方案：通过环境变量注入 token，完全跳过浏览器握手。这也是 README.md 中 "For CI, skip the browser entirely" 一节的核心内容。

三种 CI 认证方式（任选其一）

方式一：QUICKDESIGN_TOKEN 环境变量（推荐）

最简单直接——在 CI 的 Secrets 中配置好 token，运行时注入即可：

QUICKDESIGN_TOKEN=<你的supabase-jwt> quickdesign spy brands

这个变量会优先覆盖本地auth.json中存储的 token，适合临时切换账号或做多环境测试。

方式二：login --token 写入本地配置

quickdesign login --token <你的supabase-jwt>

适合希望在 CI 容器内"登录一次、后续命令复用"的场景，token 会写入标准配置路径。

方式三：stdin 管道注入（最安全）

cat my-token.txt | quickdesign login --token-stdin

token 不进命令行参数，不会被进程列表或 shell 历史泄露，适合对安全要求较高的企业流水线。

QuickDesign 环境变量速查表

变量名	作用
`QUICKDESIGN_TOKEN`	覆盖存储的 token（优先级高于`auth.json`）
`QUICKDESIGN_BASE_URL`	覆盖 API 地址，本地开发时可指向`http://localhost:3001`
`QUICKDESIGN_SUPABASE_URL`	覆盖 Supabase REST 地址，仅`design`子命令使用
`QUICKDESIGN_SUPABASE_ANON_KEY`	Supabase API 密钥，用于设计资产管理与 token 刷新

💡 小技巧：本地调试 CI 问题时，可以同时设置QUICKDESIGN_BASE_URL和QUICKDESIGN_TOKEN，把请求指向本地 BFF 服务快速复现问题。

CI 安装最佳实践：init --no-auth

安装插件技能时，官方明确要求 CI 场景跳过浏览器登录：

npm install -g @quickdesign/cli quickdesign init --no-auth # CI / 脚本化安装专用

这里有一个重要细节：npm install之后init不会自动运行——这是刻意设计，避免在 CI 中静默破坏~/.claude/skills/目录。你可以在 CI 中按需拆分：--skill-only只装技能、--no-doctor跳过 ffmpeg 检测。

用 whoami 验证 token 是否生效

配置完成后，先做一次健康检查再跑生成任务：

quickdesign whoami

它会显示当前用户、token 过期时间和一次实时连通性 ping。如果这一步通过，后续的生成命令基本不会在认证上翻车。

常见坑点与排查

忘记设置 token 就运行：命令会读取auth.json失败并报错。CI 中务必以环境变量方式显式注入，不要依赖本地登录状态。
把 token 写进代码仓库：请务必使用 CI 平台的 Secrets 机制注入，token 泄露意味着账号资产（credit 额度）面临风险。
视频任务超时：视频生成通常需要 5–15 分钟，建议用"提交任务 → 记录 request id → 稍后quickdesign video wait恢复轮询"的模式，而不是让 CI 一直阻塞等待。相关最佳实践可参考技能中的 ugc-video.md。
确认门在 CI 中的行为：技能文档规定付费生成前必须输出"计划摘要"（Plan Summary），即使在自动模式下也不会跳过——CI 中建议预先在请求里带上--yes之类的确认标记。详见 confirmation-rules.md。