Setup guide

Use onomeo in Claude Code

Claude Code is a coding agent that works in the terminal, and it only speaks the Anthropic format. This site has an endpoint in that format, open only to the provider keys you connected on the My providers page: the site converts each request and sends it to your provider, and what it uses up is your allowance with that provider.

Anthropic's coding agent, on your own provider keys.

The three values it asks for

Anthropic format

Use these details in a tool that speaks the Anthropic format.

Base URL

API key

ModelConnect a provider, then use my/<provider>/<model>

No key yet? Create one on the dashboard, then come back — the fields below fill in by themselves. Go to the dashboard

Step by step

On the My providers page of the dashboard, connect a key from at least one provider and note the name of the model you want, written as my/<provider>/<model>.
Open ~/.claude/settings.json (on Windows, %USERPROFILE%\.claude\settings.json), or create it if it does not exist, and add the block below with your own key and model name.
Save, restart Claude Code and run /status to confirm that the address shown is this site.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://onomeo.com",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "my/PROVIDER/MODEL_NAME",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "my/PROVIDER/MODEL_NAME",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "my/PROVIDER/MODEL_NAME",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "my/PROVIDER/MODEL_NAME",
    "CLAUDE_CODE_SUBAGENT_MODEL": "my/PROVIDER/MODEL_NAME"
  }
}

If it will not connect

The address is https://onomeo.com and nothing more. Do not add /v1 on the end; Claude Code adds the path itself.
The model name must start with my/. One of this site's own models comes back with the own_key_only error: Claude Code sends the whole conversation and every file it has read with each request, which the free allowance this site shares among everyone cannot carry.
Give all five model variables the same name. Claude Code runs its background tasks on a different model name by default, and leaving those unset fails because that model cannot be found.
Claude Code reads and writes files entirely through tool calls, so the model you choose must support them and handle them reliably. If the model says it changed a file and the file is unchanged, move to a stronger model.
On your own key, this site charges a hundredth of the usual amount. Measured in September 2026, one very small task (reading two files, changing two places) took about 500 credits; whatever the calls cost at the provider is settled between you and them.
Anthropic does not support connecting Claude Code to models other than Claude. If a Claude Code update stops working with this site, tell us through the contact page.

Claude Code's own documentation