CCS Config

CCS cho phép bạn tạo các profile được đặt tên và chuyển đổi giữa chúng bằng một lệnh duy nhất — không cần chỉnh sửa biến môi trường thủ công.

Profile	Provider	Models
`fridayaix`	FridayAIX	Claude Opus 4.6, Sonnet 4.6, Haiku 4.5
`minimax`	MiniMax	MiniMax M2.7, M2.5, M2.5-highspeed

Yêu cầu trước

Node.js 16+
Claude Code CLI đã cài đặt
sotatek-proxy đã cài đặt và đang chạy tại 127.0.0.1:3817
Một Bifrost virtual key (sk-bf-xxx) — liên hệ admin của bạn

Bước 1 — cài đặt CCS

npm install -g @kaitranntt/ccs
ccs --version

Bước 2 — thiết lập ban đầu

ccs config

Tạo ra ~/.ccs/.

Bước 3 — viết cài đặt profile

cat > ~/.ccs/fridayaix.settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-bf-your-virtual-key-here",
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3817/anthropic",
    "ANTHROPIC_MODEL": "fridayaix/claude-opus-4-7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "fridayaix/claude-opus-4-6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "fridayaix/claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "fridayaix/claude-haiku-4-5-20251001"
  }
}
EOF

Set-Content -Path "$env:USERPROFILE\.ccs\fridayaix.settings.json" -Value @'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-bf-your-virtual-key-here",
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3817/anthropic",
    "ANTHROPIC_MODEL": "fridayaix/claude-opus-4-7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "fridayaix/claude-opus-4-6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "fridayaix/claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "fridayaix/claude-haiku-4-5-20251001"
  }
}
'@

Profile B — MiniMax

macOS / Linux
Windows (PowerShell)

cat > ~/.ccs/minimax.settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-bf-your-virtual-key-here",
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3817/anthropic",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax/MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax/MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax/MiniMax-M2.5-highspeed"
  }
}
EOF

Set-Content -Path "$env:USERPROFILE\.ccs\minimax.settings.json" -Value @'
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-bf-your-virtual-key-here",
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:3817/anthropic",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax/MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax/MiniMax-M2.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax/MiniMax-M2.5-highspeed"
  }
}
'@

Bước 4 — đăng ký profile

~/.ccs/config.yaml (Windows: %USERPROFILE%\.ccs\config.yaml):

macOS / Linux
Windows (PowerShell)

profiles:
  fridayaix:
    type: api
    settings: '~/.ccs/fridayaix.settings.json'

  minimax:
    type: api
    settings: '~/.ccs/minimax.settings.json'

profiles:
  fridayaix:
    type: api
    settings: '%USERPROFILE%/.ccs/fridayaix.settings.json'

  minimax:
    type: api
    settings: '%USERPROFILE%/.ccs/minimax.settings.json'

Nếu config.yaml đã có phần profiles:, hãy hợp nhất các mục mới — không được tạo key profiles: thứ hai.

Bước 5 — chuyển đổi profile

ccs fridayaix                              # FridayAIX Claude models
ccs minimax                                # MiniMax models
ccs fridayaix "Explain this codebase"      # pass a prompt directly

Bước 6 — xác minh

ccs fridayaix "Hello, which model are you? Reply in 1 sentence."

Claude phản hồi và xác nhận đúng model (ví dụ claude-opus-4-6).

Cấu trúc file

~/.ccs/
├── config.yaml                  # main CCS config (profiles registered here)
├── fridayaix.settings.json      # profile A: FridayAIX env vars
└── minimax.settings.json        # profile B: MiniMax env vars

Tham khảo nhanh

Tác vụ	Lệnh
Cài đặt CCS	`npm install -g @kaitranntt/ccs`
Thiết lập ban đầu	`ccs config`
Dùng FridayAIX	`ccs fridayaix`
Dùng MiniMax	`ccs minimax`
Dùng với prompt	`ccs fridayaix "your prompt"`

Xử lý sự cố

Vấn đề	Giải pháp
`ccs: command not found`	Khởi động lại terminal sau khi cài đặt, hoặc `source ~/.zshrc`
Profile không được nhận dạng	Xác nhận `config.yaml` có profile trong `profiles:` với đường dẫn `settings` đúng
Xác thực thất bại	Xác minh `ANTHROPIC_AUTH_TOKEN` là Bifrost virtual key hợp lệ
Kết nối bị từ chối trên `127.0.0.1:3817`	sotatek-proxy không chạy — `sotatek-proxy status && sotatek-proxy start`
Model không tìm thấy	Tên model phải có tiền tố provider (ví dụ `fridayaix/claude-opus-4-6`)
Windows env value crash	Tất cả giá trị env trong `.settings.json` phải là chuỗi

Ghi chú

Thay sk-bf-your-virtual-key-here bằng key thực của bạn trong tất cả các file settings.
Các profile được cô lập — chuyển đổi không ảnh hưởng đến các phiên đang chạy khác.
CCS là mã nguồn mở (MIT): https://github.com/kaitranntt/ccs