常见问题与排查

处理密钥缺失或无效、限流与配额错误、服务商故障，以及关于 iOS 状态、模型能力与费用估算的解答。

封闭测试中最常见问题的解答，按主题分组。

设置与密钥

这是鉴权失败（HTTP 401/403）。打开设置，为该服务商重新粘贴密钥，并确认没有多余空白。空密钥会被视为没有密钥，此时该服务商会显示为未配置。密钥按服务商分别存储，因此每个服务商都需要各自的密钥——为 OpenRouter 保存的密钥无法鉴权 OpenAI。

从服务商自己的控制台，而非 Cordy。OpenRouter、OpenAI、Anthropic、Vercel AI Gateway 与火山方舟 Ark 的分步链接见快速开始 → 在哪里获取密钥。

Cordy 会在保存有效密钥后加载服务商目录。若仍停留在很小的初始列表上，密钥很可能缺失或被拒绝——请重新核对。你也可以点击刷新模型。对于 Anthropic（原生），模型条目为内置而非通过 /models 拉取，因此列表不会因该调用而增长。

可以——将其添加为自定义兼容 OpenAI 的服务商。除回环 / 内网主机（本地开发允许明文 http://）外，都要求使用 HTTPS。

Cordy 会把服务商与网络故障映射为简短、安全的提示——绝不展示服务商原始响应、API 密钥与鉴权头。

可重试的错误会提供重试操作。若某个流因崩溃或强制退出而中断，下次启动会将其干净地标记为已停止，你可重新生成。

你的账户额度用尽或未开通计费。请到服务商控制台（如 OpenRouter 或 OpenAI）充值或添加支付方式，然后重试。

你触发了服务商的速率限制。稍候片刻并使用重试。若持续出现，请放慢频率或向服务商核对你套餐的限额。

这取决于具体模型。Cordy 会依据服务商目录（并回退到内置 LiteLLM 快照）标记模型。若模型无法接受图片，Cordy 会在发起任何请求前拦截图片发送，并显示“发送图片前请选择支持视觉的模型”，附更换模型操作。选择带视觉标记的模型即可添加图片。

仅支持思考的模型。思考预算控制仅对这些模型出现；在其他模型上你会看到“所选模型不支持扩展思考。”Anthropic（原生）模型直接支持；部分通过 OpenRouter 的推理模型也支持。

暂时不能。工具 / 函数调用已在消息格式中表示（应用可渲染工具调用与工具结果块），但本版本尚未执行。跨服务商的自动网关与回退路由同样为后续工作——目前每个会话只使用一个服务商和一个模型。

有些服务商不会随响应返回 token 用量。此时 Cordy 会在设备端估算 token 数，并在设置 → Token 用量页面为这些数字加上前导 ≈。价格来自服务商（在其返回时）或内置的 LiteLLM 快照；当价格未知时，模型显示 —。

请将其视为估算。费用依据完成时捕获的价格计算，token 数也可能是本地估算（≈）。请始终与服务商自己的账单核对权威数字。

设置 → Token 用量 显示总计，以及按模型、按服务商、按天的细分。

Cordy 已在 Android 上验证；iOS 仍在推进中。 iOS 应用可对共享代码编译，但尚未在真机上冒烟测试，且图片、相机与语音输入在 iOS 上尚未接入。目前请使用 Android 以获得完整、已验证的体验。完整细节见隐私与安全页面。

这些采集入口在 iOS 上尚未接入，因此 Cordy 会隐藏它们，而不是显示无效按钮。在 Android 上它们全部可用。分享/导出在两个平台都已接入。

只有你的提示词，只发往你选择的服务商，且仅在你发送消息时。没有 Cordy 后端、没有账号、没有云端同步，也没有遥测。完整说明见隐私与安全。

仅存于平台安全存储——Android 密钥库（AES-256-GCM）或 iOS 钥匙串（绑定设备、排除在云备份之外）。绝不入对话数据库，也绝不入日志。

设置 → 清除全部本地数据。 它会在一个操作中从设备清除数据库、偏好、已存密钥、附件与缓存，并在任何边界失败时如实报告。它不会触及应用二进制或操作系统级备份。见隐私与安全 → 一键清除。