Hướng dẫn cấu hình CC Switch với BazaarLink
CC Switch cho phép lưu và chuyển provider configuration cho coding tools. Hướng dẫn này bao phủ hai đường BazaarLink cần dùng: Claude Code và Codex.
Trước khi bắt đầu
Tạo BazaarLink API key và giữ ở local. Khi muốn đổi ví dụ bên dưới, dùng live model catalog. Base URL trong các trường CC Switch giống nhau cho cả hai đường.
Base URL: https://api.bazaarlink.ai
Model catalog: https://bazaarlink.ai/api/v1/models1. Thêm BazaarLink cho Claude Code
Trong CC Switch, chọn Claude Code, bấm +, chọn App-specific Provider và chọn Custom nếu preset không có BazaarLink. Dán JSON bên dưới, thay key placeholder ở local rồi lưu.
Các trường Claude Code
Bật provider
Bấm Enable trên thẻ BazaarLink provider đã lưu. Tài liệu CC Switch cho biết Claude Code có hiệu lực ngay sau khi chuyển, không cần restart terminal. Deep-link importer ghi URL key vào ANTHROPIC_AUTH_TOKEN, còn cấu hình Custom thủ công dùng ANTHROPIC_API_KEY.
2. Thêm BazaarLink cho Codex
Trong CC Switch, chọn Codex, bấm +, chọn App-specific Provider rồi Custom. Codex lưu key trong auth.json và model/provider settings trong config.toml, nên nhập hai block riêng.
~/.codex/auth.json
{
"OPENAI_API_KEY": "YOUR_BAZAARLINK_API_KEY"
}~/.codex/config.toml
Bật và restart terminal
Bấm Enable trên thẻ provider đã lưu. Tài liệu CC Switch cho biết Codex cần restart terminal sau khi chuyển: đóng cửa sổ hiện tại và mở cửa sổ mới trước khi chạy Codex.
3. Dùng model ID hiện tại
Model catalog là nguồn chuẩn. Fetch trước khi đổi model, sau đó sao chép chính xác ID đầy đủ vào ANTHROPIC_MODEL, các Claude role fields hoặc model trong config.toml.
curl -sS https://bazaarlink.ai/api/v1/models | jq -r '.data[].id'Các ví dụ đã xác minh ở trên
claude-sonnet-4.6
claude-haiku-4.5
claude-opus-4.6
gpt-5.3-codex4. Import một lần bấm
Provider importer đã xác minh của CC Switch nhận link ccswitch://v1/import?resource=provider. Thay key placeholder ở local trước khi mở link và không bao giờ công khai hoặc chia sẻ link đã điền vì apiKey value là một phần của URL.
Claude Code
ccswitch://v1/import?resource=provider&app=claude&name=BazaarLink&homepage=https%3A%2F%2Fbazaarlink.ai&endpoint=https%3A%2F%2Fapi.bazaarlink.ai&apiKey=YOUR_BAZAARLINK_API_KEY&model=claude-sonnet-4.6Codex
ccswitch://v1/import?resource=provider&app=codex&name=BazaarLink&homepage=https%3A%2F%2Fbazaarlink.ai&endpoint=https%3A%2F%2Fapi.bazaarlink.ai&apiKey=YOUR_BAZAARLINK_API_KEY&model=gpt-5.3-codexMở link trên thiết bị đã cài CC Switch, xem import confirmation và xác nhận. Sau đó dùng Enable trong CC Switch; khi import Codex provider, làm theo bước terminal-restart ở trên.
5. Xử lý sự cố
Lỗi xác thực
Thay YOUR_BAZAARLINK_API_KEY bằng key trên máy của bạn. Không đưa key thật vào guide, repository, screenshot hoặc deep link được chia sẻ.
Model bị từ chối
Fetch https://bazaarlink.ai/api/v1/models và sao chép ID chính xác, gồm cả dấu câu. Model name không có trong response hiện tại không phải ví dụ hợp lệ.
Codex vẫn dùng provider cũ
Sau khi bật provider, đóng terminal hiện tại và mở terminal mới. Tài liệu CC Switch yêu cầu restart terminal cho Codex switch.