Setup paths

Sage Router Integrations

Use one Sage Router endpoint from hosted clients, local tools, Tailnet agents, and BYOK-compatible provider stacks. Start with generated sk_sage_* hosted keys for https://api.sagerouter.dev/v1, or run the router on local port 8790 when provider credentials should stay on your own host.

Create hosted API key Read quickstart Configure Codex Agent-native routing

No provider key or credit card required until your generated sk_sage key exists.

Hosted API

Use https://api.sagerouter.dev/v1 with an active generated sk_sage_* key for account-managed quotas, usage analytics, fallback routing, and public edge reliability.

Local router

Use http://127.0.0.1:8790/v1 for local agents, Docker Desktop, Umbrel, or developer machines where provider credentials and subscriptions stay under local custody.

Tailnet router

Use http://<tailnet-host>:8790/v1 for private fleet routing across healthy Sage Router installations before placing a public edge in front.

Choose the client you already use

These setup paths share the same model profiles, provider authorization boundary, and no-secret support posture.

OpenAI-compatible

OpenAI SDKs, LangChain, LiteLLM, and custom clients

Set OPENAI_BASE_URL=https://api.sagerouter.dev/v1 or local port 8790, then call sage-router/frontier through chat completions or Responses API-compatible routes.

Codex

Codex CLI and OpenClaw Codex profiles

Use wire_api = "responses", model = "sage-router/frontier", and the hosted, local, or Tailnet base URL that matches your custody model.

Code agents

Cursor, Aider, Continue, Claude Code, and OpenHands

Point OpenAI-compatible settings at Sage Router first, then let route profiles and health-aware fallback pick the best authorized backend.

Local models

Ollama, Ollama Cloud, NVIDIA NIM, and BYOK endpoints

Run Sage Router beside the provider runtime, discover available models where supported, and expose only the routing endpoint to agents.

Anthropic-compatible

Claude-style client adapters

Use Anthropic-compatible client routes where your harness expects them, while keeping provider credentials customer-authorized and private.

OpenClaw

OpenClaw, Hermes, and Pi agents

Use route profiles such as sage-router/frontier, sage-router/balanced, and sage-router/agentic instead of hard-coding one vendor model.

Do not paste prompts or secrets

Support and setup reviews should use account email, plan, timestamp, HTTP status, request id, safe error class, and non-secret key prefix only. Do not paste prompts, workflow text, provider credentials, OAuth tokens, generated API keys, private keys, session cookies, raw provider responses, or customer data.