Skip to content
🔌 Sotatek Proxy

Configure directly

After installing sotatek-proxy, point Claude Code at the local proxy and pick a provider (FridayAIX for Claude models, MiniMax for MiniMax models). The proxy forwards your request to the Sotatek Bifrost gateway and adds local attribution headers along the way.

Prerequisites

Section titled “Prerequisites”

  1. sotatek-proxy installed and running on 127.0.0.1:3817. Check with:

    Terminal window
    curl http://127.0.0.1:3817/_proxy/healthz

  2. A Bifrost virtual key (sk-bf-xxx) — contact your admin.

Common parameters

Section titled “Common parameters”
VariableValue
ANTHROPIC_AUTH_TOKENYour virtual key — format sk-bf-xxx
ANTHROPIC_BASE_URLhttp://127.0.0.1:3817/anthropic

Pick a provider

Section titled “Pick a provider”
VariableValue
ANTHROPIC_MODELfridayaix/claude-opus-4-7
ANTHROPIC_DEFAULT_OPUS_MODELfridayaix/claude-opus-4-6
ANTHROPIC_DEFAULT_SONNET_MODELfridayaix/claude-sonnet-4-6
ANTHROPIC_DEFAULT_HAIKU_MODELfridayaix/claude-haiku-4-5-20251001

Configure via CLI

Section titled “Configure via CLI”

sotatek-proxy setup -p claudecode writes all required env vars directly into ~/.claude/settings.json — no manual file editing needed. It backs up the existing file before writing.

Terminal window
sotatek-proxy setup -p claudecode -m fridayaix -k sk-bf-your-key
FlagDescription
-m / --modelModel profile: fridayaix, minimax (default: fridayaix)
-k / --keyBifrost virtual key; falls back to existing settings or ANTHROPIC_AUTH_TOKEN env var
--workspaceWrite to .claude/settings.json in the current project instead of user-level
--dry-runPreview target path without writing

Restart Claude Code after running to apply the changes.

macOS / Linux

Section titled “macOS / Linux”

Option A — shell profile (permanent)

Section titled “Option A — shell profile (permanent)”

Edit ~/.zshrc (zsh, default on macOS) or ~/.bashrc (bash, common on Linux):

Terminal window
export ANTHROPIC_AUTH_TOKEN="sk-bf-your-virtual-key-here"
export ANTHROPIC_BASE_URL="http://127.0.0.1:3817/anthropic"
export ANTHROPIC_MODEL="fridayaix/claude-opus-4-7"
export ANTHROPIC_DEFAULT_OPUS_MODEL="fridayaix/claude-opus-4-6"
export ANTHROPIC_DEFAULT_SONNET_MODEL="fridayaix/claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="fridayaix/claude-haiku-4-5-20251001"

Reload:

Terminal window
source ~/.zshrc       # or source ~/.bashrc
echo $ANTHROPIC_BASE_URL

Option B — Claude Code settings.json (recommended)

Section titled “Option B — Claude Code settings.json (recommended)”
Terminal window
mkdir -p ~/.claude
nano ~/.claude/settings.json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-bf-your-virtual-key-here",
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3817/anthropic",
    "ANTHROPIC_MODEL": "fridayaix/claude-opus-4-7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "fridayaix/claude-opus-4-6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "fridayaix/claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "fridayaix/claude-haiku-4-5-20251001"
  }
}

Save and restart Claude Code.

Windows

Section titled “Windows”

Option A — System Environment Variables (GUI)

Section titled “Option A — System Environment Variables (GUI)”
  1. Press Win + R, type sysdm.cpl, Enter.
  2. Advanced tab → Environment Variables.
  3. Under User variables, click New for each row:
VariableValue
ANTHROPIC_AUTH_TOKENsk-bf-your-virtual-key-here
ANTHROPIC_BASE_URLhttp://127.0.0.1:3817/anthropic
ANTHROPIC_MODELfridayaix/claude-opus-4-7
ANTHROPIC_DEFAULT_OPUS_MODELfridayaix/claude-opus-4-6
ANTHROPIC_DEFAULT_SONNET_MODELfridayaix/claude-sonnet-4-6
ANTHROPIC_DEFAULT_HAIKU_MODELfridayaix/claude-haiku-4-5-20251001

Click OK on all dialogs, then restart your terminal or IDE.

Option B — PowerShell (permanent)

Section titled “Option B — PowerShell (permanent)”
Terminal window
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-bf-your-virtual-key-here", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "http://127.0.0.1:3817/anthropic", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "fridayaix/claude-opus-4-7", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_OPUS_MODEL", "fridayaix/claude-opus-4-6", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "fridayaix/claude-sonnet-4-6", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "fridayaix/claude-haiku-4-5-20251001", "User")

Restart your terminal. Verify:

Terminal window
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_DEFAULT_OPUS_MODEL

Option C — Claude Code settings.json

Section titled “Option C — Claude Code settings.json”

%USERPROFILE%\.claude\settings.json — same JSON as macOS/Linux Option B above.

Verify

Section titled “Verify”
Terminal window
claude --version
claude "Hello, are you connected through Bifrost?"

Successful response = working. Authentication errors = check ANTHROPIC_AUTH_TOKEN.

Switching providers later

Section titled “Switching providers later”

Keep everything else identical and only update ANTHROPIC_MODEL (or the three ANTHROPIC_DEFAULT_* variables):

ProviderModel value
FridayAIXfridayaix/claude-opus-4-6
FridayAIXfridayaix/claude-sonnet-4-6
FridayAIXfridayaix/claude-haiku-4-5-20251001
MiniMaxMiniMax/MiniMax-M2.7
MiniMaxMiniMax/MiniMax-M2.5
MiniMaxMiniMax/MiniMax-M2.5-highspeed

Troubleshooting

Section titled “Troubleshooting”
IssueSolution
Authentication failedVerify your virtual key is active. Contact admin.
Connection refused on 127.0.0.1:3817sotatek-proxy is not running. Run sotatek-proxy status and sotatek-proxy start.
Model not foundEnsure model names include the provider prefix (e.g. fridayaix/claude-opus-4-6).
Variables not appliedRestart your terminal/IDE after setting variables. On Windows, a full restart may be needed.