快速开始
先确认 CordyAI 的下载状态,再带上密钥,选择服务商与模型,粘贴 API 密钥并开始对话。
CordyAI 采用自带密钥方式:你无需注册 Cordy 账号,而是连接自己在 AI 服务商处的 API 密钥。首次启动的目标很简单——带上密钥,掌握控制权,几秒内即可开始对话。
平台说明。 以下步骤描述源码中当前的 Android 实现。在 v0.5.0 源码标签处,相机、分享进入、语音与 TalkBack 的人工检查仍未完成。仓库未记录完成的 iOS 二进制链接、执行或冒烟,图片、相机与语音采集也尚未接入。见常见问题。
获取构建
CordyAI 暂无公开构建。公开发布仓库中的 CordyAI 0.5.0 条目仅为更新日志(2026-07-16),其清单把 CordyAI 列为未发布。构建只会通过公开发布仓库提供;出现后,文件会显示在本页此处。
CordyAI
尚无公开构建
尚无可公开下载的构建。首个公开构建发布前,更新日志先在此处维护。
下面的首次启动步骤,描述的是你拿到构建之后应用的行为。
开始之前
你只需要一样东西:来自受支持服务商的 API 密钥。Cordy 不出售额度、也不转售模型访问——你使用自己在服务商处的账户,并直接按用量向服务商付费。
如果还没有密钥,下方的在哪里获取密钥会逐一介绍各服务商。若只想走最快路径,创建一把 OpenRouter 密钥:一把密钥即可触达 100+ 模型。
首次启动:引导
首次打开应用时,一段简短引导会用三张卡片说明这一模式:
- 默认本地——除非你主动清除,会话会保留在这台设备上。
- 自带密钥——密钥通过设备安全存储保存(Android 密钥库 / iOS 钥匙串)。
- 服务商请求——提示词只会发送给你选择的服务商。
点击打开设置即可配置你的第一个服务商,或点击知道了关闭引导。之后可从设置 → 外观 → 重新查看引导重新打开这段引导。
三步发出第一条消息
1. 打开设置,选择服务商与模型
在对话界面打开设置,选择服务商与 API 密钥。在服务商下选择消息发往何处,默认已选中 OpenRouter。打开模型一行选择模型——保存密钥后,列表会填入该服务商的实时目录与每个模型的定价(显示为“In $… / Out $… per 1M”)。保存密钥之前,Cordy 显示一个很小的内置列表,并提示“Add an API key to load this provider's model list”。
2. 粘贴你的 API 密钥
在该服务商的 API 密钥分组中粘贴密钥并点击保存密钥。输入框标签会变为服务商名称加“密钥已保存”(例如“OpenRouter 密钥已保存”),Cordy 随即加载该服务商的模型目录。密钥仅写入设备安全存储——绝不写入对话数据库或日志。
3. 开始对话
回到对话界面。输入框显示 “Message CordyAI”(中文界面为“给 CordyAI 发消息”)。新会话是一块空白画布;在尚未保存密钥的全新安装上,画布会改为显示“Connect a provider to chat”卡片(中文界面为“连接一个 provider 开始对话”,副文为“仅存储在这台设备上。”),并附一个打开设置的添加密钥按钮。发送第一条消息,回复会实时流式返回,并在到达时以 Markdown 渲染。
就是这样——Cordy 本身不要求邮箱、验证或账号;所选服务商可能要求其自己的账号与计费设置。
在哪里获取密钥(按服务商)
密钥始终在服务商自己的控制台创建,然后粘贴到 Cordy。多数服务商要求先充值或开通计费,密钥才能发起请求。
OpenRouter(默认,推荐作为第一把密钥)
- 前往 openrouter.ai/keys 并登录。
- 创建一把新的 API 密钥并复制。
- 为 OpenRouter 账户充值(Settings → Credits),以便请求成功。
- 在 Cordy 中:设置 → 服务商与 API 密钥 → OpenRouter → 粘贴密钥 → 保存密钥。
一把 OpenRouter 密钥即可触达多家厂商的模型(Anthropic、OpenAI、Google、Meta 等),其目录含实时定价,Cordy 因此能显示每个模型的花费。
OpenAI
- 前往 platform.openai.com/api-keys。
- 创建一把新的密钥并复制(之后将无法再次查看)。
- 确认你的 OpenAI 账户已开通计费。
- 在 Cordy 中:设置 → 服务商与 API 密钥 → OpenAI → 粘贴密钥 → 保存密钥。
Anthropic
- 前往 console.anthropic.com 并打开 API keys。
- 创建一把密钥并复制。
- 确认你的 Anthropic 账户有额度/计费。
- 在 Cordy 中:设置 → 服务商与 API 密钥 → Anthropic → 粘贴密钥 → 保存密钥。
Anthropic 运行于 Cordy 的 原生 Anthropic 集成之上,支持扩展思考(见生成控制)。
Vercel AI Gateway
- 打开你的 Vercel 控制台 并进入 AI Gateway。
- 为网关创建一把 API 密钥并复制。
- 在 Cordy 中:设置 → 服务商与 API 密钥 → Vercel AI Gateway → 粘贴密钥 → 保存密钥。
火山方舟 Ark
- 打开方舟控制台。
- 创建一把 API 密钥并复制。
- 在 Cordy 中:设置 → 服务商与 API 密钥 → Volcengine Ark → 粘贴密钥 → 保存密钥。
你自己的端点
在运行自托管或内部的兼容 OpenAI 服务?你可以将其添加为自定义服务商,而不必使用内置项。
确认是否成功
- 点击保存密钥后,模型列表应填入真实模型与价格。若仍停留在初始(bootstrap)条目,说明密钥可能缺失或被拒绝。
- 发送一条简短消息。流式回复即表示端到端成功。
- 打开设置 → Token 用量,查看这条消息记录的 token 与估算费用。
如果出了问题
- “请检查你的 API 密钥”——密钥缺失、为空或被拒绝(HTTP 401/403)。请在设置中重新粘贴。
- “服务商额度已用尽”——请到服务商处充值/开通计费(HTTP 402)。
- “服务商触发限流”——稍候片刻后重试(HTTP 429)。
完整恢复指南见常见问题与排查。