직접 설정

sotatek-proxy를 설치한 후, Claude Code가 로컬 프록시를 가리키도록 하고 프로바이더를 선택합니다 (Claude 모델의 경우 FridayAIX, MiniMax 모델의 경우 MiniMax). 프록시는 요청을 Sotatek Bifrost 게이트웨이로 전달하며 로컬 Attribution 헤더를 추가합니다.

사전 요구사항

1. sotatek-proxy가 127.0.0.1:3817에 설치되어 실행 중이어야 합니다. 확인 방법:

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

2. Bifrost 가상 키 (sk-bf-xxx) — 관리자에게 문의하세요.

공통 파라미터

변수	값
ANTHROPIC_AUTH_TOKEN	가상 키 — 형식: sk-bf-xxx
ANTHROPIC_BASE_URL	http://127.0.0.1:3817/anthropic

프로바이더 선택

FridayAIX (Claude)

변수	값
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

MiniMax

변수	값
ANTHROPIC_DEFAULT_OPUS_MODEL	MiniMax/MiniMax-M2.7
ANTHROPIC_DEFAULT_SONNET_MODEL	MiniMax/MiniMax-M2.5
ANTHROPIC_DEFAULT_HAIKU_MODEL	MiniMax/MiniMax-M2.5-highspeed

---

CLI로 설정하기

sotatek-proxy setup -p claudecode는 ~/.claude/settings.json에 필요한 환경 변수를 자동으로 작성합니다 — 파일을 직접 편집할 필요가 없습니다. 기존 파일은 작성 전에 백업됩니다.

FridayAIX (Claude)

sotatek-proxy setup -p claudecode -m fridayaix -k sk-bf-your-key

MiniMax

sotatek-proxy setup -p claudecode -m minimax -k sk-bf-your-key

플래그	설명
-m / --model	모델 프로필: fridayaix, minimax (기본값: fridayaix)
-k / --key	Bifrost 가상 키; 생략 시 기존 settings 또는 ANTHROPIC_AUTH_TOKEN 환경 변수 사용
--workspace	사용자 레벨 대신 현재 프로젝트의 .claude/settings.json에 작성
--dry-run	파일을 작성하지 않고 대상 경로 미리 보기

실행 후 Claude Code를 재시작하여 변경 사항을 적용하세요.

---

macOS / Linux

방법 A — 셸 프로필 (영구 적용)

~/.zshrc (zsh, macOS 기본값) 또는 ~/.bashrc (bash, Linux에서 일반적)를 편집합니다:

FridayAIX (Claude)

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"

MiniMax

export ANTHROPIC_AUTH_TOKEN="sk-bf-your-virtual-key-here"
export ANTHROPIC_BASE_URL="http://127.0.0.1:3817/anthropic"
export ANTHROPIC_DEFAULT_OPUS_MODEL="MiniMax/MiniMax-M2.7"
export ANTHROPIC_DEFAULT_SONNET_MODEL="MiniMax/MiniMax-M2.5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="MiniMax/MiniMax-M2.5-highspeed"

다시 로드합니다:

source ~/.zshrc       # 또는 source ~/.bashrc
echo $ANTHROPIC_BASE_URL

방법 B — Claude Code settings.json (권장)

mkdir -p ~/.claude
nano ~/.claude/settings.json

FridayAIX (Claude)

{
  "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"
  }
}

MiniMax

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-bf-your-virtual-key-here",
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3817/anthropic",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax/MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax/MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax/MiniMax-M2.5-highspeed"
  }
}

저장 후 Claude Code를 재시작합니다.

---

Windows

방법 A — 시스템 환경 변수 (GUI)

1. Win + R을 누르고 sysdm.cpl을 입력한 후 Enter를 누릅니다.
2. 고급 탭 → 환경 변수.
3. 사용자 변수 아래에서 각 항목에 대해 새로 만들기를 클릭합니다:

FridayAIX (Claude)

변수	값
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

MiniMax

변수	값
ANTHROPIC_AUTH_TOKEN	sk-bf-your-virtual-key-here
ANTHROPIC_BASE_URL	http://127.0.0.1:3817/anthropic
ANTHROPIC_DEFAULT_OPUS_MODEL	MiniMax/MiniMax-M2.7
ANTHROPIC_DEFAULT_SONNET_MODEL	MiniMax/MiniMax-M2.5
ANTHROPIC_DEFAULT_HAIKU_MODEL	MiniMax/MiniMax-M2.5-highspeed

모든 대화 상자에서 확인을 클릭한 후 터미널 또는 IDE를 재시작합니다.

방법 B — PowerShell (영구 적용)

FridayAIX (Claude)

[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")

MiniMax

[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_DEFAULT_OPUS_MODEL", "MiniMax/MiniMax-M2.7", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_SONNET_MODEL", "MiniMax/MiniMax-M2.5", "User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_DEFAULT_HAIKU_MODEL", "MiniMax/MiniMax-M2.5-highspeed", "User")

터미널을 재시작한 후 확인합니다:

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_DEFAULT_OPUS_MODEL

방법 C — Claude Code settings.json

%USERPROFILE%\.claude\settings.json — macOS/Linux 방법 B와 동일한 JSON 형식입니다.

---

확인

claude --version
claude "Hello, are you connected through Bifrost?"

정상 응답이 오면 연결 성공입니다. 인증 오류가 발생하면 ANTHROPIC_AUTH_TOKEN을 확인하세요.

프로바이더 전환

나머지는 그대로 두고 ANTHROPIC_MODEL (또는 세 개의 ANTHROPIC_DEFAULT_* 변수)만 업데이트하면 됩니다:

프로바이더	모델 값
FridayAIX	fridayaix/claude-opus-4-6
FridayAIX	fridayaix/claude-sonnet-4-6
FridayAIX	fridayaix/claude-haiku-4-5-20251001
MiniMax	MiniMax/MiniMax-M2.7
MiniMax	MiniMax/MiniMax-M2.5
MiniMax	MiniMax/MiniMax-M2.5-highspeed

문제 해결

문제	해결 방법
인증 실패	가상 키가 활성화되어 있는지 확인하세요. 관리자에게 문의하세요.
127.0.0.1:3817 연결 거부됨	sotatek-proxy가 실행 중이지 않습니다. sotatek-proxy status 및 sotatek-proxy start를 실행하세요.
모델을 찾을 수 없음	모델 이름에 프로바이더 접두사가 포함되어 있는지 확인하세요 (예: fridayaix/claude-opus-4-6).
변수가 적용되지 않음	변수 설정 후 터미널/IDE를 재시작하세요. Windows에서는 전체 재시작이 필요할 수 있습니다.

팁

환경 변수를 직접 편집하는 대신 전환기를 사용하고 싶으신가요? CCS 설정을 참고하세요.