VS Code

VS Code는 settings.json의 claudeCode.environmentVariables에서 프록시 엔드포인트, 가상 키, 대상 모델을 읽습니다. 나중에 프로바이더를 전환하려면 ANTHROPIC_MODEL 값만 변경하면 됩니다 — 나머지는 그대로 유지됩니다.

사전 요구사항

1. VS Code 설치됨
2. sotatek-proxy가 127.0.0.1:3817에 설치되어 실행 중
3. Bifrost 가상 키 (sk-bf-xxx) — 관리자에게 문의하세요

---

CLI로 설정하기

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

FridayAIX (Claude)

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

MiniMax

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

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

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

---

1단계 — Claude Code 확장 프로그램 설치

VS Code → 확장 프로그램 → Claude Code 검색 → 설치.

2단계 — settings.json 열기

Cmd+Shift+P (macOS) 또는 Ctrl+Shift+P (Windows/Linux) → Preferences: Open User Settings (JSON).

워크스페이스 전용 설정의 경우 워크스페이스 settings.json을 대신 여세요.

3단계 — 환경 설정 붙여넣기

sk-bf-your-virtual-key-here를 실제 키로 교체하세요. settings.json에 다른 키가 이미 있는 경우, claudeCode.environmentVariables 항목을 병합하세요 — 두 번째 루트 {}를 생성하지 마세요.

FridayAIX (Claude)

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "http://127.0.0.1:3817/anthropic"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-bf-your-virtual-key-here"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "fridayaix/claude-opus-4-6"
    },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
      "value": "fridayaix/claude-opus-4-6"
    },
    {
      "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
      "value": "fridayaix/claude-sonnet-4-6"
    },
    {
      "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
      "value": "fridayaix/claude-haiku-4-5-20251001"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS",
      "value": "1"
    },
    {
      "name": "DISABLE_PROMPT_CACHING",
      "value": "1"
    }
  ]
}

MiniMax

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "http://127.0.0.1:3817/anthropic"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-bf-your-virtual-key-here"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "MiniMax/MiniMax-M2.7"
    },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
      "value": "MiniMax/MiniMax-M2.7"
    },
    {
      "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
      "value": "MiniMax/MiniMax-M2.5"
    },
    {
      "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
      "value": "MiniMax/MiniMax-M2.5-highspeed"
    },
    {
      "name": "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS",
      "value": "1"
    },
    {
      "name": "DISABLE_PROMPT_CACHING",
      "value": "1"
    }
  ]
}

4단계 — 모델 전환

프로바이더를 전환하려면 아래 4개 환경 변수를 함께 변경하세요:

환경 변수	FridayAIX	MiniMax
ANTHROPIC_MODEL	fridayaix/claude-opus-4-6	MiniMax/MiniMax-M2.7
ANTHROPIC_DEFAULT_OPUS_MODEL	fridayaix/claude-opus-4-6	MiniMax/MiniMax-M2.7
ANTHROPIC_DEFAULT_SONNET_MODEL	fridayaix/claude-sonnet-4-6	MiniMax/MiniMax-M2.5
ANTHROPIC_DEFAULT_HAIKU_MODEL	fridayaix/claude-haiku-4-5-20251001	MiniMax/MiniMax-M2.5-highspeed

5단계 — 다시 로드 및 확인

1. settings.json을 저장합니다.
2. VS Code가 변경 사항을 인식하지 못하면 Developer: Reload Window를 실행합니다.
3. Claude Code 채팅 열기: Hello, which model are you using?
4. 인증 오류가 없는지 확인합니다.

빠른 참조

설정	값
Base URL	http://127.0.0.1:3817/anthropic
토큰 필드	ANTHROPIC_AUTH_TOKEN
모델 필드	ANTHROPIC_MODEL
토큰 형식	sk-bf-xxx

문제 해결

문제	해결 방법
인증 오류	ANTHROPIC_AUTH_TOKEN은 Bifrost 가상 키이며, ANTHROPIC_BASE_URL은 http://127.0.0.1:3817/anthropic이어야 합니다
127.0.0.1:3817 연결 거부됨	sotatek-proxy가 실행 중이지 않습니다. sotatek-proxy status && sotatek-proxy start를 실행하세요.
모델을 찾을 수 없음	프로바이더 접두사와 대소문자를 포함한 정확한 ANTHROPIC_MODEL 문자열을 확인하세요
VS Code가 새 값을 무시함	settings.json을 저장하고 Developer: Reload Window를 실행하세요
잘못된 settings.json	JSON 유효성 검사 — 쉼표와 괄호를 확인하세요