Crush

Crush의 구성은 Bash입니다 — crushrc에서 `provider add kunavo --type openai-compat --base-url "https://api.kunavo.com/v1"` 한 줄을 실행하면 Charm의 터미널 에이전트가 Claude와 GPT를 사용합니다

# A crushrc is Bash, not a settings file. Everything here is executed.
provider add kunavo \
  --type openai-compat \
  --base-url "https://api.kunavo.com/v1" \
  --api-key "${KUNAVO_API_KEY:?set KUNAVO_API_KEY}"

model add kunavo/claude-sonnet-5 \
  --name "Claude Sonnet 5" \
  --context-window 1000000 \
  --default-max-tokens 32000 \
  --price-input 1.4 \
  --price-output 7

model add kunavo/claude-haiku-4-5 \
  --name "Claude Haiku 4.5" \
  --context-window 200000 \
  --default-max-tokens 16000 \
  --price-input 0.7 \
  --price-output 3.5

model large kunavo/claude-sonnet-5
model small kunavo/claude-haiku-4-5

단계별 안내

1. /app/keys에서 키를 만들고 복사하세요. 키는 한 번만 표시됩니다. 키를 KUNAVO_API_KEY로 내보내거나, 구성 파일에서 비밀번호 관리자로부터 읽어오세요.
2. 위 블록을 ~/.config/crush/crushrc에 넣으세요. Crush는 ./.crushrc, ./crushrc, 전역 구성을 차례로 읽습니다. 따라서 프로젝트 설정으로 시스템 설정을 재정의할 수 있으며, 복제한 저장소에 설정이 포함되어 있을 수도 있습니다.
3. crush를 시작하고 ctrl+l를 눌러 모델 선택기를 여세요. 위의 model large 및 model small 줄에서 두 슬롯을 이미 고정했으므로, 선택기는 설정이 아니라 모델 전환에 사용합니다.
4. ID를 직접 등록하지 않으려면 다음과 같이 하세요. openai-compat 제공업체의 모델 목록이 비어 있을 때 또는 --discover-models true를 전달하면 자동 검색이 실행됩니다. Kunavo는 GET /v1/models에 응답하므로 목록이 자동으로 채워지며, 충돌이 발생하면 직접 설정한 model add 필드가 우선합니다.
5. 범위가 제한된 작업 하나를 실행한 다음 /app/billing에서 계정에 기록된 청구액을 확인하세요. 터미널에 표시되는 수치는 직접 입력한 --price-* 값을 계산한 결과입니다. 실제 청구액은 원장에 기록된 금액입니다.

Crush의 사용자 지정 제공업체 섹션에서 확인했습니다(2026년 9월 21일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Crush에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.