Hướng dẫn cấu hình một chạm với CC-Switch (khuyên dùng cho người mới)

Lựa chọn hàng đầu cho người mới!

CC-Switch là công cụ cấu hình một chạm được thiết kế riêng cho người mới bắt đầu từ con số 0 — không cần tự sửa tệp cấu hình, thao tác trên giao diện đồ họa, chỉ hơn chục giây là hoàn thành chuyển đổi kênh.

Các bước cấu hình

1. Tải xuống và cài đặt CC-Switch

• Windows: truy cập CC-Switch GitHub Releases để tải gói cài .msi
• macOS (Homebrew):

brew tap farion1231/ccswitch
brew install --cask cc-switch

• Linux: tải gói .deb ở trang Releases để cài

Sau khi tải về, hoàn tất cài đặt trên máy.

2. Mở phần mềm, chọn CLI cần cấu hình

Khởi động CC-Switch, trên giao diện chính chọn công cụ bạn muốn cấu hình (như Claude Code, Codex v.v.), sau đó nhấp vào "Thêm nhà cung cấp" để cấu hình.

3. Điền thông tin nhà cung cấp

• Tên nhà cung cấp: điền NextHub
• Địa chỉ yêu cầu: Claude Code điền https://api.nexthub.cc; Codex điền https://api.nexthub.cc/v1
• Định dạng API: cấu hình theo loại CLI bạn đã chọn
• API Key: điền khóa bạn đã tạo trong Bảng điều khiển

Địa chỉ yêu cầu có cần kèm /v1 không?

Claude Code dùng giao thức Anthropic, sẽ tự động nối /v1/messages vào sau địa chỉ, chỉ cần điền tên miền trần là đủ; Codex dùng giao thức OpenAI Responses (/v1/responses), địa chỉ yêu cầu cần kèm /v1.

Sau khi điền xong, nhấp vào nút "Thêm" ở góc dưới bên phải để lưu cấu hình.

4. Xác nhận kênh đã có hiệu lực

Quay lại giao diện chính, xem kênh đang sử dụng hiện tại, đảm bảo đã chuyển sang kênh NextHub bạn vừa cấu hình.

5. Bỏ qua xác nhận cài đặt lần đầu của Claude Code (tùy chọn)

Trên giao diện chính nhấp vào nút "Cài đặt", vào trang cài đặt chung, tìm "Bỏ qua xác nhận cài đặt lần đầu của Claude Code", đảm bảo mục này đang được bật.

6. Xác minh bằng cách chạy trong terminal

Mở terminal, chạy claude hoặc codex để trò chuyện đơn giản, kiểm tra cấu hình có hoạt động bình thường hay không. Nhận được phản hồi tức là cấu hình thành công 🎉

claude

Cũng cấu hình được Claude Desktop

CC-Switch có sẵn bảng Claude Desktop, hỗ trợ nhập một chạm các nhà cung cấp đã có trong Claude Code; sau khi chuyển nhớ khởi động lại hoàn toàn Claude Desktop. Xem các bước chi tiết tại hướng dẫn cấu hình Claude Desktop.

Điểm nổi bật của CC-Switch

Chuyển đổi cấu hình API một chạm, quản lý cấu hình trực quan, quản lý máy chủ MCP, thao tác nhanh từ khay hệ thống, proxy cục bộ hỗ trợ chuyển đổi nóng, tự động chuyển sang kênh dự phòng khi lỗi.