ClavueClavue
AI workbench for macOS

FAQ

While the product docs cover imux, Clavue CLI/TUI, models, and the OpenAI-compatible API in depth, this page collects the most common questions about billing, usage limits, accounts, and everyday product use — website, apps, CLI, and API.

Section layout mirrors https://docs.x.ai/grok/faq: Billing · Usage · Accounts · Products · Files · Education · Help — content is for the Clavue platform (imux IDE, CLI, TUI, models, membership, API).

Billing & Subscriptions

How do I cancel or manage my Clavue subscription?

Where you manage it depends on where you subscribed:

  • Web (www.clavue.com): sign in → Account / Pricing to change plan, update payment (WeChat / Alipay where enabled), or cancel renewals.
  • If a manage button fails to open, try an incognito window or disable blockers — then contact support with your account email.
  • Education Teacher / Student plans: manage under Education after qualification; student seats are created by the teacher account.

Can I get a refund for my Clavue membership?

Refunds depend on local payment rules and purchase channel:

  • Web / WeChat / Alipay: contact support from Account with order number and reason. Approved refunds return to the original method within several business days when policy allows.
  • Boost packs (extra usage credits) and consumed API/Chat turns are generally non-refundable once quota is spent.
  • Education and trial periods follow the plan terms shown at checkout.

Are API credits / boost packs refundable?

No — prepaid boost packs and unused top-up credits are non-refundable once purchased, unless required by law. Plan included weekly/monthly quotas are not cash balances.

I got a large charge I don't recognize — is it API usage?

Not necessarily. Unexpected charges are often a higher plan tier (×5 / ×20) or annual billing, not pure pay-as-you-go API. Check Account → orders and usage before disputing. Contact support with the order number so we can confirm what was charged.

I subscribed on the web but imux / CLI still says Free. Did I pay twice?

Membership is tied to the Clavue account you purchased with. Sign in with the same account everywhere (web, imux device login, API key).

  • imux: Account / device-code login → same email as www.clavue.com.
  • CLI / API: use a key from Account → API keys for that user.
  • If two real charges exist on different methods, contact support with both receipts.

Usage & Limits

How do Clavue usage limits work?

Paid and Free plans share one membership quota across products — imux Agent Chat, Clavue Chat (web), CLI/TUI agent turns, and the OpenAI-compatible API — so you are not managing separate wallets per surface.

  • Two pools: fast (lighter models / routing) and premium (flagship / pro / rev / search / image).
  • Caps apply per day, week, and month depending on plan (Free · Paid×1 · ×5 · ×20 · Education).
  • RPM soft limits protect the network; heavy automation should use ×5/×20.

How is my usage measured?

Each successful model turn consumes from the matching pool. Different products cost different compute: a short chat uses little; long agent loops, search, and image generation use more.

  • Usage is visible under Account → Usage (and /usage when signed in).
  • Breakdown by surface (Chat, API, IDE) when available.
  • Failed upstream turns that refund quota do not permanently consume that turn.

What happens when I reach my limit?

Paid features that need official models pause until reset or you add headroom. You can:

  • Wait for the next day/week/month reset shown in Usage.
  • Buy boost packs (extra credits) on the web.
  • Upgrade Free → Paid×1 → ×5 → ×20 for more included quota at better effective rates.

How do boost packs and top-ups work?

Boost packs add extra usage after included plan quota is exhausted. They are account-level and shared across web Chat, imux, CLI, and API.

  • Credits apply after included pool is empty.
  • Expiry follows pack terms at purchase (typically long-lived unless stated).
  • Effective cost per turn is usually higher than upgrading the plan if you hit limits every week.
Important: boost purchase is currently web-first (www.clavue.com). In-app mobile purchase may not apply — use the website Account page.

Should I upgrade my plan or buy boosts?

Upgrade when you regularly exhaust weekly/monthly included usage — ×5/×20 give far more headroom at better value. Use boosts for occasional spikes.

Accounts & Login

How do I sign in?

