Script cài đặt 1 chạm

Không muốn chép Base URL / biến môi trường bằng tay? Tải script tương ứng, chạy tại máy — script sẽ sao lưu cấu hình hiện tại và ghi cấu hình mới trong 3 bước.

Tải về

Chọn tình huống client của bạn và tải script cho nền tảng tương ứng (.ps1 cho Windows, .sh cho macOS / Linux):

Chuẩn bị

1. Bạn đã tạo token tại Bảng điều khiển → Token (nhóm phải khớp với script — xem cột "Nhóm cần dùng" ở trên)
2. Tài khoản đủ số dư — không đủ số dư sẽ trả 402 ngay cuộc gọi đầu tiên
3. Đã cài client tương ứng (VSCode / Claude Desktop / Cursor, v.v.)

Chạy trên Windows (.ps1)

Cách A · Chuột phải để chạy (khuyến nghị)

1. Tải file .ps1 tương ứng vào thư mục bất kỳ (ví dụ thư mục Downloads)
2. Chuột phải vào file → Run with PowerShell
3. Dán token khi được hỏi (đầu vào ẩn — đó là bình thường)
4. Hoàn tất khi thấy [4/4] complete; terminal sẽ liệt kê các bước tiếp theo

Cách B · Chạy thủ công trong terminal

# Vào thư mục đã tải script
cd $env:USERPROFILE\Downloads

# Nếu hệ thống chặn script lần đầu, cho phép trong phiên này
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

# Chạy (ví dụ VSCode + Claude Code)
.\setup-vscode-claude.ps1

Chạy trên macOS / Linux (.sh)

# Vào thư mục tải về
cd ~/Downloads

# Cấp quyền chạy (tùy chọn — cũng có thể chạy trực tiếp bằng bash)
chmod +x setup-vscode-claude.sh

# Chạy
bash setup-vscode-claude.sh

Quy trình tương tự: nhập token khi được hỏi (đầu vào ẩn). Khởi động lại client tương ứng khi script hoàn tất.

Script làm những gì

1. Hỏi token — đầu vào ẩn, xử lý trong bộ nhớ và xóa sau khi dùng, không bao giờ ghi vào log
2. Sao lưu cấu hình hiện tại — sao chép mọi file sẽ chỉnh sửa kèm hậu tố ngày trong cùng thư mục (ví dụ config.json.bak.20260516)
3. Hợp nhất cấu hình mới — giữ nguyên các thiết lập khác của bạn; chỉ đổi base URL / API key / khóa model
4. Báo bước tiếp theo — liệt kê hành động cụ thể như "khởi động lại VSCode" hoặc "bật Claude Code trong Settings"

Khôi phục / gỡ cài đặt

Mỗi cấu hình đã chỉnh sửa đều có bản sao lưu .bak.<date> ngay bên cạnh — chỉ cần đổi tên trở lại để khôi phục:

# Tìm bản sao lưu
ls $env:APPDATA\Code\User\settings.json.bak.*
# Khôi phục (lấy 20260516 làm ví dụ)
mv settings.json.bak.20260516 settings.json

# Tương tự trên macOS
ls ~/Library/Application\ Support/Code/User/settings.json.bak.*
mv settings.json.bak.20260516 settings.json

Xử lý sự cố

PowerShell báo "cannot be loaded because running scripts is disabled on this system"

Chính sách thực thi của hệ thống chặn script theo mặc định. Cho phép trong phiên PowerShell hiện tại:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Lệnh này chỉ ảnh hưởng cửa sổ hiện tại và sẽ trở lại khi đóng; không thay đổi chính sách toàn hệ thống.

macOS báo "permission denied"

chmod +x setup-xxx.sh && bash setup-xxx.sh

Client trả về no available channels under group X

Nhóm của token không khớp với model bạn đã gọi. Vào Bảng điều khiển → Token, chỉnh token để đổi nhóm, hoặc tạo token mới. Lưu ý: các cuộc gọi ngay sau khi đổi vẫn có thể thấy nhóm cũ (cache Redis ở backend, sẽ hết sau vài phút) — tạo token mới để xác nhận sẽ nhanh hơn.

Client trả về 402 hoặc insufficient_quota

Số dư tài khoản hoặc hạn mức token đã hết. Nạp tiền hoặc tăng hạn mức token trong cài đặt token đó.

Client trả về 401 invalid api key

Token sai hoặc đã bị xóa. Kiểm tra trong bảng điều khiển, hoặc tạo token mới rồi chạy lại script.

Không muốn dùng script — cấu hình thủ công

Nếu bạn muốn tự sửa cấu hình bằng tay, mọi cách cài đặt thủ công đều có trong Tài liệu API → Cài đặt IDE Client, gồm biến môi trường, đường dẫn file cấu hình và các trường JSON cho mỗi client.

Mã nguồn script

Các script là văn bản thuần — mở chúng trong trình duyệt bất kỳ để đọc (trình duyệt sẽ không thực thi):

• /scripts/setup-vscode-claude.ps1
• /scripts/setup-vscode-claude.sh
• (8 file còn lại trong bảng tải ở trên)

Nếu muốn đọc trước khi chạy, mỗi script dưới 200 dòng và chỉ gọi lệnh cục bộ (đọc token / sao lưu / ghi JSON) — không gửi bất kỳ request mạng ra ngoài.