Run Claude Code on Uno AI

Read this first. Anthropic does not support routing Claude Code to non-Claude models through any gateway. Claude Code works with Smart and Fast through Uno, but tool calls can fail where they would not on Claude. Treat it as a way to keep working when your plan's limit runs out, and check the result. On 16 October 2026 we pointed Claude Code 2.1.284, Codex 0.154.0 and opencode 1.18.32 at Uno with a test key: each reached Uno's endpoint and got Uno's own answer to a wrong key. A full run with a real key and tool calls is still to do.

Steps

1. Copy your Uno key

   Open the Uno console: Uno AI, then Use Uno AI from your code. Copy the API key. Keep it like a password: it spends your hours and your balance.

2. Test the key with one request

   Before you change Claude Code, ask Uno one short question in Claude's own format. An answer with "content" means the address and the key work.

   $ export UNO_API_KEY=your-uno-key
   $ curl -sS https://console.uno.place/v1/messages \
       -H "Authorization: Bearer $UNO_API_KEY" \
       -H "anthropic-version: 2023-06-01" \
       -H "content-type: application/json" \
       -d '{"model": "uno/fast", "max_tokens": 50,
            "messages": [{"role": "user", "content": "Say hi"}]}'

3. Point Claude Code at Uno

   Put the settings in ~/.claude/settings.json: the env block of ~/.claude/settings.json applies everywhere Claude Code runs, and wins over a shell export. The address has no /v1 at the end: Claude Code adds /v1/messages itself.

   {
     "env": {
       "ANTHROPIC_BASE_URL": "https://console.uno.place",
       "ANTHROPIC_AUTH_TOKEN": "your-uno-key",
       "ANTHROPIC_MODEL": "uno/smart",
       "ANTHROPIC_DEFAULT_HAIKU_MODEL": "uno/fast",
       "CLAUDE_CODE_SUBAGENT_MODEL": "uno/fast"
     }
   }

   Smart writes the code. Fast takes the background jobs and the subagents: ANTHROPIC_DEFAULT_HAIKU_MODEL sets what the haiku alias resolves to, and moves background tasks such as session titles to that model. Never put the key in a project's .claude/settings.json: that file is committed and shared.

4. Start Claude Code and check the route

   Run claude in your project and type /status. You should see the Anthropic base URL line with Uno's address and an Auth token line. Claude Code may print a notice that the model is not in its catalog: Claude Code prints a notice that the model is not in its catalog and keeps the session within 200,000 tokens. Work goes on.

   $ cd your-project
   $ claude
   # in Claude Code:
   /status

5. Switch per task, or go back to your plan

   Run /model uno/fast for quick edits and /model uno/smart for work that needs a plan. To go back to your Claude subscription, remove the env block and start Claude Code again: while a gateway key is set, requests carry it instead of your claude.ai login, and your plan's limits do not apply to them.

Check that it works

Give Claude Code a small task that reads and edits a file, then open the Uno console. The minutes appear on the Uno AI page; nothing is taken from your Claude plan.

$ claude -p "Add a comment to the top of README.md that says: checked on Uno AI" --allowedTools "Read,Edit"
$ git diff README.md

What each model name costs

What it does not do

• It does not make Smart or Fast into Claude. On the Artificial Analysis index Smart has 46, Claude Opus 5.5 has 58.
• Anthropic does not support this setup. A new Claude Code version can change what it sends and break it until Uno catches up.
• Remote Control and voice dictation are off while a gateway key is set.
• On Small+AI and Plus+AI the work stops when the hours end. Only Max+AI is unlimited.

Common problems