Finest for Claude Code

Claude Code through the Finest gateway. Your Claude plan serves until its cap. When the cap hits, the overflow valve continues the same conversation on metered billing through Finest, and flips back when your plan window resets. Every metered request gets a receipt: the model that served, what it cost, and what it saved against the model you asked for.

One-command setup

npx @finest-ai/claude-code

The wizard asks for your key (from https://finest.so/console), which mode you want, and whether to alias claude to the finest launcher. finest off restores your previous setup in one step.

The two lanes

• Finest Frontier (finest-frontier): near frontier quality within a close, published bound, much cheaper. Your requested frontier model serves verbatim unless a sealed evidence cell authorizes a substitution for that task; where one does, the receipt names the served model, the quality tier, and the published bound. Hard turns, plan mode, and compaction always serve the pinned frontier model.
• Finest Workhorse (finest-workhorse): your daily driver, task-adequate against sealed absolute quality floors, much cheaper. The lane every earlier install knows as finest-quick (and finest-fast before that); the old ids serve forever.

Everything else in the catalog is a pin: explicit model ids (claude-opus-5, kimi-k3, deepseek-v4-flash, grok-4.6, ...) serve verbatim to that vendor, never second-guessed. Per-request, x-finest-no-demote: true pins any call.

The evidence behind every substitution is published: sealed, reproducible verification records with pass AND fail verdicts, at https://finest.so/verification.

What it costs

No model markup. You pay the host's published rate for the model that actually served. Finest's fee is 25% of the saving it proves on a request, computed against what your requested model would have cost. No saving, no fee. A request served exactly as you asked carries no fee.

Controls and visibility

• Per-key rpm, token, and spend caps, set in the console.
• The statusline shows the session's spend, the as-asked counterfactual, and the swap count live inside Claude Code, with a link to the session's receipts.
• finest status shows the active config; finest valve on|off arms or disarms the overflow valve; finest desktop on|off switches the Claude Desktop app.

What this is not

• There is no free tier and no promotional credit. A workspace funds itself before its first metered request.
• The savings figure is not a constant. Substitutions happen only where a published evidence record authorizes one, and the receipt is the only claim Finest makes about a request.
• Your Claude login stays on your machine. The gateway never sees or uses it; metered serving uses your Finest key.

Leaving

finest off restores your prior Claude Code configuration (env, statusline, hooks) in one step. Pins keep serving verbatim until the moment you leave.

Pointers

• Canonical page: https://finest.so/code
• Agent install and entity reference: https://finest.so/llms.txt
• Running Claude Code past plan limits: https://finest.so/guides/run-claude-code-past-plan-limits
• Verification records: https://finest.so/verification
• Console and keys: https://finest.so/console