VS Code
VS Code đọc proxy endpoint, virtual key, và model mục tiêu từ
claudeCode.environmentVariables trong settings.json của bạn. Để chuyển đổi
provider sau này, chỉ cần thay đổi giá trị ANTHROPIC_MODEL — mọi thứ khác giữ
nguyên.
Yêu cầu trước
Phần tiêu đề “Yêu cầu trước”- VS Code đã cài đặt
- sotatek-proxy đã cài đặt và đang chạy tại
127.0.0.1:3817 - Một Bifrost virtual key (
sk-bf-xxx) — liên hệ admin của bạn
Cấu hình qua CLI
Phần tiêu đề “Cấu hình qua CLI”sotatek-proxy setup -p vscode tự động ghi tất cả biến môi trường cần thiết vào settings.json của VS Code — 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.
sotatek-proxy setup -p vscode -m fridayaix -k sk-bf-your-keysotatek-proxy setup -p vscode -m minimax -k sk-bf-your-key| Cờ | Mô tả |
|---|---|
-m / --model | Model profile: fridayaix, minimax (mặc định: fridayaix) |
-k / --key | Bifrost virtual key; tự dùng key có sẵn trong settings hoặc biến ANTHROPIC_AUTH_TOKEN nếu không truyền |
--workspace | Ghi vào .vscode/settings.json của project hiện tại thay vì user-level |
--dry-run | Xem trước đường dẫn đích mà không ghi file |
Reload VS Code sau khi chạy để áp dụng thay đổi.
Bước 1 — cài đặt extension Claude Code
Phần tiêu đề “Bước 1 — cài đặt extension Claude Code”VS Code → Extensions → tìm kiếm Claude Code → Install.
Bước 2 — mở settings.json
Phần tiêu đề “Bước 2 — mở settings.json”Cmd+Shift+P (macOS) hoặc Ctrl+Shift+P (Windows/Linux) → Preferences: Open User Settings (JSON).
Để cấu hình chỉ cho workspace, mở workspace settings.json thay thế.
Bước 3 — dán cấu hình env
Phần tiêu đề “Bước 3 — dán cấu hình env”Thay sk-bf-your-virtual-key-here bằng key thực của bạn. Nếu settings.json
đã có các key khác, hãy hợp nhất mục claudeCode.environmentVariables —
không tạo root {} thứ hai.
{ "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" } ]}{ "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" } ]}Bước 4 — chuyển đổi model
Phần tiêu đề “Bước 4 — chuyển đổi model”Để chuyển provider, cập nhật đồng thời 4 biến sau:
| Biến môi trường | 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 |
Bước 5 — tải lại và xác minh
Phần tiêu đề “Bước 5 — tải lại và xác minh”- Lưu
settings.json. - Dùng
Developer: Reload Windownếu VS Code không nhận thay đổi. - Mở Claude Code chat:
Hello, which model are you using? - Xác nhận không có lỗi xác thực.
Tham khảo nhanh
Phần tiêu đề “Tham khảo nhanh”| Cài đặt | Giá trị |
|---|---|
| Base URL | http://127.0.0.1:3817/anthropic |
| Trường token | ANTHROPIC_AUTH_TOKEN |
| Trường model | ANTHROPIC_MODEL |
| Định dạng token | sk-bf-xxx |
Xử lý sự cố
Phần tiêu đề “Xử lý sự cố”| Vấn đề | Giải pháp |
|---|---|
| Lỗi xác thực | ANTHROPIC_AUTH_TOKEN là Bifrost virtual key; ANTHROPIC_BASE_URL là http://127.0.0.1:3817/anthropic |
Kết nối bị từ chối trên 127.0.0.1:3817 | sotatek-proxy không chạy. Chạy sotatek-proxy status && sotatek-proxy start. |
| Model không tìm thấy | Xác minh chuỗi ANTHROPIC_MODEL chính xác với tiền tố provider và chữ hoa/thường |
| VS Code bỏ qua giá trị mới | Lưu settings.json và chạy Developer: Reload Window |
settings.json bị lỗi | Kiểm tra JSON — kiểm tra dấu phẩy và dấu ngoặc |