SHOP / 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 ↗

Chọn đối tác khác →

BASE URL · Cline / Continue
https://lzlz.eu.org/v1
BASE URL · Claude Code
https://lzlz.eu.org
MODEL · sao chép đúng ID
api/sonnet-5.5

01 / CHUẨN BỊ

Lấy API key và chọn model

  1. Mua mã trong mục API Claude của bot Shop, mở portal và dán mã để kích hoạt.
  2. 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.
  3. 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.

OpenAI-compatible · Cline / Continuehttps://lzlz.eu.org/v1
Anthropic Messages · Claude Codehttps://lzlz.eu.org

Link shop /shop 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

  1. 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.
  2. Mở terminal, dán cấu hình phù hợp hệ điều hành; thay YOUR_API_KEY bằng key của bạn.
  3. Chạy claude, gõ /status để kiểm tra Base URL và nguồn xác thực, sau đó gửi Chỉ trả lời OK.
Windows · PowerShell
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"
claude
macOS / Linux · Bash hoặc Zsh
Bash / 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"
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://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 Shop Setup ↗ · Tài liệu gateway chính thức ↗

Cấu hình gateway ↗ · Chọn model ↗

03 / VS CODE

Cline

  1. Trong VS Code, mở Extensions (Ctrl+Shift+X), tìm và cài Cline từ nhà phát hành chính thức.
  2. Mở Cline → Settings (bánh răng) → phần cấu hình API. Chọn OpenAI Compatible.
  3. Đ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 Shop. Khả năng Agent/tool calling phụ thuộc model và gateway; kiểm tra bằng task nhỏ trước.

Tài liệu Cline: OpenAI Compatible ↗

04 / VS CODE

Continue

  1. Cài extension Continue, mở sidebar và mục cấu hình local để mở ~/.continue/config.yaml (Windows: %USERPROFILE%\.continue\config.yaml).
  2. 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.
  3. Tạo/mở ~/.continue/.env và thêm SHOP_API_KEY=YOUR_API_KEY. Thay giá trị mẫu bằng key thật trên máy của bạn.
  4. Lưu, tải lại cấu hình Continue, chọn Shop Coding và thử Chat trước.
config.yaml
name: Shop API
version: 1.0.0
schema: v1
models:
  - name: Shop Coding
    provider: openai
    model: api/sonnet-5.5
    apiBase: https://lzlz.eu.org/v1
    apiKey: ${{ secrets.SHOP_API_KEY }}
    roles:
      - chat
      - edit
      - apply
.continue/.env · chỉ trên máy của bạn
SHOP_API_KEY=YOUR_API_KEY

VS 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

Chưa dùng trực tiếp với endpoint hiện tại.

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.

config.toml · cần Responses API
# Chỉ dùng khi gateway đã hỗ trợ /v1/responses
model = "api/sonnet-5.5"
model_provider = "shop"

[model_providers.shop]
name = "Shop API"
base_url = "https://lzlz.eu.org/v1"
env_key = "SHOP_API_KEY"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false
PowerShell · sau khi endpoint hỗ trợ
$env:SHOP_API_KEY = "YOUR_API_KEY"
codex
Bash / Zsh · sau khi endpoint hỗ trợ
export SHOP_API_KEY="YOUR_API_KEY"
codex

Nế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 shop.

OpenAI Docs: cấu hình Codex ↗

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 @your_support_username.