SCOOPY / HƯỚNG DẪN API
Đối tác 2 · Hướng dẫn cấu hình API
Lấy key, chọn công cụ và cấu hình theo từng bước. Bạn không cần nhập API key vào trang hướng dẫn này.
Mở portal Đối tác 2 ↗https://lzlz.eu.org/v1https://lzlz.eu.orgapi/sonnet-5.501 / CHUẨN BỊ
Lấy API key và chọn model
- Mua mã trong mục API Claude của bot Scoopy, mở portal và dán mã để kích hoạt.
- Sao chép API key vừa nhận. Mã kích hoạt không phải API key; công cụ cần key sau khi kích hoạt.
- Kiểm tra thời hạn, token còn lại và model được phép dùng trên portal.
Chọn model để cập nhật các đoạn cấu hình bên dưới. Nếu tên trên portal khác ví dụ, dùng đúng tên portal cấp cho key.
https://lzlz.eu.org/v1https://lzlz.eu.orgLink shop /scoopyvn dùng để mở portal. Không ghép đường dẫn này vào Base URL gọi API.
Chọn đúng giao thức theo ứng dụng: Cline/Continue dùng Chat Completions; Claude Code dùng Messages. Codex cần Responses API và hiện chưa kết nối trực tiếp được với endpoint này.
02 / TERMINAL & VS CODE
Claude Code
- Cài Claude Code theo hướng dẫn chính thức ↗. Trên Windows, làm theo phần yêu cầu Git Bash của bộ cài nếu được nhắc.
- Mở terminal, dán cấu hình phù hợp hệ điều hành; thay
YOUR_API_KEYbằng key của bạn. - Chạy
claude, gõ/statusđể kiểm tra Base URL và nguồn xác thực, sau đó gửiChỉ trả lời OK.
Windows · PowerShell
$env:ANTHROPIC_BASE_URL = "https://lzlz.eu.org"
$env:ANTHROPIC_AUTH_TOKEN = "YOUR_API_KEY"
$env:ANTHROPIC_MODEL = "api/sonnet-5.5"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "api/sonnet-5.5"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "api/opus-5.5"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "api/sonnet-4.6"
claudemacOS / Linux · Bash hoặc Zsh
export ANTHROPIC_BASE_URL="https://lzlz.eu.org"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="api/sonnet-5.5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="api/sonnet-5.5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="api/opus-5.5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="api/sonnet-4.6"
claudeExtension 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.
{
"claudeCode.environmentVariables": [
{
"name": "ANTHROPIC_BASE_URL",
"value": "https://lzlz.eu.org"
},
{
"name": "ANTHROPIC_AUTH_TOKEN",
"value": "YOUR_API_KEY"
},
{
"name": "ANTHROPIC_MODEL",
"value": "api/sonnet-5.5"
},
{
"name": "ANTHROPIC_DEFAULT_SONNET_MODEL",
"value": "api/sonnet-5.5"
},
{
"name": "ANTHROPIC_DEFAULT_OPUS_MODEL",
"value": "api/opus-5.5"
},
{
"name": "ANTHROPIC_DEFAULT_HAIKU_MODEL",
"value": "api/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 ↗
03 / VS CODE
Cline
- Trong VS Code, mở Extensions (
Ctrl+Shift+X), tìm và cài Cline từ nhà phát hành chính thức. - Mở Cline → Settings (bánh răng) → phần cấu hình API. Chọn OpenAI Compatible.
- Điền các trường bên dưới, lưu và tạo một task mới để thử tin ngắn.
- Base URL
https://lzlz.eu.org/v1- API Key
- API key nhận trên portal
- Model ID
api/sonnet-5.5
Nếu Cline có cấu hình riêng cho Plan và Act, điền đúng key, Base URL và model ở cả hai chế độ. Không chọn OpenAI chính thức cho key Scoopy. Khả năng Agent/tool calling phụ thuộc model và gateway; kiểm tra bằng task nhỏ trước.
04 / VS CODE
Continue
- Cài extension Continue, mở sidebar và mục cấu hình local để mở
~/.continue/config.yaml(Windows:%USERPROFILE%\.continue\config.yaml). - Thêm cấu hình model bên dưới hoặc gộp mục model vào file hiện có; không tạo hai khóa
models:trùng nhau. - Tạo/mở
~/.continue/.envvà thêmSCOOPY_API_KEY=YOUR_API_KEY. Thay giá trị mẫu bằng key thật trên máy của bạn. - Lưu, tải lại cấu hình Continue, chọn Scoopy Coding và thử Chat trước.
name: Scoopy API
version: 1.0.0
schema: v1
models:
- name: Scoopy Coding
provider: openai
model: api/sonnet-5.5
apiBase: https://lzlz.eu.org/v1
apiKey: ${{ secrets.SCOOPY_API_KEY }}
roles:
- chat
- edit
- applySCOOPY_API_KEY=YOUR_API_KEYVS Code extension không tự nhận biến môi trường bạn vừa đặt trong terminal. Dùng file .continue/.env ở thư mục người dùng như trên. Mẫu dành cho Chat/Edit/Apply; không tự cấu hình embedding hoặc autocomplete bằng key gói Claude này.
Cấu hình OpenAI-compatible ↗ · config.yaml ↗ · Biến bí mật ↗
05 / TƯƠNG THÍCH
Codex CLI và extension Codex
Codex yêu cầu OpenAI Responses API. Kiểm tra ngày 27/10/2026 tại https://lzlz.eu.org/v1/responses nhận HTTP 404. Đổi Base URL hoặc đặt wire_api = "chat" không khắc phục được. Có model Claude trong gói không đồng nghĩa dùng được trong Codex.
Bạn có thể dùng Cline/Continue ngay theo chuẩn Chat Completions, hoặc đợi gateway hỗ trợ Responses. Khi nguồn xác nhận đã hỗ trợ, dùng cấu hình tham khảo bên dưới.
Cấu hình Codex khi gateway đã có Responses API
Cài Codex theo tài liệu chính thức. Gộp cấu hình vào ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml), không ghi đè các cài đặt khác.
# Chỉ dùng khi gateway đã hỗ trợ /v1/responses
model = "api/sonnet-5.5"
model_provider = "scoopy"
[model_providers.scoopy]
name = "Scoopy API"
base_url = "https://lzlz.eu.org/v1"
env_key = "SCOOPY_API_KEY"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false$env:SCOOPY_API_KEY = "YOUR_API_KEY"
codexexport SCOOPY_API_KEY="YOUR_API_KEY"
codexNếu dùng extension, mở VS Code từ terminal đã đặt biến bằng code . sau khi đóng các cửa sổ cũ, để extension nhận biến. Không dùng model provider ID openai để ghi đè provider tích hợp; mẫu dùng scoopy.
06 / KIỂM TRA NHANH
Nếu kết nối chưa thành công
- 401
- Kiểm tra API key, khoảng trắng và đúng loại key sau kích hoạt. Với Claude Code, kiểm tra nguồn xác thực trong
/status. - 403
- Kiểm tra model được cấp. Nếu phản hồi là trang Cloudflare/HTML thay vì JSON, thử kết nối mạng khác hoặc gửi ảnh lỗi cho hỗ trợ.
- 404
- Kiểm tra Base URL và giao thức. Claude Code dùng host gốc; Cline/Continue dùng
/v1. Riêng Codex cần endpoint Responses được hỗ trợ. - 429
- Giảm số tác vụ đồng thời, đợi theo thời gian máy chủ yêu cầu rồi thử lại.
- 402 / hết token
- Mở portal kiểm tra hạn mức, thời hạn và mua mã cộng dồn nếu cần.
- Model not found
- Dùng ID model đầy đủ từ portal, ví dụ
api/sonnet-5.5; tên hiển thị trong bảng không phải lúc nào cũng là ID gọi API.
Token gói là hạn mức quy đổi, dùng chung giữa các model. Công thức hiện tại: (token vào + token ra × 5) × hệ số model. Thời hạn tính từ kích hoạt; gói dừng khi hết token hoặc hết hạn.
Cần hỗ trợ: gửi mã đơn, tên công cụ/model và ảnh lỗi đã che key tới @scoopyvn_support.