SCOOPY / ĐỐI TÁC 2

Kích hoạt mã. Kết nối công cụ.

Hướng dẫn riêng cho mã Đối tác 2 nguồn mới. Mã fulldichvu cũ tiếp tục dùng portal và hướng dẫn cũ; không nhập sang đây.

Mở portal Scoopy · Đối tác 2 nguồn mới ↗
CLAUDE CODE / ANTHROPIC · không thêm /v1
https://workesim.com
CLINE / CONTINUE · OpenAI Compatible
https://workesim.com/v1
MODEL ID · giữ nguyên dấu / và -
api/claude-sonnet-4-6

01 / NHẬN KEY

Phân biệt mã kích hoạt và API key

  1. Nhận mã trong tin giao hàng/file TXT của bot. Lưu mã đơn để được hỗ trợ.
  2. Mở portal Scoopy, chọn kích hoạt và dán mã mới. Nếu đang có key Đối tác 2 nguồn mới, dùng mục cộng dồn vào key đó; không đưa key của đối tác khác vào.
  3. Sao chép API key được cấp (tiền tố sk-scoopy-) và lưu riêng trên máy. Mã dạng XXXXX-XXXXX-XXXXX-XXXXX-XXXXX không phải API key.
  4. Kiểm tra đúng gói, quota và giờ hết hạn trước khi dùng. Thời hạn 7 ngày bắt đầu từ lúc kích hoạt. Gói dừng khi hết quota hoặc hết hạn; token dư không được chuyển qua hạn tự động.
Giữ key và mã như mật khẩu.

Portal dùng key để xem số dư, lịch sử và hạn dùng. Không chụp key/mã đầy đủ lên nhóm công khai. Cộng dồn mã mới sẽ thêm quota và ngày dùng theo quy tắc nguồn; hãy kiểm tra hạn mới trên portal.

02 / ĐỌC TRƯỚC KHI CHẠY AGENT

10M / 30M là quota quy đổi

Quota trừ = (token vào + token ra × 5) × hệ số model.

Tại ngày 31/10/2026, bốn model bên dưới đều có hệ số ×6: một lượt dùng 10.000 token vào + 2.000 token ra trừ 120.000 quota. Các hệ số được nguồn chốt khi kích hoạt; xem thông tin trên key nếu nguồn đổi cấu hình. Không cộng hạn mức của từng model thành quota riêng.

Đây là tên/model ID gateway công bố, không phải cam kết chất lượng tương đương API chính hãng. Chỉ gọi model key được cấp; danh sách trong portal là thông tin cập nhật nhất.

03 / TERMINAL & VS CODE

Claude Code

  1. Cài Claude Code theo tài liệu chính thức.
  2. Chọn model ở trên, thay YOUR_API_KEY bằng key sau kích hoạt ngay trên máy bạn.
  3. Chạy cấu hình theo terminal, mở claude và kiểm tra /status. Thử một yêu cầu ngắn trước khi giao việc dài.
Windows · PowerShell
PowerShell
$env:ANTHROPIC_BASE_URL = "https://workesim.com"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
$env:ANTHROPIC_MODEL = "api/claude-sonnet-4-6"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "api/claude-sonnet-4-6"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "api/claude-opus-5-5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "api/claude-sonnet-4-6"
claude
macOS / Linux
Bash / Zsh
export ANTHROPIC_BASE_URL="https://workesim.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="api/claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_SONNET_MODEL="api/claude-sonnet-4-6"
export ANTHROPIC_DEFAULT_OPUS_MODEL="api/claude-opus-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="api/claude-sonnet-4-6"
claude

Extension Claude Code trong VS Code

Mở Command Palette → Preferences: Open User Settings (JSON). Gộp mục dưới đây vào settings người dùng của IDE, giữ các cài đặt khác và thay key trên thiết bị. Sau đó chạy Developer: Reload Window và mở phiên mới.

