Tích hợp CC Switch
Độ khó 🧩 Trung bình | Định dạng API Claude | base_url
https://byesu.com
https://byesu.comclaude-opus-4-8CC Switch là một công cụ quản lý AI CLI hợp nhất, mã nguồn mở và đa nền tảng, cho phép bạn chuyển đổi nhanh giữa các nhà cung cấp API khác nhau trong Claude Code, Codex, Gemini CLI chỉ bằng một cú nhấp, mà không cần phải sửa biến môi trường hay tệp cấu hình thủ công. Sau khi tích hợp Byesu API vào, bạn có thể chuyển sang kênh của byesu bất cứ lúc nào ngay bên trong công cụ này.
Trước khi bắt đầu
Hãy vào Bảng điều khiển → Token để tạo một token mới (dạng sk-xxxx), và chọn đúng nhóm cho token——nhóm quyết định bạn có thể gọi những mô hình nào và đi qua tuyến đường nào. Nếu chưa rõ cách chọn, xem Chọn nhóm.
CC Switch quản lý các CLI như Claude Code, do đó Claude Code sử dụng định dạng API Anthropic, base_url dùng https://byesu.com (không kèm /v1).
Bước 1: Cài đặt CC Switch
Tải chính thức: GitHub Releases (bộ cài cho Windows / macOS / Linux) · trang chủ ccswitch.io
Chọn cách cài đặt theo hệ điều hành của bạn:
brew tap farion1231/ccswitch
brew install --cask cc-switch到 GitHub Releases 下载 MSI 安装包，或下载 portable ZIP 解压即用。# Tải gói DEB / AppImage / RPM từ GitHub Releases
# ArchLinux cài qua AUR:
paru -S cc-switch-binSau khi cài đặt xong, hãy mở CC Switch và chuyển sang nhóm Claude (Claude Code) ở góc trên bên trái.
Bước 2: Thêm nhà cung cấp byesu
Cách 1: Nhập một cú nhấp (nhanh nhất)
Nếu bạn đang thao tác trong Bảng điều khiển Byesu, bạn có thể dùng trực tiếp deep link ccswitch:// để nhập, khỏi phải điền tay:
- Vào Bảng điều khiển → Token, trong menu thả xuống của token mục tiêu, chọn CC Switch.
- Trong hộp cấu hình hiện ra:
- Loại ứng dụng: chọn Claude
- Tên cấu hình: đặt tùy ý, ví dụ
byesu - Mô hình chính (bắt buộc): chọn
claude-opus-4-8 - Mô hình Opus:
claude-opus-4-8 - Mô hình Sonnet / Mô hình Haiku: tùy chọn, chọn các mô hình khả dụng khác theo nhu cầu
- Nhấn Mở CC Switch, cấu hình sẽ được nhập tự động.
Xác nhận base_url và token
Nhập một cú nhấp sẽ tự động kèm theo địa chỉ API của byesu và key của token này. Sau khi nhập, hãy vào phần chi tiết nhà cung cấp để kiểm tra base_url là https://byesu.com (định dạng Anthropic, không kèm /v1).
Cách 2: Thêm thủ công
Trong nhóm Claude của CC Switch, nhấn "Thêm nhà cung cấp", rồi điền theo bảng dưới đây:
| Trường | Nội dung điền |
|---|---|
| Tên (Name) | byesu (tùy chỉnh) |
Địa chỉ API / Base URL (tương ứng ANTHROPIC_BASE_URL) | https://byesu.com |
API Key / Auth Token (tương ứng ANTHROPIC_AUTH_TOKEN) | sk-xxxx (token byesu của bạn) |
| Mô hình chính / Opus | claude-opus-4-8 |
| Sonnet | claude-opus-4-8 (hoặc mô hình khả dụng khác) |
| Haiku | Có thể để mặc định hoặc chọn mô hình nhẹ |
Tên mô hình phải dùng tên thực sự khả dụng trên byesu
Ví dụ claude-opus-4-8. Cả ba bậc Opus/Sonnet/Haiku của Claude Code đều có thể trỏ tới cùng một mô hình hoặc các mô hình khác nhau trên byesu, chỉ cần đảm bảo nhóm sở hữu token của bạn hỗ trợ mô hình đó là được.
Sau khi lưu, hãy nhấp vào mục byesu này trong danh sách nhà cung cấp, CC Switch sẽ ghi nó vào cấu hình của Claude Code (biến môi trường ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN).
Bước 3: Kiểm tra xem đã có hiệu lực chưa
- Trong CC Switch, chuyển nhà cung cấp hiện tại sang
byesu. - Mở một terminal mới, chạy Claude Code:
claude- Hỏi thử một câu bất kỳ, ví dụ "Xin chào, cho biết bạn đang dùng mô hình nào". Nếu trả lời bình thường và không báo lỗi xác thực, nghĩa là đã kết nối được với byesu.
Nếu trước đó Claude Code đang mở, sau khi chuyển nhà cung cấp hãy khởi động lại terminal rồi mới chạy, để các biến môi trường mới có hiệu lực.
Bị kẹt?
- Báo lỗi 401 / xác thực thất bại: token điền sai hoặc có khoảng trắng thừa; hãy xác nhận key có dạng
sk-xxxx. Xem Lỗi thường gặp #auth. - Báo không có kênh khả dụng / no channel: nhóm của token hiện tại không có mô hình này. Hãy đổi sang nhóm khác có hỗ trợ mô hình đó, hoặc dùng mô hình nằm trong nhóm. Xem Chọn nhóm và Lỗi thường gặp #no-channel.
- Không đủ hạn mức / balance: hạn mức token hoặc số dư tài khoản không đủ. Xem Lỗi thường gặp #balance.
- Đã chuyển nhà cung cấp nhưng không có hiệu lực: biến môi trường không tự làm mới trong terminal đang mở, hãy khởi động lại terminal rồi thử lại.
Xem thêm cách khắc phục tại Lỗi thường gặp.