On www.clavue.com use email OTP, password (if set), or Google where enabled. imux and Clavue CLI use device-code login that opens the browser to approve.

  • CLI: follow device start/poll against /api/membership/auth/device/*.
  • API: create a key under Account → API keys; send Authorization: Bearer <token>.
  • Keep one primary email so Free quota and paid plan stay on the same identity.

How do I change the email I log in with?

Update profile email from Account when available, or contact support if you lost access to the old address. Linking a new Google sign-in does not always merge old quota — verify before creating a second account.

My account was compromised. What can support do?

Contact support immediately with user id / email and proof of ownership. Support can revoke sessions and API keys, cancel renewals, and lock the account. Compromised usage may not be refundable when the purchase location matches your history.

How can I delete my account?

Use Account settings delete flow when available, or request deletion via support. Deleting removes membership access, API keys, and Chat history retention subject to legal hold. Restore windows (if any) are stated in the product UI at deletion time.

What login troubleshooting should I try first?

Sign out and back in, retry device login, clear site cookies for clavue.com, try another browser, and confirm system clock is correct. On imux, update to the latest stable build and re-run device approve.

Products & Surfaces

What is imux vs Clavue?

Keep names clear:

  • imux — native macOS AI IDE / command center (terminals, Agent Chat, files, SCM, browser, supervisor). Downloads: www.iccjk.com.
  • Clavue — platform brand: membership, models, web Chat, CLI/TUI runtime, API at api.clavue.com.
  • Models — product ids like auto, clavue-2.1, clavue-2.1-fast/pro/rev/search, clavue-img.

When should I use the IDE, CLI, or TUI?

Pick one primary surface per task:

  • IDE (imux): multi-pane agents, Git-visible work, browser verify, Mission Control — daily macOS workbench.
  • CLI (icc / clavue): scripts, CI, headless automation, socket control of imux, device login.
  • TUI: interactive terminal UI for agent loops when you want a full-screen CLI experience without the full IDE chrome.
  • Web Chat (/playground or chat.clavue.com): quick multi-turn on official models with the same quota.

Which models are official?

Official product ids (membership + API): auto, clavue, clavue-2.1, clavue-2.1-fast, clavue-2.1-pro, clavue-2.1-rev, clavue-2.1-search, clavue-img. Non-official model strings return official_models_only.

What is the correct API base URL?

Use https://api.clavue.com/v1 (OpenAI-compatible chat completions and models list). Membership auth and device codes live on https://www.clavue.com. imux downloads and Sparkle feeds use https://www.iccjk.com.

Is the imux Unix socket the same as the Clavue HTTP API?

No. The local Unix socket (icc CLI /integrations) controls the running imux app on your Mac. The HTTP API calls official models on Clavue servers with your membership token. Most automation uses both: socket for workbench control, HTTP for model inference.

Files & Data

How do I attach files in Chat / Agent Chat?

In web Chat and imux Agent Chat, use the attachment control next to the composer (or drag-and-drop on web). imux can also @-mention workspace files and apply reviewable diffs without uploading to the cloud when work stays local.

What file types work best?

Common documents and code (PDF, TXT, MD, CSV, JSON, source files) and images (PNG/JPEG/WebP) are supported on web Chat. imux local tools can read/write project files under workspace policy. Very large binaries should stay on disk and be referenced by path in the IDE.

How do I delete chats and free storage?

Delete conversations from Chat history UI when available. imux conversation tabs can be closed/deleted in-app. Account deletion removes cloud history subject to legal retention. Local project files are never deleted by Clavue unless you run tools that modify them.

Education & Teams

What are Teacher / Student plans?

Education plans offer lower pricing after qualification. Teachers can create passworded student seats for a class (subject to seat limits). Usage multiplies match paid ×1 for qualified education accounts unless stated otherwise.

How do I verify education status?

Open /education, submit the verification flow, and wait for approval. Abuse (account sharing, resale) can revoke education pricing.

Image Generation

How do I generate images?

Use official model clavue-img in web Chat, imux Agent Chat, or the API. Replies typically include Markdown image links that products render inline.

Why was my image prompt blocked?

Safety systems always apply. Enabling any creative/NSFW preference does not disable moderation. Prohibited categories include child sexual content and non-consensual intimate imagery. Support cannot provide full rule lists; repeated abuse may lead to enforcement.

Does image generation use more quota?

Yes — images draw from the premium pool and cost more compute than a short chat turn. Prefer text models for pure Q&A.

API & Integrations

Is the API OpenAI-compatible?

Yes for Chat Completions and models list at https://api.clavue.com/v1. Use standard OpenAI Python/Node SDKs with base_url / baseURL pointed at Clavue.

Which SDK should I install?

pip install openai or npm install openai. No proprietary Clavue SDK is required. See /docs/sdk for full multi-language first-request samples.

How do I stream responses?

Set stream: true on chat completions. Protocol matches OpenAI SSE. Details: /docs/streaming.

Do you support function calling / tools?

Yes — OpenAI tools schema on the API, Official MCP web_search, and imux native tools. See /docs/function-calling.

Security & Privacy

Do you train on my API requests?

Treat production prompts as sensitive. Training/improvement policies are disclosed in Privacy and product controls. Full security FAQ: /docs/security.

My API key was leaked. What do I do?

Immediately disable or delete the key in Account → API keys, create a new one, update deployments, and review Usage for unexpected traffic.

Getting Help

How do I report a bug or reach a human?

Include: account email, surface (imux / web Chat / CLI / API), OS/browser version, imux version if applicable, and the full support Ref line (requestId + code) from any error. Attach screenshots or a minimal repro.

  • Product issues: GitHub issues on the imux repo when open-source applicable.
  • Billing: reply from Account / order email with order number.
  • Docs: /docs/errors-and-support for code tables.

Still have questions?

Start with Quickstart and product surface docs (IDE, CLI, TUI, models, membership, API). For usage anomalies, open Account → Usage and confirm plan reset times before opening a ticket.