CC-Switch · Các bước chung

CC-Switch là một công cụ mã nguồn mở để quản lý cấu hình Claude Code / Codex / Gemini CLI. Nó dùng giao diện đồ họa giúp bạn quản lý cấu hình nhà cung cấp của từng CLI, chuyển đổi trong một bước, khỏi phải sửa file cấu hình thủ công.

CC-Switch là công cụ mã nguồn mở của bên thứ ba, không do Tianshu chính thức bảo trì. Trước khi cài bạn có thể tự xem kho mã nguồn mở của nó.

Nó làm được gì

• ✅ Chuyển đổi cấu hình API trong một bước — chuyển nhanh giữa nhiều nhà cung cấp
• ✅ Quản lý cấu hình trực quan — giao diện đồ họa quản lý mọi cấu hình
• ✅ Quản lý máy chủ MCP
• ✅ Thao tác nhanh trên khay hệ thống

Tải phần mềm

Vào trang GitHub Releases của CC-Switch để tải bộ cài tương ứng với hệ điều hành:

Windows

Vào GitHub Releases, chọn bộ cài .msi rồi tải về và cài đặt.
Sau khi cài xong, chạy chương trình chính CC-Switch.

macOS (Homebrew)

# Thêm nguồn tap
brew tap farion1231/ccswitch
# Cài đặt CC-Switch
brew install --cask cc-switch
# Sau khi xong, tìm và mở CC-Switch trong Launchpad / Ứng dụng

Linux (Debian/Ubuntu)

# Kiểm tra số phiên bản mới nhất trên GitHub Releases và thay tên tệp bên dưới
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_x.x.x_amd64.deb
sudo dpkg -i cc-switch_x.x.x_amd64.deb

Hoàn tất kiểm tra môi trường trước

Đừng bỏ qua

CC-Switch chỉ giúp bạn quản lý cấu hình, việc thực sự chạy mô hình vẫn phụ thuộc vào Node.js và CLI tương ứng (Claude Code / Codex). Hãy hoàn tất Kiểm tra môi trường và cài CLI trước, bảo đảm node, claude, codex đều chạy bình thường.

Thêm Tianshu làm nhà cung cấp tùy chỉnh

CC-Switch có sẵn một số mẫu nhà cung cấp, Tianshu cần bạn tự thêm vào làm nhà cung cấp tùy chỉnh:

• Tên nhà cung cấp: 天枢 / tianshu (tùy chỉnh)
• Base URL: xem hướng dẫn từng CLI (Claude Code dùng https://tian-shu.org, Codex dùng https://tian-shu.org/v1)
• API Key: token đã tạo và chọn đúng nhóm tại bảng điều khiển → Quản lý token

Bước tiếp theo

Tiếp tục theo loại CLI:

• CC-Switch · Cấu hình Claude Code
• CC-Switch · Cấu hình Codex