常见问题

如何取消或管理 Clavue 订阅？

管理入口取决于你在哪里购买：

• 网页（www.clavue.com）：登录 → 账户 / 定价，可改套餐、更新支付（已开通的微信 / 支付宝）或取消续费。
• 若管理按钮打不开，请用无痕窗口或关闭拦截插件，仍失败则带注册邮箱联系支持。
• 教育教师 / 学生：资质通过后在「教育」页管理；学生子账号由教师创建。

Clavue 会员可以退款吗？

退款取决于当地支付规则与购买渠道：

• 网页 / 微信 / 支付宝：在账户页联系支持并附订单号与原因；政策允许时，通过后退回原支付方式，通常数个工作日。
• 加油包（额外额度）与已消耗的 API/Chat 轮次，用尽后一般不可退。
• 教育与试用期以结账页展示的套餐条款为准。

API 额度 / 加油包可以退吗？

不可以——已购加油包与未使用的充值额度在购买后不可退（法律另有规定除外）。套餐内的日/周/月额度不是可提现余额。

出现一笔我不认识的大额扣款——是 API 用量吗？

不一定。意外扣款常见于更高档套餐（×5 / ×20）或年付，而非单纯按量 API。请先在账户 → 订单与用量中核对，再带订单号联系支持确认。

网页已订阅，但 imux / CLI 仍显示 Free。付了两次吗？

会员绑定在你购买时使用的 Clavue 账户。请在网页、imux 设备码登录与 API Key 处使用同一账户。

• imux：账户 / 设备码登录 → 与 www.clavue.com 同一邮箱。
• CLI / API：使用该用户在「账户 → API 密钥」创建的 Key。
• 若确有两笔不同渠道扣款，请带两张收据联系支持。

Clavue 用量限额如何工作？

付费与免费套餐在产品间共用同一会员额度——imux Agent Chat、Clavue Chat（网页）、CLI/TUI agent 轮次与 OpenAI 兼容 API——无需按表面分别管钱包。

• 两个池：fast（轻量模型 / 路由）与 premium（旗舰 / pro / rev / 搜索 / 图像）。
• 按套餐有日 / 周 / 月上限（Free · 付费×1 · ×5 · ×20 · 教育）。
• RPM 软上限保护网络；重度自动化请用 ×5 / ×20。

用量如何计量？

每次成功的模型轮次从对应池扣减。不同产品消耗不同：短对话较少；长 agent 循环、搜索与图像生成更多。

• 可在 账户 → 用量（登录后 /usage）查看。
• 在可用时按表面（Chat、API、IDE）分解。
• 上游失败并退还额度的轮次不会永久占用。

到达限额后会发生什么？

依赖官方模型的付费能力会暂停，直到重置或增加额度。你可以：

• 等待用量页显示的日/周/月重置。
• 在网页购买加油包（额外额度）。
• 升级 Free → 付费×1 → ×5 → ×20，获得更多包含额度与更优有效单价。

加油包与充值如何工作？

加油包在套餐包含额度用尽后提供额外用量。账户级共享：网页 Chat、imux、CLI 与 API。

• 在包含额度用尽后才扣加油包。
• 有效期以购买时条款为准（除非另有说明，通常较长）。
• 若每周都顶满限额，升级套餐通常比反复加油更划算。

应该升级套餐还是买加油包？

若经常用尽周/月包含额度，请升级——×5 / ×20 提供更多余量且更划算。偶尔尖峰再用加油包。

如何登录？

在 www.clavue.com 使用邮箱 OTP、密码（若已设置）或已开通的 Google。imux 与 Clavue CLI 使用设备码登录，浏览器批准后完成。

