将 OpenDesign Cloud API 接入外部工具

先分清接入方向

如果你想在 OpenDesign 内使用自己的模型服务商 Key，请看 BYOK 配置。本篇是另一个方向：让 Claude Code、Codex 等外部工具使用 OpenDesign Cloud 提供的模型 API。

开始前需要什么

OpenDesign Cloud API 支持 Go、Plus、Pro、Max 套餐，不支持 Free 免费套餐。可用文本模型以账户中的 Model 列表为准，截图中的模型不代表所有套餐都可用。

支持的目标 Agent 包括 Claude Code、Codex、Grok Build、OpenCode、OpenClaw 和 Hermes Agent。先安装你要使用的 Agent；已有 CC Switch 可直接进入选择步骤。

在网页打开 API keys

登录 OpenDesign 网页账户管理界面，在左侧选择 API keys。右上角 One-click agent setup 是一键配置入口，没有现成 Key 也可以开始。

需要手动配置时，在 Connection setup 中选择工具要求的 API 格式：Chat Completions、Responses 或 Messages，并复制对应的 API base URL。接入地址和协议必须匹配。下面介绍一键导入的操作。

第一步：安装并打开 CC Switch

1. 在 One-click agent setup 中点击 Download for Mac 或 Download for Windows。
2. 安装并打开 CC Switch；如果已经安装，直接继续下一步。

第二步：选择 Agent 和模型

1. 选择目标 Agent，默认选择 Claude Code。
2. 在 Model 中选择当前套餐可用的文本模型。没有可用模型时，切换 Agent 或检查套餐，不能通过填写截图中的模型名绕过权限。

第三步：导入并重启 Agent

1. 点击 Import into CC Switch。系统新建一个以 Agent 和系统命名的 Key，例如 Claude Code · Mac，并唤起 CC Switch。
2. 首次打开时，在浏览器的确认提示中选择 Open CC Switch。核对 CC Switch 中的 API Endpoint、Key 和模型后，点击 Import。
3. 回网页点击 Done。需要接入另一个 Agent 时，选择 Set up another agent。
4. 重启目标 Agent。Claude Code 可退出当前会话，在新终端重新运行 claude。

每次一键配置都会创建新 Key，不能选择已有 Key。已有 Key 不受影响；原先的配置也会保留，可在 CC Switch 切换回来。

确认请求已经走新配置

1. 在重启后的 Agent 中发送一条简单消息，确认能正常回复。
2. Claude Code 可输入 /status，检查模型是否与刚才选择的一致。其他 Agent 使用各自的状态入口。
3. 回到网页 API keys，检查新 Key 的 Last used 是否更新。

导入成功但仍使用旧模型时，退出旧会话并重启。浏览器没有唤起 CC Switch 时，检查地址栏附近的确认提示，打开 CC Switch 后点击 Open again。后续换模型可在 CC Switch 修改，无需重复一键配置。

切回原配置或停用 Key

在 CC Switch 找到该 Agent 原先的配置，点击启用按钮切回。删除 CC Switch 配置不会让 API Key 失效；要停用 Key，必须回网页 API keys 撤销它。

套餐与可用模型以网页账户当前显示为准。完整录屏和逐步截图见 一键接入 Agent 教程。订阅入口见 订阅、充值与额度。

API 与客户端是否共用额度？

是。常规 API 调用与应用内共用套餐额度和用量窗口；多建 Key 或换到另一个 Agent 不会重置。临时免费额度是否允许 API 调用，按对应活动条件判断。查看 额度与用量。

可直接打开 Cloud 控制台 管理 Key 和用量。Zcode 等支持自定义模型地址与 Key 的工具也可以按对应协议配置 OpenDesign 模型服务；这不代表 OpenDesign 已内置支持把该工具反向作为本机 Agent 启动。

请求里放了图片，提示体积超限怎么办？

当前支持答疑给出的单次 API 请求上限为 50 MiB。这里限制的是整个请求体，不是单张图片；图片编码等也会增加请求大小。减少图片数量或尺寸后用最小请求重试。仍失败时保留响应状态、请求时间和模型，提交诊断；不要公开 API Key。