Use OminiGate in Claude Code

Overview

Claude Code is Anthropic's AI-powered coding assistant — an agentic tool that reads your codebase, edits files across projects, runs commands, and integrates with your development tools. It runs in the terminal, inside VS Code and JetBrains IDEs, as a desktop app, and on the web, all driven by the same Anthropic Messages API.

Every surface honors the ANTHROPIC_BASE_URL environment variable, so any gateway that exposes an Anthropic-compatible /v1/messages endpoint can replace api.anthropic.com. OminiGate serves exactly that endpoint — Claude Code works out of the box once you point it at us.

• Drop-in replacement — no config file edits, no recompilation.
• Access every Claude model plus third-party models routed through OminiGate.
• One API key, one balance, unified usage dashboard.

Prerequisites

Before you start, make sure Claude Code is installed and you have an OminiGate API key.

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

Configure Claude Code

The official LLM gateway guide calls for only two required values: ANTHROPIC_BASE_URL (the endpoint) and ANTHROPIC_AUTH_TOKEN (the bearer token). You can store them in Claude Code's settings file or export them in your shell — pick whichever fits your workflow.

unset ANTHROPIC_API_KEY
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL

Option A — settings.json (recommended)

Store the config in Claude Code's own settings file. Doesn't pollute your shell, survives new terminals, and is what the official llm-gateway guide suggests for persistent setups. API_TIMEOUT_MS (in milliseconds) prevents long agentic loops from hitting the default timeout; CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC turns off telemetry.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.ominigate.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-omg-your-api-key",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

Create the file if it doesn't exist. Claude Code reads ~/.claude/settings.json at startup — no restart of other shells needed.

"ANTHROPIC_DEFAULT_OPUS_MODEL": "anthropic/claude-opus-4.6",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "anthropic/claude-sonnet-4.6",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "anthropic/claude-haiku-4.5"

Option B — Export for the current shell

Quickest ad-hoc path. Variables live only in the current terminal, so your default Claude Code setup elsewhere stays untouched.

export ANTHROPIC_BASE_URL="https://api.ominigate.ai"
export ANTHROPIC_AUTH_TOKEN="sk-omg-your-api-key"

claude

If you want this across every new shell, add the same two exports to ~/.zshrc or ~/.bashrc.

Verify the setup

1. Check the TUI state

Start claude in any directory, then from inside the TUI run /status and /model. These confirm Claude Code picked up your config — they're the quickest way to tell whether env vars or settings.json actually took effect.

/status   # expect ANTHROPIC_BASE_URL pointing at api.ominigate.ai
/model    # expect an anthropic/... slug

2. Run a real task

Either pass --model at launch, or swap models mid-session with /model. No ANTHROPIC_MODEL env var needed.

# One-shot with an explicit model
claude --model anthropic/claude-opus-4.6 "Write a hello world in Rust"

# Or inside an existing session
> /model anthropic/claude-sonnet-4.6

Charges land in your OminiGate dashboard within seconds. If nothing shows up under Usage, double-check ANTHROPIC_BASE_URL and that the model slug you picked is one OminiGate recognizes.

Recommended models

Claude Code speaks the Anthropic Messages format, so Anthropic models are the most compatible pick. You can also pass any other model that supports the Messages format.

Browse the full catalog at /models.

Troubleshooting