Framework integrations
Every SDK and agent framework here connects the same way: change one base URL. The gateway speaks each provider's native protocol on its native path, so nothing else in your code changes. Put an app name in the URL — /w/<app> — and that traffic is attributed to it, with no extra headers.
The local default base URL is http://127.0.0.1:8787. Connected or managed use swaps in the cloud gateway URL and adds gateway auth (x-cave-api-key) plus your per-request provider key (x-cave-upstream-key) as request headers; the Anthropic and OpenAI SDK recipes show exactly where those go in a trailing comment.
What the gateway does — and doesn't
The gateway routes your request to the provider, meters truthful spend, and (in record mode) passes bytes through unchanged. It does not rewrite prompts or claim savings. Local spend is inferred, never verified.