Bỏ qua để đến nội dung
🔌 Sotatek Proxy

Cấu hình trực tiếp

Sau khi cài đặt sotatek-proxy, hãy trỏ Claude Code đến proxy cục bộ và chọn một provider (FridayAIX cho các model Claude, MiniMax cho các model MiniMax). Proxy chuyển tiếp request của bạn đến Sotatek Bifrost gateway và thêm các header attribution cục bộ trong quá trình đó.

Yêu cầu trước

Phần tiêu đề “Yêu cầu trước”

  1. sotatek-proxy đã cài đặt và đang chạy tại 127.0.0.1:3817. Kiểm tra với:

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

  2. Một Bifrost virtual key (sk-bf-xxx) — liên hệ admin của bạn.

Các tham số chung

Phần tiêu đề “Các tham số chung”
BiếnGiá trị
ANTHROPIC_AUTH_TOKENVirtual key của bạn — định dạng sk-bf-xxx
ANTHROPIC_BASE_URLhttp://127.0.0.1:3817/anthropic

Chọn provider

Phần tiêu đề “Chọn provider”
BiếnGiá trị
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

Cấu hình qua CLI

Phần tiêu đề “Cấu hình qua CLI”

sotatek-proxy setup -p claudecode tự động ghi tất cả biến môi trường cần thiết vào ~/.claude/settings.json — không cần chỉnh sửa file thủ công. Lệnh sẽ sao lưu file hiện có trước khi ghi.

Terminal window
sotatek-proxy setup -p claudecode -m fridayaix -k sk-bf-your-key
CờMô tả
-m / --modelModel profile: fridayaix, minimax (mặc định: fridayaix)
-k / --keyBifrost virtual key; tự dùng key có sẵn trong settings hoặc biến ANTHROPIC_AUTH_TOKEN nếu không truyền
--workspaceGhi vào .claude/settings.json của project hiện tại thay vì user-level
--dry-runXem trước đường dẫn đích mà không ghi file

Khởi động lại Claude Code sau khi chạy để áp dụng thay đổi.

macOS / Linux

Phần tiêu đề “macOS / Linux”

Tùy chọn A — shell profile (vĩnh viễn)

Phần tiêu đề “Tùy chọn A — shell profile (vĩnh viễn)”

Chỉnh sửa ~/.zshrc (zsh, mặc định trên macOS) hoặc ~/.bashrc (bash, phổ biến trên 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"

Tải lại:

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

Tùy chọn B — Claude Code settings.json (khuyến nghị)

Phần tiêu đề “Tùy chọn B — Claude Code settings.json (khuyến nghị)”
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"
  }
}

Lưu và khởi động lại Claude Code.

Windows

Phần tiêu đề “Windows”

Tùy chọn A — Biến môi trường hệ thống (GUI)

Phần tiêu đề “Tùy chọn A — Biến môi trường hệ thống (GUI)”
  1. Nhấn Win + R, gõ sysdm.cpl, Enter.
  2. Tab Advanced → Environment Variables.
  3. Trong User variables, nhấp New cho từng dòng:
BiếnGiá trị
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

Nhấp OK trên tất cả các hộp thoại, sau đó khởi động lại terminal hoặc IDE.

Tùy chọn B — PowerShell (vĩnh viễn)

Phần tiêu đề “Tùy chọn B — PowerShell (vĩnh viễn)”
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")

Khởi động lại terminal. Xác minh:

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

Tùy chọn C — Claude Code settings.json

Phần tiêu đề “Tùy chọn C — Claude Code settings.json”

%USERPROFILE%\.claude\settings.json — cùng JSON như Tùy chọn B của macOS/Linux ở trên.

Xác minh

Phần tiêu đề “Xác minh”
Terminal window
claude --version
claude "Hello, are you connected through Bifrost?"

Phản hồi thành công = hoạt động bình thường. Lỗi xác thực = kiểm tra ANTHROPIC_AUTH_TOKEN.

Chuyển đổi provider sau này

Phần tiêu đề “Chuyển đổi provider sau này”

Giữ nguyên mọi thứ khác và chỉ cập nhật ANTHROPIC_MODEL (hoặc ba biến ANTHROPIC_DEFAULT_*):

ProviderGiá trị model
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

Xử lý sự cố

Phần tiêu đề “Xử lý sự cố”
Vấn đềGiải pháp
Xác thực thất bạiXác minh virtual key của bạn còn hoạt động. Liên hệ admin.
Kết nối bị từ chối trên 127.0.0.1:3817sotatek-proxy không chạy. Chạy sotatek-proxy status và sotatek-proxy start.
Model không tìm thấyĐảm bảo tên model có tiền tố provider (ví dụ fridayaix/claude-opus-4-6).
Biến chưa được áp dụngKhởi động lại terminal/IDE sau khi đặt biến. Trên Windows, có thể cần khởi động lại hoàn toàn.