kaitranntt
25741ac515
- reduce main README from ~1070 to ~250 lines - add dashboard screenshots (analytics, api_profiles, cliproxy) - update Vietnamese and Japanese translations to match new structure - add light/dark theme analytics screenshots
CCS - Claude Code Switch
Quản lý nhiều tài khoản AI từ một dashboard.
Chạy Claude, Gemini, GLM, và nhiều hơn nữa - đồng thời, không xung đột.
Ba Trụ Cột
| Khả năng | Chức năng | Quản lý qua |
|---|---|---|
| Nhiều Tài khoản Claude | Chạy Claude công việc + cá nhân đồng thời | Dashboard |
| Nhà cung cấp OAuth | Gemini, Codex, Antigravity - không cần API key | Dashboard |
| Hồ sơ API | GLM, Kimi với API key của bạn | Dashboard |
Bắt Đầu Nhanh
1. Cài Đặt
npm install -g @kaitranntt/ccs
Trình quản lý package khác
yarn global add @kaitranntt/ccs # yarn
pnpm add -g @kaitranntt/ccs # pnpm (tiết kiệm 70% dung lượng)
bun add -g @kaitranntt/ccs # bun (nhanh hơn 30x)
2. Mở Dashboard
ccs config
# Mở http://localhost:3000
3. Cấu Hình Tài Khoản
Dashboard cung cấp giao diện quản lý trực quan cho tất cả loại tài khoản:
- Tài khoản Claude: Tạo các instance riêng biệt (công việc, cá nhân, khách hàng)
- Nhà cung cấp OAuth: Xác thực một cú nhấp cho Gemini, Codex, Antigravity
- Hồ sơ API: Cấu hình GLM, Kimi với key của bạn
- Giám sát Sức khỏe: Trạng thái thời gian thực cho tất cả profile
Analytics (Giao diện Sáng/Tối)
API Profiles & Nhà cung cấp OAuth
Nhà Cung Cấp Được Hỗ Trợ
| Nhà cung cấp | Loại xác thực | Lệnh | Phù hợp nhất cho |
|---|---|---|---|
| Claude | Subscription | ccs |
Mặc định, lập kế hoạch chiến lược |
| Gemini | OAuth | ccs gemini |
Zero-config, lặp nhanh |
| Codex | OAuth | ccs codex |
Tạo code |
| Antigravity | OAuth | ccs agy |
Routing thay thế |
| GLM | API Key | ccs glm |
Tối ưu chi phí |
| Kimi | API Key | ccs kimi |
Long-context, thinking mode |
Nhà cung cấp OAuth xác thực qua trình duyệt khi chạy lần đầu. Token được lưu cache tại
~/.ccs/cliproxy/auth/.
Sử Dụng
Lệnh Cơ Bản
ccs # Session Claude mặc định
ccs agy # Antigravity (OAuth)
ccs gemini # Gemini (OAuth)
ccs glm # GLM (API key)
Luồng Công Việc Song Song
Chạy nhiều terminal với các provider khác nhau:
# Terminal 1: Lập kế hoạch (Claude Pro)
ccs work "thiết kế hệ thống xác thực"
# Terminal 2: Thực thi (GLM - tối ưu chi phí)
ccs glm "triển khai user service theo kế hoạch"
# Terminal 3: Review (Gemini)
ccs gemini "review implementation về các lỗ hổng bảo mật"
Multi-Account Claude
Tạo các instance Claude riêng biệt cho công việc/cá nhân:
ccs auth create work
# Chạy đồng thời trong các terminal riêng
ccs work "implement feature" # Terminal 1
ccs "review code" # Terminal 2 (tài khoản cá nhân)
Bảo Trì
Kiểm Tra Sức Khỏe
ccs doctor
Xác minh: Claude CLI, file cấu hình, symlinks, permissions.
Cập Nhật
ccs update # Cập nhật lên bản mới nhất
ccs update --force # Cài đặt lại bắt buộc
ccs update --beta # Cài đặt kênh dev
Đồng Bộ Shared Items
ccs sync
Tạo lại symlinks cho commands, skills, và settings được chia sẻ.
Cấu Hình
CCS tự động tạo config khi cài đặt. Dashboard là cách được khuyến nghị để quản lý settings.
Vị trí config: ~/.ccs/config.yaml
Custom Claude CLI path
Nếu Claude CLI được cài đặt ở vị trí không chuẩn:
export CCS_CLAUDE_PATH="/path/to/claude" # Unix
$env:CCS_CLAUDE_PATH = "D:\Tools\Claude\claude.exe" # Windows
Hỗ trợ symlink Windows
Bật Developer Mode để có symlinks thực sự:
- Settings → Privacy & Security → For developers
- Bật Developer Mode
- Cài đặt lại:
npm install -g @kaitranntt/ccs
Không có Developer Mode, CCS sẽ fallback sang copy thư mục.
Tài Liệu
| Chủ đề | Liên kết |
|---|---|
| Cài đặt | docs/en/installation.md |
| Cấu hình | docs/en/configuration.md |
| Nhà cung cấp OAuth | docs/en/oauth.md |
| Multi-Account Claude | docs/en/multi-account.md |
| Delegation | docs/en/delegation.md |
| GLMT (Thử nghiệm) | docs/en/glmt.md |
| Kiến trúc | docs/system-architecture.md |
| Xử lý sự cố | docs/en/troubleshooting.md |
Gỡ Cài Đặt
npm uninstall -g @kaitranntt/ccs
Trình quản lý package khác
yarn global remove @kaitranntt/ccs
pnpm remove -g @kaitranntt/ccs
bun remove -g @kaitranntt/ccs
Triết Lý
- YAGNI: Không có tính năng "phòng hờ"
- KISS: Triển khai đơn giản, tập trung
- DRY: Một nguồn sự thật (config)
Đóng Góp
Xem CONTRIBUTING.md.
Giấy Phép
MIT License - xem LICENSE.