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 请求
- 报错速查：接入后报错时按现象排查