03 · 接上你已经在用的 Agent
OpenDesign 自己不生成任何东西。真正干活的是你指给它的那个 Agent。这一步配错，后面每一页都是空的。
适配器是什么
每个适配器就是一层很薄的转接：把某个 Agent 的原生消息格式，翻成 OpenDesign 的技能协议。加一个新 Agent 是加一个文件，不用 fork 整个项目。
好处是换 Agent 不返工。同一份「SKILL.md」和同一份「DESIGN.md」，在 Claude Code 上跑和在 Codex 上跑是一样的。换 Agent 是改一行配置，不是重做一遍设计。
21 个适配器，先挑一个
完整表在 参考 / Agent 适配器对照表，这里只说怎么挑：
| 你的情况 | 建议 |
|---|---|
| 已经在付 Claude 订阅 | Claude Code，直接用订阅登录，不用 API key |
| 已经在付 ChatGPT 订阅 | Codex，同上 |
| 在用 Cursor | Cursor Agent，走你已经配好的 provider key |
| 有 GitHub Copilot | GitHub Copilot CLI |
| 想先花最少的钱试 | Gemini CLI（Google AI Studio key）或 Qwen Code（DashScope key） |
| 公司只批了某一家 | 看对照表里那家的适配器 |
选择的顺序
先看你已经在付哪一份钱，再看模型好不好。设计任务和写代码任务共用同一个额度池，这是 OpenDesign 最实在的省钱点——你不用为「设计」这件事再买一份订阅。
两种接法
接法一：指向本机 CLI（推荐）
如果 Claude Code、Codex、Cursor 或者 OpenCode 已经装在你机器上并且登录过，直接让 OpenDesign 指过去。桌面版会自己扫 PATH 把它们找出来。
这种接法有一个被反复称赞的性质：你一个 key 都不用交出去。生成走的是那个 CLI 已经登录的凭据，从头到尾没离开过你的机器。
接法二：填 API key（BYOK）
想用某个还没有 CLI 的模型，或者想精确控制用哪个模型时，填 key。凭据放在两个地方之一：
.od/media-config.json 项目内的凭据文件
环境变量 你的 shell profile 里API 调用从你的机器直接打到厂商，OpenDesign 不代理、不中转、也没有自己的服务器接这个流量。账单直接进你在那家的账户。
别把 .od/media-config.json 提交进仓库
它是凭据文件。开始干活前先确认它在 .gitignore 里。
怎么确认接通了
- 界面里能看到你的 Agent 出现在可选列表里。
- 随便挑一个技能，让它生成一个最小的东西（一个落地页够了）。
- 左边应该有实时进度在滚，而不是卡在「等待」。
如果列表是空的：
- CLI 在不在 PATH 里？终端里敲一下它的名字试试。
- 用 API key 的话，
.od/media-config.json写对了没有？ - 跑
pnpm tools-dev check，缺什么它会直接列出来。
换 Agent 会丢东西吗
不会。这是这套设计的重点：
| 东西 | 跟 Agent 绑定吗 |
|---|---|
技能（SKILL.md） | 不绑，纯 Markdown |
设计系统（DESIGN.md） | 不绑 |
| 已生成的产物 | 不绑，就是你仓库里的文件 |
| 凭据 | 绑，每家一份 |
换 Agent 只需要改 daemon 里的一行配置。你之前攒下的技能和品牌系统原样可用。
一个反过来的用法
技能可以抽出来单独用。「SKILL.md」是一个文件夹，你可以把它从 OpenDesign 里拿出去，直接丢进自己的 Claude Code 或者 Codex 会话里当上下文用。
这条路适合两种时候：你想要的能力在图形界面里没有对应入口；或者你在写脚本，不想开界面。
下一步
04 · 界面总览 — 一次生成到底经过哪几步，每一步在等你给什么。