VS Code · user settings.json
{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "https://workesim.com"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "YOUR_API_KEY"
    },
    {
      "name": "ANTHROPIC_MODEL",
      "value": "api/claude-sonnet-4-6"
    },
    {
      "name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
      "value": "api/claude-sonnet-4-6"
    },
    {
      "name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
      "value": "api/claude-opus-5-5"
    },
    {
      "name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
      "value": "api/claude-sonnet-4-6"
    },
    {
      "name": "ANTHROPIC_API_KEY",
      "value": ""
    }
  ]
}

~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json) dùng cho CLI; extension còn kiểm tra thông tin đăng nhập trước khi khởi chạy, nên dùng claudeCode.environmentVariables để cấu hình IDE rõ ràng. Không ghi key vào settings của repository dùng chung.

Tạo cấu hình và tải bộ chạy nhanh tại Scoopy Setup ↗ · Tài liệu gateway chính thức ↗

Nếu dùng nhiều nguồn, giữ cấu hình từng nguồn riêng; không trộn Base URL Đối tác 2 nguồn mới với key nguồn khác. Tài liệu gateway của Claude Code ↗

04 / VS CODE

Cline

  1. Cài Cline rồi mở Settings → API Provider → OpenAI Compatible.
  2. Base URL: https://workesim.com/v1.
  3. API key: key được cấp sau kích hoạt. Model ID: api/claude-sonnet-4-6. Bật streaming nếu công cụ có tùy chọn.
  4. Gửi câu hỏi thử trong Plan, kiểm tra quota trên portal rồi mới chạy Act.

Nếu chọn provider Anthropic, dùng custom Base URL https://workesim.com, không thêm /v1; khả dụng tùy model và gateway. Cline: custom Anthropic URL ↗

05 / VS CODE

Continue

Mở cấu hình YAML cá nhân của Continue và gộp model dưới đây. Không ghi đè model/cài đặt khác.

config.yaml
name: Scoopy Partner 2
version: 1.0.0
schema: v1
models:
  - name: Scoopy Claude
    provider: openai
    model: api/claude-sonnet-4-6
    apiBase: https://workesim.com/v1
    apiKey: ${{ secrets.SCOOPY_VPNFAST_KEY }}
    roles:
      - chat
      - edit
      - apply
.continue/.env · thư mục người dùng
SCOOPY_VPNFAST_KEY=YOUR_API_KEY

Lưu key trong file .continue/.env của người dùng trên máy bạn, không commit. Mẫu dùng Chat/Edit/Apply; không cấu hình embedding/autocomplete bằng gói Claude. Tài liệu config.yaml ↗

06 / KIỂM TRA & HỖ TRỢ

Khi công cụ báo lỗi

401 / key không hợp lệ
Dùng API key sau kích hoạt, bỏ khoảng trắng; không dán mã kích hoạt vào ô API key.
402 / hết hạn mức
Xem quota, thời hạn và mức giữ chỗ trên portal. Hạ max output và số tác vụ đồng thời trước khi thử lại.
403 / model bị chặn
Kiểm tra model có trong gói và key còn hiệu lực. Không tự đổi sang model ngoài gói.
404
Kiểm tra URL: OpenAI Compatible có /v1, Anthropic dùng host gốc. Sao chép đúng Model ID từ portal.
429 / 502 / 503 / timeout
Đợi và thử lại có giãn cách; giảm số tác vụ cùng lúc, rút gọn context hoặc mở hội thoại mới. Không chạy vòng lặp retry vô hạn.

Codex và công cụ khác

Chưa xác nhận hỗ trợ Responses API cho gói này. Không mặc định key Claude chạy trực tiếp trong Codex; dùng Claude Code, Cline hoặc Continue trước.

Cần hỗ trợ setup: gửi mã đơn, tên công cụ/model, thời gian và ảnh lỗi đã che key tới @scoopyvn_support. Hướng dẫn không thu thập hay lưu API key.