Docs
Refer friends. Keep the rewards coming!Your friend can unlock up to 10M tokens · earn up to 30% revenue share.
+500K TokensGenerate link

Global region access

CrabCode's global region endpoint is `acosmi.ai`. The acosmi gateway proxies every model call and bills against your acosmi balance.

What it is

In the global region, CrabCode sends every model call to acosmi.ai. The acosmi gateway proxies the request to upstream model providers on your behalf. Billing is per-token × per-model coefficient against your acosmi balance — there is no direct billing relationship with the upstream providers.

acosmi.ai (global) and acosmi.com (China) are two independent account systems: balances, login tokens, and API keys do not cross.

When you use this

  • You are outside mainland China, or you specifically want an internationally-reachable endpoint
  • You already have an acosmi.ai account and want to run CrabCode against your global subscription
  • You want to see the current list of available models (run /model inside the TUI)

How to connect

  1. Sign up at acosmi.ai

  2. Point CrabCode's OAuth endpoint to acosmi.ai (the exact environment variable / config follows the prompts in CrabCode's /login flow for your version)

  3. Launch CrabCode and complete login:

    bash
    crabcode
    crabcode
  4. Once in a session, run /model to view available models and switch between them

Model catalog

The global region and the China region do not have an identical model set (upstream provider availability and commercial licensing differ by region). Do not assume this doc enumerates the full set — use /model for the live list.

CrabCode's default main-loop model is deepseek-v4-flash, with qwen3.6-plus as the automatic fallback. After logging in to the global region, /model will display the actual set of model slugs available in that region.

To switch models, type /model <slug> in the TUI.

Billing

  • Charged uniformly from your acosmi account balance, per-token × per-model coefficient
  • No need to top up or open API keys with upstream providers
  • Use /cost to see session-cumulative usage; check the acosmi.ai console for account balance and subscription status

Error codes

  • HTTP 402 [overloaded_error] insufficient quota: the subscription bucket for the current model is exhausted. Top up or switch to another model
  • HTTP 429: rate-limited. CrabCode applies a short backoff retry; if budget is exhausted it falls back
  • Transient network blips: CrabCode auto-retries a few times before falling back

Network reachability

acosmi.ai may not be reliably reachable from mainland China. If you are in mainland China, consider China region access instead.

Data compliance

Data residency, retention, and privacy terms are governed by the Terms of Service and Privacy Policy published on acosmi.ai.

See also