模型与设置

配置你的模型 Key

内容更新于 2026年10月8日

了解 BYOK 的费用与授权，在客户端找到模型 Key 配置入口，并区分保存、更新、云端使用授权与厂商侧停用。

BYOK 是 Bring Your Own Key：使用你在模型服务商账户中创建的 API Key。它让 Clodex 能调用你选择的模型；模型用量、余额与权限仍受该服务商的规则约束。API Key 不是 Clodex 登录密码，也不等于聊天产品的订阅账号。

找到配置入口

在 iOS、Android 或 macOS 打开 我 → 大模型配置，选择对应厂商，再打开 Key 编辑页。只有先保存正确厂商的 Key，后续选择它的模型才有凭据可用。

在服务商账户创建适用于 API 的 Key，并确认所需模型的访问权限与额度。将 Key 粘贴到对应输入框；不要把密码、会话 Cookie、访问令牌或他人的 Key 当成模型 Key。

如果界面提供「Key 类型」，请选择与你实际持有凭据一致的类型。原生厂商 Key 与 GoToAI Key 不能只靠更换标签互相转换。第一次配置建议先使用自己明确了解来源的 Key。

填写后点击「保存」，等待页面给出成功或失败结果。已有 Key 不会完整显示；部分客户端只显示掩码或「已保存」状态，这是正常表现。

看到「保存未确认」或登录失效时，先重新登录并刷新配置，再判断是否需要重新填写。不要仅根据输入框变空认定保存成功，也不要为了排查问题把完整 Key 发到聊天或邮件里。

然后回到对话，选择该 Agent 当前可用、且属于同一厂商的模型，发一条短消息验证。能保存配置和能成功调用模型是两个不同检查：余额不足、模型无权限或厂商错误都可能在调用时才出现。

Clodex 当前规则是：保存 Key 即默认允许云端 Agent 使用，全部厂商适用。 模型调用使用你的 Key，平台不提供备用模型 Key；云端运行也会产生你自己的模型用量。

部分客户端还会显示「允许官方云端 Agent Runtime 使用此 Key」。这个控件属于官方 Agent 接入流程，目前只在特定原生 Key 配置中显示；看到它不代表 Codex 或 Claude Agent 已开放，也不能据此推断其他 Agent 的授权状态。

客户端正在逐步对齐授权管理入口。如果你看不到需要的撤销操作，不要把「没有开关」理解成「云端无法使用」。先不要发起新任务，并按下面的方法停止该 Key 的后续使用。

更新 Key 时，在对应厂商配置页填入新值并保存，随后用短消息确认新配置可用。不要在不清楚含义时切换 Key 类型或更换路由。

如果客户端显示适用于当前 Key 的云端授权开关，可关闭后检查是否明确提示「已撤销云端使用授权」。这个提示只对应该控件说明的授权范围，不能把官方运行时开关当作所有 Agent 的总开关。

需要停止所有使用这把 Key 的后续调用时，到对应模型服务商控制台停用或删除该 Key；如需继续使用，创建新 Key 后再配置。停用可能同时影响其他使用同一 Key 的应用，也不会撤销已经产生的用量。找不到客户端管理入口时，可以联系帮助中心说明客户端与版本，不要发送 Key 本身。