HopBase 文檔選擇使用方式
第一次使用 HopBase 時，在開發工具接入和創作工作台之間選擇一條路線。
要在 Claude Code、Codex CLI 或 Codex App 裡寫代碼，走路線 1；只想在網頁裡生成商品圖片和影片，走路線 2，不需要 API 金鑰。
| 工具 | 建立金鑰時選的分組 | 接入方式 |
|---|---|---|
| Claude Code | Claude Max(官號滿血版)、Claude Max(官號滿血版)- 限時特惠 或 Claude Max（ccmax） | 一鍵接入，客戶端選 Claude Code |
| Codex CLI | Codex Plus 或 Codex Pro | 一鍵接入，客戶端選 Codex CLI |
| Codex App | Codex Plus 或 Codex Pro | CC Switch 匯入，客戶端選 Codex CLI |
路線 1 · 在 Claude Code 或 Codex CLI 中使用（3 步）
控制台「一鍵接入」會生成一條命令，自動安裝客戶端、寫入金鑰配置並驗證連線，macOS、Linux 和 Windows 都適用。Codex App 沒有命令列入口，改用 CC Switch 匯入。
建立對應分組的金鑰
打開控制台的「API 金鑰」頁面，點「建立金鑰」，按上表選分組。Claude Max（ccmax）只能在 Claude Code 客戶端中使用。不要把完整金鑰貼到聊天、工單或截圖中。
產生一鍵接入命令
在金鑰右側點「一鍵接入」，選 Claude Code 或 Codex CLI，確認系統是 macOS / Linux 還是 Windows PowerShell，點「產生接入命令」並複製。命令 15 分鐘內有效、只能使用一次，不含金鑰本身。
手動配置與常見問題見 Claude Code 和 Codex CLI；偏好圖形介面或要在多個供應商之間切換，用 CC Switch。
路線 2 · 在創作工作台生成商品圖片和影片
註冊並登入控制台後，直接開啟創作工作台。選擇圖片或影片，輸入提示詞，再設定模型、寬高比、尺寸、時長或音訊即可，不需要建立 API 金鑰。
下一步
- Claude Code / Codex CLI：一鍵接入的細節、手動配置與切換模型
- 快速開始：幾分鐘內發出第一個 API 請求
- 報錯速查：接入後報錯時按現象排查