Proxy

The proxy is an optional add-on. It runs CLIProxyAPI, a local relay on your machine that signs in to your chat subscriptions. Models named proxy/* then use those subscriptions instead of API credit. Empryo reads your plan limits from the relay and shows how much is left.

For Claude and ChatGPT you usually do not need the proxy. Both can sign in directly with /login, with no add-on. See Subscriptions. The proxy is still useful for Gemini and Grok subscriptions, and for running several accounts per provider through one relay.

Set it upLink to this section

1. Install the add-on:

empryo addon install proxy

1. Inside Empryo, run /proxy login and sign in to each subscription you want to use.
2. Press Ctrl+L and pick a proxy/* model.

Other commands you will use:

The plan meterLink to this section

plan  [▰▰▰▰▱] 78% weekly ↺3d
ctx   [▰▰▰▱▱] 42% ~12k/200k

The first line is the plan meter in the status bar. It shows the percentage of your plan you have used, which limit it is (here, the weekly one), and when that limit resets. The line below it is the context meter, which shows how full the conversation is.

What each account reportsLink to this section

Every account behind the relay reports its health: whether its sign-in works right now. Some providers also report usage limits: how much of a time-based limit you have used.

If a provider does not report usage, Empryo says so instead of guessing:

● you@example.com (xai) — ready
    no quota reported by this provider

Per-model limitsLink to this section

On a Claude subscription, the weekly allowance is not a single number. Anthropic also limits each model family separately, on top of the account-wide limits:

Subscriptions · proxy
  ● claude   you@example.com
  ▸ weekly · fable [▰▰▰▰▰▰▰▰▰▰] spent  ↺ 3d
    5h             [▰▰▰▰▰▰▰▱▱▱]   73%  ↺ 1h
    weekly         [▰▰▰▰▰▰▰▰▱▱]   78%  ↺ 3d

In this example, the Fable limit is used up, but Sonnet and Opus are still available. Same account, same week.

The ▸ marks the limit that applies to the model you are using right now. When you switch models, the marker moves and the status bar updates right away.

Which account paysLink to this section

The relay can rotate between several accounts of the same provider, but never between providers. A proxy/gpt-5.6 turn always bills your ChatGPT subscription, never your Claude one.

Where to see your limitsLink to this section

Warning levelsLink to this section

Refreshing the numbersLink to this section

Vendors limit how often you can ask for usage data, and the numbers change slowly. So Empryo keeps each report for 5 minutes. Opening a panel shows the saved report. These actions fetch fresh numbers:

• /proxy quota
• the refresh button on the desktop proxy and usage pages
• empryo --headless --proxy-quota

PrivacyLink to this section

Empryo asks the relay for your usage. The relay adds your sign-in token itself when it contacts the vendor, so the token stays inside the relay and Empryo never sees it. The relay's admin password is created automatically the first time and stored with the proxy settings.

TroubleshootingLink to this section

RelatedLink to this section

• Subscriptions: sign in to Claude, ChatGPT, and more without the proxy
• Add-ons: installing and managing add-ons
• GitHub Copilot: Copilot's monthly allowance
• Cost tracking: spending on per-token providers
• Providers overview: every way to connect a model