ccs/README.vi.md

CCS - Claude Code Switch

Một lệnh, không downtime, đúng model cho từng tác vụ

Chuyển đổi giữa Claude Sonnet 4.5 và GLM 4.6 ngay lập tức. Ngừng hitting rate limits. Bắt đầu tối ưu chi phí.

Ngôn ngữ: English | Tiếng Việt

---

🚀 Bắt Đầu Nhanh

🔑 Điều Kiện Tiên Quyết

Trước khi cài đặt CCS, hãy đảm bảo bạn đã đăng nhập vào Claude CLI với tài khoản subscription:

claude /login

Phương Pháp Cài Đặt Chính

macOS / Linux

curl -fsSL ccs.kaitran.ca/install | bash

Windows PowerShell

irm ccs.kaitran.ca/install | iex

Lần Chuyển Đổi Đầu Tiên

# Dùng Claude subscription (mặc định)
ccs "Review thiết kế kiến trúc này"

# Chuyển sang GLM cho tác vụ tối ưu chi phí
ccs glm "Tạo REST API đơn giản"

# Dùng GLM cho tất cả lệnh tiếp theo cho đến khi chuyển lại
ccs glm
ccs "Debug issue này"
ccs "Viết unit tests"

Cấu Hình (Tự Tạo)

~/.ccs/config.json:

{
  "profiles": {
    "glm": "~/.ccs/glm.settings.json",
    "default": "~/.claude/settings.json"
  }
}

---

Điểm Đau Hàng Ngày Của Lập Trình Viên

Bạn có cả Claude subscription và GLM Coding Plan. Hai tình huống xảy ra hàng ngày:

1. Hết Rate Limit: Claude dừng giữa chừng project → bạn phải tự tay sửa ~/.claude/settings.json
2. Lãng Phí Chi Phí: Tác vụ đơn giản dùng Claude đắt tiền → GLM cũng làm tốt

Chuyển đổi thủ công làm gián đoạn workflow của bạn. CCS khắc phục ngay lập tức.

Tại Sao CCS Thay Vì Chuyển Đổi Thủ Công?

Tính năng	Lợi ích	Giá trị cảm xúc
Chuyển đổi tức thì	Một lệnh, không sửa file	Tự tin, kiểm soát
Không downtime	Không bao giờ gián đoạn workflow	Đáng tin cậy, nhất quán
Delegation thông minh	Đúng model cho từng tác vụ tự động	Đơn giản, dễ dàng
Kiểm soát chi phí	Dùng model đắt tiền chỉ khi cần	Hiệu quả, tiết kiệm
Đa nền tảng	Hoạt động trên macOS, Linux, Windows	Linh hoạt, di động
Đáng tin cậy	Bash/PowerShell thuần, không dependencies	Tin tưởng, an tâm

Giải pháp:

ccs           # Dùng Claude subscription (mặc định)
ccs glm       # Chuyển sang GLM fallback
# Hết rate limit? Chuyển ngay:
ccs glm       # Tiếp tục làm việc với GLM

Một lệnh. Không downtime. Không phải sửa file. Đúng model, đúng việc.

---

🏗️ Tổng Quan Kiến Trúc

graph LR
    subgraph "Lệnh Người Dùng"
        CMD[ccs glm]
    end

    subgraph "Xử Lý CCS"
        CONFIG[Đọc ~/.ccs/config.json]
        LOOKUP[Tìm profile → file settings]
        VALIDATE[Kiểm tra file tồn tại]
    end

    subgraph "Claude CLI"
        EXEC[claude --settings file_path]
    end

    subgraph "Phản Hồi API"
        API[Claude hoặc GLM API]
    end

    CMD --> CONFIG
    CONFIG --> LOOKUP
    LOOKUP --> VALIDATE
    VALIDATE --> EXEC
    EXEC --> API

---

⚡ Tính Năng

Chuyển Profile Ngay Lập Tức

• Một Lệnh: ccs glm để chuyển sang GLM, ccs để dùng Claude subscription - không cần sửa file config
• Phát Hiện Thông Minh: Tự động dùng đúng model cho từng tác vụ
• Liên Tục: Chuyển đổi hoạt động cho đến khi thay đổi lại

Không Gián Đoạn Workflow

• Không Downtime: Chuyển đổi xảy ra ngay lập tức giữa các lệnh
• Bảo Toàn Context: Workflow của bạn không bị gián đoạn
• Tích Hợp Liền Mạch: Hoạt động chính xác như Claude CLI native

Delegation Tác Vụ

🚧 Đang phát triển: Tính năng này đang trong giai đoạn thử nghiệm và chưa được kiểm tra đầy đủ. Sử dụng với cẩn thận.

CCS bao gồm delegation tác vụ thông minh qua meta-command /ccs:

Cài đặt lệnh CCS:

ccs --install    # Cài đặt lệnh /ccs vào Claude CLI

Sử dụng delegation tác vụ:

# Sau khi chạy ccs --install, bạn có thể dùng:
/ccs glm /plan "add user authentication"
/ccs glm /code "implement auth endpoints"
/ccs glm /ask "explain this error"

Gỡ bỏ khi không cần:

ccs --uninstall  # Gỡ bỏ lệnh /ccs khỏi Claude CLI

Lợi ích:

• ✅ Tiết kiệm tokens bằng cách delegation tác vụ đơn giản cho model rẻ hơn
• ✅ Dùng đúng model cho từng tác vụ tự động
• ✅ Tích hợp liền mạch với workflows hiện có
• ✅ Cài đặt và gỡ bỏ sạch sẽ khi cần

---

💻 Ví Dụ Sử Dụng

ccs              # Dùng Claude subscription (mặc định)
ccs glm          # Dùng GLM fallback
ccs --version    # Hiển thị phiên bản CCS và vị trí cài đặt
ccs --install    # Cài đặt lệnh và kỹ năng CCS vào ~/.claude/
ccs --uninstall  # Gỡ bỏ lệnh và kỹ năng CCS khỏi ~/.claude/

---

🗑️ Gỡ Cài Đặt

macOS / Linux:

curl -fsSL ccs.kaitran.ca/uninstall | bash

Windows PowerShell:

irm ccs.kaitran.ca/uninstall | iex

---

🎯 Triết Lý

• YAGNI: Không có tính năng "phòng hờ"
• KISS: Bash đơn giản, không phức tạp
• DRY: Một nguồn chân lý duy nhất (config)

---

📖 Tài Liệu

Tài liệu đầy đủ trong docs/:

• Hướng dẫn Cài đặt
• Cấu hình
• Ví dụ Sử dụng
• Khắc phục Sự cố
• Đóng góp

---

🤝 Đóng Góp

Chúng tôi chào mừng đóng góp! Xem Hướng dẫn Đóng góp để biết chi tiết.

---

📄 Giấy Phép

CCS được cấp phép theo Giấy phép MIT.

---

Được tạo với ❤️ cho những lập trình viên hay hết rate limit

⭐ Star repo này | 🐛 Báo cáo vấn đề | 📖 Đọc tài liệu