Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.auriko.ai/llms.txt

Use this file to discover all available pages before exploring further.

Auriko connects to Claude Code through environment variables, giving you access to multiple models through a single API key.

​
Prerequisites

​
Clear existing Anthropic login

If you’ve previously logged in to Claude Code with an Anthropic account, cached credentials take precedence over environment variables. Clear them first: 
claude auth logout
If you haven’t logged in with Anthropic directly, skip this step.

​
Set your API key

Add these three lines to your shell profile (~/.zshrc on macOS, ~/.bashrc on Linux): 
export ANTHROPIC_BASE_URL="https://api.auriko.ai"
export ANTHROPIC_AUTH_TOKEN="ak_live_..."   # your Auriko API key
export ANTHROPIC_API_KEY=""
ANTHROPIC_API_KEY="" must be an empty string. If it contains any value, Claude Code uses it directly against Anthropic, bypassing Auriko. The base URL must not include /v1. Claude Code appends /v1/messages itself. Reload your shell after saving: 
source ~/.zshrc   # or: source ~/.bashrc
Or open a new terminal.
To keep claude connected to your Anthropic account, create a wrapper command instead of modifying your shell profile.Add your Auriko API key to your shell profile (~/.zshrc or ~/.bashrc):
export AURIKO_API_KEY="ak_live_..."
Create the wrapper script:
mkdir -p ~/.local/bin
cat > ~/.local/bin/claude-auriko << 'EOF'
#!/usr/bin/env bash
export ANTHROPIC_BASE_URL="https://api.auriko.ai"
export ANTHROPIC_AUTH_TOKEN="${AURIKO_API_KEY}"
export ANTHROPIC_API_KEY=""
exec claude "$@"
EOF
chmod +x ~/.local/bin/claude-auriko
Add ~/.local/bin to your PATH if it isn’t already:
export PATH="$HOME/.local/bin:$PATH"
Reload your shell, then verify:
claude-auriko -p "Say exactly: setup-ok" --model claude-haiku-4-5-20251001
Use claude-auriko for Auriko sessions and claude for your Anthropic subscription. You don’t need to clear your Anthropic login.

​
Verify

claude -p "Say exactly: setup-ok" --model claude-haiku-4-5-20251001
Claude Code includes a system prompt on every request. The first request in a session costs more than follow-ups due to prompt caching. Factor this into your cost estimates.

​
Use different models

Pass any Auriko model ID with the --model flag: 
claude --model deepseek-v4-flash
claude --model gemini-2.5-flash
claude --model grok-4.3
Model IDs must be exact. Claude Code requires reasoning support from every model. Models that don’t support reasoning return a 400 error. Browse per-model capabilities in the directory API. These are some of the models available through Auriko:
ModelAuthorContext
claude-sonnet-4-6Anthropic1M
claude-opus-4-6Anthropic1M
claude-opus-4-7Anthropic1M
deepseek-v4-flashDeepSeek1M
deepseek-v4-proDeepSeek1M
gemini-2.5-flashGoogle1M
gemini-2.5-proGoogle1M
gemini-3.1-pro-previewGoogle1M
glm-5.1Z.AI200K
grok-4.3xAI1M
kimi-k2.5Moonshot262K
kimi-k2.6Moonshot262K
minimax-m2-7MiniMax205K
minimax-m2-7-highspeedMiniMax205K
qwen-3.6-plusAlibaba1M
To list available models: 
curl -s -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  https://api.auriko.ai/v1/models | jq '.data[].id'
The /model picker in interactive sessions lists only Claude tier names (Opus, Sonnet, and Haiku). To switch to a non-Claude model mid-session, type the full ID: /model deepseek-v4-flash. You can also remap the tier aliases (next section) so picker entries route through Auriko.

​
Override model tier aliases

Claude Code uses three model tiers (sonnet, opus, haiku). You can override which model each tier maps to: 
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-flash"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-4-7"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5-20251001"
Add these to your shell profile alongside the other environment variables. If you’re using the claude-auriko wrapper, add these exports to the wrapper script instead.

​
Switch back to direct Anthropic

Remove or comment out the three environment variables from your shell profile, then reload and re-authenticate: 
source ~/.zshrc
claude auth login

​
Troubleshoot

SymptomCauseFix
”model may not exist or you may not have access”Model ID isn’t exact (e.g., claude-haiku-4-5 instead of claude-haiku-4-5-20251001)Use the full model ID from GET /v1/models
Requests go to Anthropic directly, not AurikoANTHROPIC_API_KEY contains a valueSet ANTHROPIC_API_KEY="" (empty string, not unset)
“Invalid API Key” or auth errorsCached Anthropic OAuth credentialsRun claude auth logout, then verify env vars are set
Requests hang or timeoutANTHROPIC_BASE_URL includes /v1Use https://api.auriko.ai only
”does not support reasoning/extended thinking”Claude Code requires reasoning support but this model doesn’t have itUse a reasoning-capable model (see “Use different models” above)
apiKeySource: none in session eventsClaude Code doesn’t classify ANTHROPIC_AUTH_TOKEN as a key sourceExpected behavior. Requests authenticate correctly