Chuyển đến nội dung chính
CC Switch là công cụ quản lý cấu hình AI CLI đa nền tảng. Bạn có thể dùng nó để quản lý Provider cho Claude Code, Codex, Gemini CLI, OpenCode và các công cụ tương tự. Sau khi nhập 4096bytes vào CC Switch, Base URL, API Key và tên mô hình sẽ được lưu trong cấu hình cục bộ. Sau đó bạn có thể chuyển đổi giữa nhiều CLI hoặc Provider mà không phải sửa biến môi trường và tệp cấu hình nhiều lần.
Nhập một lần sẽ ghi API Key hiện tại vào cấu hình CC Switch trên máy. Chỉ thực hiện trên máy tính của bạn. Không nhập key trên máy dùng chung, máy từ xa tạm thời hoặc môi trường không tin cậy.

Cài đặt

CC Switch là dự án mã nguồn mở trên GitHub: farion1231/cc-switch.
1

Mở trang Releases

Mở trang farion1231/cc-switch Releases và xem phiên bản mới nhất.
2

Tải gói phù hợp

Chọn gói theo hệ điều hành:
  • macOS: .dmg
  • Windows: .msi
  • Linux: .AppImage hoặc .deb.
3

Cài đặt và mở một lần

Hoàn tất cài đặt. Mở CC Switch ít nhất một lần để trình duyệt có thể gọi ứng dụng khi nhập cấu hình.

Nhập một lần

Nên dùng nhập một lần khi có sẵn. Cách này ghi cấu hình Provider vào CC Switch cục bộ mà không cần sao chép từng trường.
1

Xác nhận CC Switch đã cài

Đảm bảo CC Switch đã được cài và đã mở ít nhất một lần.
2

Mở API Keys

Mở bảng điều khiển và tìm API Key muốn nhập vào CC Switch trên trang API Keys.
3

Nhấn Import to CCS

Nhấn Import to CCS trong dòng key đó. Nếu hệ thống hỏi có cho phép mở CC Switch không, hãy cho phép.Nút Import to CCS
4

Xác nhận nhập

Kiểm tra thông tin Provider trong CC Switch rồi xác nhận nhập.Xác nhận nhập CC Switch
Sau khi nhập, CC Switch sẽ lưu cấu hình Provider tương ứng với API Key hiện tại. Nếu sau này bạn xóa hoặc thay key, hãy nhập lại hoặc cập nhật cấu hình thủ công.

Thêm Provider thủ công

Nếu không dùng được nhập một lần, bạn có thể thêm Provider 4096bytes thủ công trong CC Switch.
Trường CC SwitchGiá trị
Provider presetChọn cấu hình tùy chỉnh.
Provider IDDùng 4096bytes.
Provider nameDùng 4096bytes.
Official linkhttps://www.4096bytes.com
API endpointhttps://api.4096bytes.com (không bật “Full URL”)
API KeyAPI Key bạn tạo trong bảng điều khiển.
Sao chép Base URL và tên mô hình từ bảng điều khiển. Không dùng ảnh cũ, cuộc trò chuyện hoặc cấu hình của người khác.

Kiểm tra

Sau khi nhập hoặc thêm thủ công, chuyển sang Provider 4096bytes trong CC Switch rồi chạy một tác vụ rủi ro thấp. Kiểm tra mô hình trong CC Switch

Gợi ý xử lý lỗi

  • Nếu trình duyệt không gọi được CC Switch, xác nhận CC Switch đã cài và đã mở một lần.
  • Nếu nhập xong nhưng xác thực thất bại, tạo API Key mới rồi nhập lại.
  • Nếu một ứng dụng CLI không dùng Provider mới, xác nhận ứng dụng đó được CC Switch quản lý và khởi động lại terminal sau khi chuyển.