use case · Teams optimising cost or routing agents through a gateway

Point Claude Code at MiniMax, OpenRouter, or your own gateway

Anthropic-shaped agents (Claude Code, Droid, OpenCode) can run against MiniMax, OpenRouter, or any Anthropic-compatible proxy. Ringlet binds a profile to a provider and injects the right base-URL and credentials at launch — the agent's config is never touched.

The problem

  • Running Claude Code against a cheaper Anthropic-compatible provider means hand-setting ANTHROPIC_BASE_URL and hoping you didn't leak the wrong key.
  • Different projects have different provider policies — some need Anthropic direct for compliance, others can use MiniMax for cost.
  • Routing every agent through a self-hosted gateway for audit is fiddly to wire per-CLI.

How Ringlet handles it

Bind a provider to a profile

`ringlet profiles create claude work --provider minimax` binds the profile. At launch Ringlet injects the provider's base-URL and credentials so the agent talks to the right endpoint.

First-party and custom providers

First-party support for Anthropic, OpenAI, MiniMax, and OpenRouter. Anything OpenAI-compatible — Groq, Together, Fireworks, your own gateway — works via a custom-provider TOML stanza.

Cost tracked regardless of destination

Wherever the request goes, Ringlet still parses the token-usage events and records spend locally, so switching providers never blinds your cost dashboard.

The commands

terminal
# Point Claude Code at MiniMax for this project
ringlet profiles create claude cheap --provider minimax

# Route another profile through your own gateway
ringlet providers add company-gw \
  --base-url https://gw.internal/anthropic \
  --shape anthropic

ringlet profiles create claude audited --provider company-gw
ringlet profiles run audited

Keep reading

faq

Questions

The agent runs unchanged — Ringlet only changes where its requests are sent. Model quality and behaviour depend on the provider you bind, not on Ringlet.

ship it

Set this up in under a minute.

Ringlet is a single Rust binary, open source under MIT. Install pulls the right build for your OS and runs ringlet init.