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 · 介面總覽 — 一次生成到底經過哪幾步，每一步在等你給什麼。