Skip to main content
Route every model call MiMo Code makes through the Orq.ai AI Gateway. MiMo Code supports OpenAI-compatible providers, so pointing it at the router opens the full AI Gateway catalog. Requests appear in Traces automatically.

Prerequisites

curl -fsSL https://mimo.xiaomi.com/install | bash

Setup

Start MiMo Code inside a project directory, then add Orq.ai as a custom provider:
  1. Type /login and select other provider, then custom provider.
  2. Enter the connection details:
    • id: orq
    • base URL: https://api.orq.ai/v3/router
    • API key: your Orq.ai API key
    • model: any identifier from the AI Gateway catalog, for example anthropic/claude-sonnet-4-6
Switch models at any time with /model.
MiMo Code requests max_tokens: 32000 by default, which exceeds the output cap of some models. For example, openai/gpt-4o allows at most 16384 completion tokens and returns an error. Use a model with a larger output budget, such as anthropic/claude-sonnet-4-6 (64000), or lower MiMo Code’s maximum output tokens.

Verification

Send a prompt in MiMo Code. The response appears in the terminal and the trace appears in Orq.ai Traces with the model identifier you selected.

Connect via MCP

MiMo Code is a fork of OpenCode and keeps its MCP support, so the Orq MCP server can run alongside the gateway routing above. With both connected, MiMo Code routes model calls through the AI Gateway and manages Agents, experiments, Datasets, and Traces through the Orq MCP tools. Add the Orq MCP server to the MiMo Code config (~/.config/mimocode/mimocode.json, or .mimocode/mimocode.json for a single project):
{
  "mcp": {
    "orq": {
      "type": "remote",
      "url": "https://my.orq.ai/v2/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer YOUR_ORQ_API_KEY"
      }
    }
  }
}
Replace YOUR_ORQ_API_KEY with an API key. See the MCP Quickstart for the full tool reference.
Orq.ai API keys are scoped to a single project, so the Orq MCP server only exposes the Agents, experiments, Datasets, and Traces within that project. Use a key from the project whose entities MiMo Code should manage.