Coming soon
Zaino Agent CLI
One command to put the gateway in your terminal. In development.
Until then: Zaino models in Claude Desktop
Claude Desktop speaks the Anthropic Messages API. The gateway serves it, so any Zaino tier works as a custom inference endpoint — with your existing API key and billing.
Before you start
You need Claude Desktop installed, and a Zaino API key. Open /dashboard/api-keys and issue one with the tiers you want to use.
Check the gateway answers
Your key should list the models it may use
curl -s https://api.zaino.soon.it/v1/models \
-H "Authorization: Bearer zn-YOUR_KEY" | jq -r '.data[].id'If a tier is missing from that list, your key is not allowlisted for it — the gateway is working, the key is not.
Add the endpoint
- 1
Open Settings
In Claude Desktop, go to Settings, then Developer. - 2
Add a custom inference endpoint
Under Developer, add an Anthropic-compatible endpoint. Enter the base URL and your key:
Base URL
https://api.zaino.soon.itAPI key
zn-YOUR_KEYNo /v1 suffix — the client appends it. A base URL ending in /v1/v1 returns 404.
- 3
Restart Claude Desktop
Quit fully and reopen. The endpoint only loads at startup. - 4
Pick a Zaino tier
Use the model picker, or name the model in your request. Tiers areclaude-fast,claude-smart,claude-frontierandclaude-fable.
Send one request
Proves the whole path: edge, gateway, model
curl -s https://api.zaino.soon.it/v1/messages \
-H "x-api-key: zn-YOUR_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-smart",
"max_tokens": 64,
"messages": [{ "role": "user", "content": "Say ok" }]
}'If something is wrong
- 404 — the base URL has a trailing path. Use
https://api.zaino.soon.itwith no/v1. The client appends it. - 401 — the key is wrong or revoked. Re-issue it from the dashboard.
- 403 — the key is valid but not allowlisted for that tier. Issue a key that includes it.
- Images ignored — use
/v1/messages, not/v1/chat/completions. Images are stripped on the chat path.
Context is 1M tokens per request and up to 64K output on every tier. Claude Desktop may report a smaller window for model names it does not recognise — the gateway still accepts the full 1M.