CCS Config

CCS lets you create named profiles and switch between them with a single command — no manual env-var editing.

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

Prerequisites

1. Node.js 16+
2. Claude Code CLI installed
3. sotatek-proxy installed and running on 127.0.0.1:3817
4. A Bifrost virtual key (sk-bf-xxx) — contact your admin

---

Step 1 — install CCS

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

Step 2 — initial setup

ccs config

Creates ~/.ccs/.

Step 3 — write profile settings

Profile A — FridayAIX (Claude)

macOS / Linux

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

Windows (PowerShell)

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

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

Windows (PowerShell)

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"
  }
}
'@

Step 4 — register profiles

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

macOS / Linux

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

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

Windows (PowerShell)

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

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

If config.yaml already has a profiles: section, merge new entries — don’t duplicate the profiles: key.

Step 5 — switch profiles

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

Step 6 — verify

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

Claude responds and identifies the correct model (e.g. claude-opus-4-6).

File layout

~/.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

Quick reference

Task	Command
Install CCS	npm install -g @kaitranntt/ccs
Initial setup	ccs config
Use FridayAIX	ccs fridayaix
Use MiniMax	ccs minimax
Use with prompt	ccs fridayaix "your prompt"

Troubleshooting

Issue	Solution
ccs: command not found	Restart terminal after install, or source ~/.zshrc
Profile not recognized	Confirm config.yaml has the profile under profiles: with correct settings path
Authentication failed	Verify ANTHROPIC_AUTH_TOKEN is a valid Bifrost virtual key
Connection refused on 127.0.0.1:3817	sotatek-proxy is not running — sotatek-proxy status && sotatek-proxy start
Model not found	Model names must include provider prefix (e.g. fridayaix/claude-opus-4-6)
Windows env value crash	All env values in .settings.json must be strings

Notes

• Replace sk-bf-your-virtual-key-here with your real key in all settings files.
• Profiles are isolated — switching does not affect other running sessions.
• CCS is open source (MIT): https://github.com/kaitranntt/ccs