ContextQMD
Back to OmniaKey

Coding Agents

en-coding.md

latest3.2 KB
Original Source

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.

macOS / Linux

Windows (PowerShell)

export ANTHROPIC_BASE_URL="https://api.omniakey.com"
export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
claude

$env:ANTHROPIC_BASE_URL = "https://api.omniakey.com"
$env:ANTHROPIC_AUTH_TOKEN = "your-omniakey-api-key"
claude

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:

model = "gpt-5.5"
model_provider = "omniakey"

[model_providers.omniakey]
name = "OmniaKey"
wire_api = "responses"
env_key = "OMNIAKEY_API_KEY"
base_url = "https://api.omniakey.com/v1"

export OMNIAKEY_API_KEY="your-omniakey-api-key"
codex

​ 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

export OPENAI_API_BASE="https://api.omniakey.com/v1"
export OPENAI_API_KEY="your-omniakey-api-key"

aider --model openai/claude-opus-4-8

​ 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:

export OPENAI_API_BASE="https://api.omniakey.com/v1"
export OPENAI_API_KEY="your-omniakey-api-key"

aider --model openai/gemini-3.1-pro-preview

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.

Balance and UsageClaude Code API Key

⌘I