开始使用
第一次使用 Clodex
从安装与登录开始，在「我」中配置模型 Key、领养已开放的 Agent，再用一段简单文字完成第一次对话，并排查常见问题。
第一次先做一件小事：让 Agent 整理一段你提供的文字。确认账号、模型和对话都能正常工作后，再逐步增加任务范围。下面以当前 iOS 的入口名称为主；Android 和 macOS 也有「我 → 大模型配置」与「智能体设置」。
安装并登录
从下载页选择你的设备和发行渠道。TestFlight、公开预览和正式商店版本是不同的渠道，安装前看清标注；不要把测试版链接当成 App Store 正式上架。
打开客户端后，按登录界面输入账号并继续。已有账号使用密码登录；需要新账号时切换到注册，按照界面完成验证和密码设置。忘记密码时使用登录页的「忘记了密码？」入口。不要向他人发送验证码或登录令牌。
如果你看到与本文明显不同的旧版激活界面，先检查安装渠道与版本，不要照着旧教程去寻找共享访问令牌。
配置自己的模型 Key
进入 我 → 大模型配置，选择你已有账户的模型厂商，打开其配置页，填写 API Key 后点击「保存」。Key 要从对应模型服务商获取；Clodex 的登录账号与模型厂商账户是两件事。
保存 Key 默认允许云端 Agent 使用它，模型用量按服务商规则计入你的账户。Clodex 不提供平台模型 Key 或自动兜底。保存成功只证明配置已记录，不代表每个模型都已获得额度或访问权限。
需要了解 Key 类型、保存状态或停止使用的方法，先读配置你的模型 Key。
添加已开放的 Agent
进入 我 → 智能体设置，点击「添加智能体」或加号，在列表中选择 Agent 并点击「领养」。它随后会出现在你的对话列表。已经领养的 Agent 不会再次出现在待领养列表里。
当前可用的 Agent 是 OpenClaw、Hermes、Amp 和 Pi。Codex 与 Claude 仍在接入中，不能领养。厂商提供 Claude 模型不等于 Clodex 中的 Claude Agent 已开放。
如果领养后没有看到新 Agent，先返回列表刷新；遇到「智能体列表同步失败」时点击「重试」。不要反复创建账号来处理同步问题。
开始第一段对话
回到「对话」，选择已领养的 Agent 并新建对话。确认当前模型来自已配置 Key 的厂商，再发送一段短文字，例如：
请把下面三条笔记整理成一份提纲：先解释目标，再列出待办，最后指出还缺少什么信息。只使用我提供的内容，不添加外部事实。
接着粘贴不含敏感信息的笔记。检查回复有没有遗漏或误解，再提出一次具体修改，例如「保留原文日期，并把待办改成三项」。这能帮助你判断当前组合是否适合你的任务。
先用普通文字对话确认配置，不必一开始就附带文件、调用外部服务或要求操作电脑。不同客户端的附件、工具和运行能力按版本开放。
没有收到回复时
- 提示没有配置 Key：回到「大模型配置」，确认保存的是当前模型所属厂商的 Key。
- 提示余额、权限或额度不足：到对应模型服务商账户检查，不要把 Clodex 登录密码填进 Key 输入框。
- 模型不在选择列表：检查该 Agent 当前支持的模型，不用手工猜测模型名称。选择 Agent 与模型解释了两者的关系。
- 已提交但暂时未完成：先查看会话中的运行状态和错误信息，再决定是否重试，避免重复提交同一任务。
反馈问题时附上客户端、版本、操作步骤和已遮盖个人信息的错误截图；不要附上 Key、密码或验证码。联系入口在帮助中心。