CCS 설정

CCS를 사용하면 명명된 프로필을 생성하고 단일 명령으로 프로필 간에 전환할 수 있습니다 — 환경 변수를 직접 편집할 필요가 없습니다.

프로필	프로바이더	모델
fridayaix	FridayAIX	Claude Opus 4.6, Sonnet 4.6, Haiku 4.5
minimax	MiniMax	MiniMax M2.7, M2.5, M2.5-highspeed

사전 요구사항

1. Node.js 16 이상
2. Claude Code CLI 설치됨
3. sotatek-proxy가 127.0.0.1:3817에 설치되어 실행 중
4. Bifrost 가상 키 (sk-bf-xxx) — 관리자에게 문의하세요

---

1단계 — CCS 설치

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

2단계 — 초기 설정

ccs config

~/.ccs/를 생성합니다.

3단계 — 프로필 설정 작성

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

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

4단계 — 프로필 등록

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

config.yaml에 이미 profiles: 섹션이 있는 경우, 새 항목을 병합하세요 — profiles: 키를 중복 생성하지 마세요.

5단계 — 프로필 전환

ccs fridayaix                              # FridayAIX Claude 모델
ccs minimax                                # MiniMax 모델
ccs fridayaix "Explain this codebase"      # 프롬프트를 직접 전달

6단계 — 확인

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

Claude가 응답하며 올바른 모델을 확인합니다 (예: claude-opus-4-6).

파일 구조

~/.ccs/
├── config.yaml                  # CCS 메인 설정 (프로필 등록)
├── fridayaix.settings.json      # 프로필 A: FridayAIX 환경 변수
└── minimax.settings.json        # 프로필 B: MiniMax 환경 변수

빠른 참조

작업	명령어
CCS 설치	npm install -g @kaitranntt/ccs
초기 설정	ccs config
FridayAIX 사용	ccs fridayaix
MiniMax 사용	ccs minimax
프롬프트와 함께 사용	ccs fridayaix "your prompt"

문제 해결

문제	해결 방법
ccs: command not found	설치 후 터미널을 재시작하거나 source ~/.zshrc 실행
프로필을 인식하지 못함	config.yaml의 profiles: 아래에 해당 프로필이 올바른 settings 경로로 등록되어 있는지 확인
인증 실패	ANTHROPIC_AUTH_TOKEN이 유효한 Bifrost 가상 키인지 확인
127.0.0.1:3817 연결 거부됨	sotatek-proxy가 실행 중이지 않습니다 — sotatek-proxy status && sotatek-proxy start 실행
모델을 찾을 수 없음	모델 이름에 프로바이더 접두사가 포함되어야 합니다 (예: fridayaix/claude-opus-4-6)
Windows 환경 변수 값 오류	.settings.json의 모든 환경 변수 값은 문자열이어야 합니다

참고 사항

• 모든 설정 파일에서 sk-bf-your-virtual-key-here를 실제 키로 교체하세요.
• 프로필은 격리되어 있습니다 — 전환해도 다른 실행 중인 세션에는 영향을 미치지 않습니다.
• CCS는 오픈소스 (MIT): https://github.com/kaitranntt/ccs