Integrations

Bring Zro to your coding tools.

Use the launcher for Zro-owned setup with telemetry disabled, or configure apps manually when they own their provider settings.

Quick startTerminal
npm install -g @moonmath-ai/zro
zro login
zro launch claude --model minimax-m3
zro launch codex --model glm-5.2
zro launch codex-app --model minimax-m3
zro launch pi --model minimax-m3
Map

Choose the right setup path

Zro web search is configured automatically by supported launchers. It costs $0.02 per search from the same spend balance as inference.

ToolMethodCommand or settingWeb searchConfig impact
Claude Codezro launchzro launch claude --model minimax-m3AvailableNo persistent Claude config changes
Codex CLIzro launchzro launch codex --model minimax-m3UnavailableNo ~/.codex/config.toml changes
OpenCodezro launchzro launch opencode --model minimax-m3AvailableTemporary merged config only
Hermeszro launchzro launch hermes --model minimax-m3AvailableTemporary home config only
OpenClawzro launchzro launch openclaw --model minimax-m3AvailableTemporary home config only
Pizro launchzro launch pi --model minimax-m3AvailableTemporary PI_CODING_AGENT_DIR only
Codex Appzro launchzro launch codex-app --model minimax-m3UnavailableZro-owned CODEX_HOME; no ~/.codex changes
ClineManualCline OpenAI Compatible providerNot configuredStored by Cline
CursorManualCursor Settings -> ModelsNot configuredStored by Cursor
CLI

Command reference

zro login

Store your Zro API key once using a masked prompt.

zro login --api-key sk-...

Fast setup from the account page. This can land in shell history.

zro auth status

Show whether ZRO_API_KEY or the stored login key will be used.

zro logout

Remove the stored Zro API key.

zro launch claude --model minimax-m3

Launch Claude Code with Zro for this session.

zro launch codex --model glm-5.2 -- --sandbox workspace-write

Launch Codex CLI and pass native Codex flags after --.

zro launch codex-app --model minimax-m3

Launch Codex App with a Zro-owned Codex home.

zro launch opencode

Launch OpenCode with a temporary Zro provider config.

zro launch pi

Launch Pi with a temporary Zro models.json.

Auth

How Zro login works

Zro stores only your Zro API key. It does not write Claude Code, Codex CLI, or app-owned configs. Codex App uses a Zro-owned CODEX_HOME, and the other launchers build temporary session config at launch time.

1
--api-key

Highest priority. Useful for one-off commands and generated setup snippets.

2
ZRO_API_KEY

Best for CI and shells. If set, it overrides the stored login key.

3
Stored login key

Created by the Zro login command at ~/.config/zro/credentials.json with private file permissions.

Check authTerminal
zro auth status
zro logout
Launchers

Launch with Zro

The Zro launcher disables vendor telemetry and analytics for every launcher-supported tool. Prompts and completions go directly from your machine to the Zro endpoint. When an agent uses web search, Zro sends only its search query—not the full conversation—to Brave Search.

Claude Code

zro launch claude --model minimax-m3

Open /model inside Claude Code if you want to switch Zro models.

Codex CLI

zro launch codex --model minimax-m3

Zro supplies runtime provider overrides and a temporary model catalog.

Codex App

zro launch codex-app --model minimax-m3

Zro launches the desktop app with CODEX_HOME pointed at ~/.config/zro/codex-app.

OpenCode

zro launch opencode --model minimax-m3

Zro launches OpenCode with a temporary XDG config root.

Hermes

zro launch hermes --model minimax-m3

Zro uses a temporary Hermes home for the launched session.

OpenClaw

zro launch openclaw --model minimax-m3

Zro writes a temporary OpenClaw home config and removes it after exit.

Pi

zro launch pi --model minimax-m3

Zro points PI_CODING_AGENT_DIR at a temporary agent config with Zro models.

Manual

Apps with their own model settings

These apps connect directly to the Zro endpoint, but unlike the launcher tools they manage their own provider settings. Cursor additionally routes requests through its own servers — see the notes below.

Cline

Use Cline's OpenAI Compatible provider when you want Cline to call Zro directly.

Cline SettingsCline
API Provider: OpenAI Compatible
Base URL: https://zro.moonmath.ai/v1
API Key: sk-...
Model ID: minimax-m3
Other model ID: glm-5.2
Max output tokens: 64000

Cursor

Use Cursor's model settings when you want Cursor to manage the provider itself.

Cursor Settings -> ModelsCursor
Open Cursor Settings -> Models.

In the OpenAI API key section:

Enable OpenAI API Key and paste:
sk-...

Enable Override OpenAI Base URL and set:
https://zro.moonmath.ai/v1

Add custom model IDs:
minimax-m3
glm-5.2

Click Verify, then Save.