Skip to main content
Each tool keeps the protocol it already speaks — you only change the base URL and key. Get a key from the Dashboard first. Pick any model id from Models.

​
Claude Code

Claude Code uses the Anthropic protocol, so its base URL is the bare host https://api.omniakey.com.
Switch models inside Claude Code with /model (e.g. claude-opus-4-8).

​
Codex

Codex uses OpenAI-compatible Responses traffic. Add a provider in ~/.codex/config.toml:

​
Cursor

In Settings → Models → API Keys, enable OpenAI API Key, paste your key, and set Override Base URL to https://api.omniakey.com/v1. Add model ids such as claude-opus-4-8 or gpt-5.5.

​
Cline

Choose the OpenAI Compatible provider:
  • Base URL: https://api.omniakey.com/v1
  • API Key: your OmniaKey key
  • Model ID: e.g. claude-opus-4-8

​
aider

​
Gemini CLI

Gemini CLI authenticates through your Google account and doesn’t expose a setting to point at a third-party base URL — the request to add one was closed as not planned. You can’t route Gemini CLI itself through OmniaKey today. To use Gemini models through OmniaKey, reach them over the OpenAI-compatible endpoint from any tool or SDK above — only the model id changes:
The same holds for Cursor, Cline, Codex, and the OpenAI SDK: keep the /v1 base URL and set the model to gemini-3.1-pro-preview or gemini-3-flash-preview. See Models for the full Gemini lineup.

​
Troubleshooting

  • 401 / auth errors — confirm the key is active in the Dashboard.
  • Wrong base URL — match the protocol your tool speaks: bare host https://api.omniakey.com for Claude Code (Anthropic), https://api.omniakey.com/v1 for OpenAI-compatible tools, https://api.omniakey.com/v1beta for the Gemini-native SDK. A 404 on a path like /v1/messages usually means the suffix is wrong for the protocol.
  • Unknown model — copy the exact id from Models; ids are case-sensitive.
  • Requests rejected — check the key’s spending cap and your balance in the Dashboard.