• CLI：对 /api/membership/auth/device/* 走 device start/poll。
• API：在 账户 → API 密钥 创建 Key；请求头 Authorization: Bearer <token>。
• 保持主邮箱一致，使 Free 额度与付费套餐落在同一身份。

如何更换登录邮箱？

在账户页更新资料邮箱（若可用）；丢失旧邮箱访问权时请联系支持。绑定新的 Google 登录不一定合并旧额度——创建第二个账户前请确认。

账号被盗了，支持能做什么？

请立即联系支持并提供用户 ID / 邮箱与所有权证明。支持可吊销会话与 API Key、取消续费并锁定账户。若购买地点与历史一致，被盗用量可能无法退款。

如何删除账号？

在账户设置中使用删除流程（若可用），或通过支持申请删除。删除会移除会员访问、API Key 与 Chat 历史（受法律保留约束）。若有恢复窗口，以删除时产品 UI 说明为准。

登录问题应先尝试什么？

退出再登录、重试设备码、清除 clavue.com cookie、换浏览器，并确认系统时间正确。imux 请更新到最新稳定版并重新设备批准。

imux 与 Clavue 分别是什么？

名称请分开理解：

• imux — 原生 macOS AI IDE / 指挥中心（终端、Agent Chat、文件、SCM、浏览器、监督器）。下载：www.iccjk.com。
• Clavue — 平台品牌：会员、模型、网页 Chat、CLI/TUI 运行时、api.clavue.com API。
• 模型 — 产品 ID 如 auto、clavue-2.1、clavue-2.1-fast/pro/rev/search、clavue-img。

什么时候用 IDE、CLI 或 TUI？

每个任务选一个主表面：

• IDE（imux）：多窗格 agent、Git 可见工作、浏览器验收、Mission Control —— 日常 macOS 工作台。
• CLI（icc / clavue）：脚本、CI、无头自动化、控制 imux 的 socket、设备登录。
• TUI：全屏交互式终端 UI，适合不想打开完整 IDE 壳层的 agent 循环。
• 网页 Chat（/playground 或 chat.clavue.com）：官方模型多轮对话，共用同一额度。

哪些是官方模型？

官方产品 ID（会员 + API）：auto、clavue、clavue-2.1、clavue-2.1-fast、clavue-2.1-pro、clavue-2.1-rev、clavue-2.1-search、clavue-img。非官方模型字符串会返回 official_models_only。

正确的 API Base URL 是什么？

使用 https://api.clavue.com/v1（OpenAI 兼容 chat completions 与模型列表）。会员鉴权与设备码在 https://www.clavue.com。imux 下载与 Sparkle 更新源使用 https://www.iccjk.com。

imux Unix socket 与 Clavue HTTP API 是一回事吗？

不是。本地 Unix socket（icc CLI / 集成）控制本机正在运行的 imux。HTTP API 用会员 Token 调用 Clavue 服务器上的官方模型。多数自动化两者并用：socket 管工作台，HTTP 做推理。

在 Chat / Agent Chat 中如何附加文件？

网页 Chat 与 imux Agent Chat 使用输入框旁的附件控件（网页可拖放）。imux 还可 @ 提及工作区文件，并在本地应用可审阅 diff，无需上传到云端。

哪些文件类型最合适？

网页 Chat 支持常见文档与代码（PDF、TXT、MD、CSV、JSON、源码）以及图像（PNG/JPEG/WebP）。imux 本地工具可按工作区策略读写项目文件。超大二进制应留在磁盘，在 IDE 中用路径引用。

如何删除对话并释放存储？

在可用时从 Chat 历史 UI 删除对话。imux 会话标签可在应用内关闭/删除。删除账号会移除云端历史（受法律保留约束）。除非你运行会改文件的工具，Clavue 不会删除本地项目文件。

教师 / 学生套餐是什么？

教育套餐在资质通过后提供更低价格。教师可为班级创建带密码的学生席位（受席位上限约束）。合格教育账户额度默认对齐付费×1（除非另有说明）。

如何完成教育认证？

打开 /education，提交认证流程并等待通过。滥用（转借、倒卖）会导致取消教育价。

如何生成图像？

在网页 Chat、imux Agent Chat 或 API 中使用官方模型 clavue-img。回复通常含 Markdown 图片链接，产品会内联渲染。

为什么我的画图提示被拦截？

安全系统始终生效。开启任何创作/NSFW 偏好都不会关闭审核。禁止类别包括儿童性内容与非自愿亲密影像。支持无法提供完整规则表；重复滥用可能导致处罚。

图像生成更费额度吗？

是——图像走 premium 池，比短对话更耗算力。纯问答请优先文本模型。

API 是否 OpenAI 兼容？

是：https://api.clavue.com/v1 提供 Chat Completions 与模型列表。使用标准 OpenAI Python/Node SDK，将 base_url / baseURL 指向 Clavue。

应该安装哪个 SDK？

pip install openai 或 npm install openai。无需专有 Clavue SDK。多语言第一次请求示例见 /docs/sdk。

如何流式返回？

在 chat completions 上设置 stream: true。协议对齐 OpenAI SSE。详见 /docs/streaming。

是否支持函数调用 / tools？

支持——API 上的 OpenAI tools schema、官方 MCP web_search，以及 imux 原生工具。见 /docs/function-calling。

会用我的 API 请求训练吗？

请将生产提示视为敏感。训练/改进策略见隐私政策与产品内控件。完整安全 FAQ：/docs/security。

API Key 泄露了怎么办？

立即在 账户 → API 密钥 禁用或删除该 Key，创建新 Key，更新部署，并检查用量是否异常。

imux 和 Clavue 分别是什么？

imux 是原生 macOS 多代理工作台（终端、Git、远程、浏览器、Agent Chat）。Clavue 是平台：会员、官方模型、网页 Chat/Imagine、CLI/TUI 与 OpenAI 兼容 API。同一会员可覆盖两端。

从哪里安全下载 imux？

使用 https://www.iccjk.com/downloads/imux-macos.dmg 或 /download 页面。优先公证 DMG 与 latest.json 校验。避开仿冒域名。

• 安装教程：/tutorials/installing-imux
• 黑屏恢复（5.0.34+）：/tutorials/recover-blank-terminal

可以同时跑 Claude Code 和其他代理吗？

可以——分屏、明确文件所有权、应用前人工审阅。见 /use-cases/multi-agent-coding 与 /tutorials/multi-agent-workspace。

应该用 imux 替换 Cursor 吗？

不必。Cursor 偏编辑器 AI；imux 偏多代理终端运维。很多团队两者都留。见 /comparisons/imux-vs-cursor 与 /tutorials/imux-vs-cursor-workflow。

如何反馈 bug 或联系人工？

请附：注册邮箱、使用面（imux / 网页 Chat / CLI / API）、系统/浏览器版本、imux 版本（如适用），以及错误中的完整排查参考行（requestId + code）。附截图或最小复现步骤。

• 产品问题：适用时在 imux 仓库提 GitHub issue。
• 账单：从账户 / 订单邮件回复并附订单号。
• 文档：错误码表见 /docs/errors-and-support。

还有问题？

请先阅读快速入门与产品面文档（IDE、CLI、TUI、模型、会员、API）。用量异常时先打开 账户 → 用量 确认套餐与重置时间，再提交工单。