메인 콘텐츠로 건너뛰기

Crush란

Crush는 Charm의 터미널용 오픈 소스 코딩 에이전트입니다. Crush는 crushrc 파일에서 구성을 읽으며, 이 파일은 Crush 전용 명령을 쓸 수 있는 Bash 스크립트입니다. 이 구성은 Capriole AI를 OpenAI 호환 제공자 하나로 추가합니다.

사전 준비

시작하기 전에 다음이 있는지 확인하세요.

설치

Homebrew로 Crush를 설치하세요.
또는 npm으로 설치하세요.
설치를 확인하세요.

구성

모델 검증

Crush 0.98.1 버전은 아래 구성으로 지원 모델 섹션의 모든 모델에서 Capriole AI를 통한 파일 읽기, 파일 쓰기, 최종 답변 검사를 통과합니다. ~/.config/crush/crushrc를 만들거나 업데이트하세요.
각 설정의 역할은 다음과 같습니다.
  • --type openai-compat은 모든 모델을 Chat Completions로 보냅니다. Capriole AI는 이 모델을 모두 Chat Completions로 제공합니다.
  • --api-key "$CAPRIOLE_AI_API_KEY"는 Crush가 파일을 불러올 때 환경 변수에서 키를 읽으며, Crush는 이 키를 Bearer 토큰으로 보냅니다.
  • --discover-models false는 목록을 직접 추가한 모델로만 제한합니다.
  • model large는 주 코딩 모델입니다. model small은 세션 제목 생성 같은 가벼운 작업용 모델입니다.

Crush 실행

API key를 설정한 다음 프로젝트 디렉터리에서 Crush를 시작하세요.
Ctrl+L을 눌러 모델을 전환하세요. 비대화형으로 실행하려면 crush run을 사용하세요.

지원 모델

모델 참조는 capriole/<model-id> 형식을 사용합니다. openai-latest와 claude-latest는 항상 각 계열의 최신 플래그십 모델을 가리킵니다.

문제 해결

Crush가 인증 오류를 반환하는 이유는 무엇인가요?

Crush를 시작하기 전에 CAPRIOLE_AI_API_KEY를 내보내세요. Crush는 crushrc를 불러올 때 이 변수를 읽습니다.

Claude 모델이 Unsupported chat model_key로 실패하는 이유는 무엇인가요?

Chat Completions에서는 anthropic/claude-opus-5-5처럼 anthropic/ 접두사가 붙은 Claude ID를 사용하세요. claude-opus-5-5 같은 접두사 없는 ID는 Anthropic Messages용입니다.

구성 변경이 적용되지 않는 이유는 무엇인가요?

프로젝트 디렉터리의 .crushrc 또는 crushrc 파일은 ~/.config/crush/crushrc보다 우선합니다. 이런 파일이 있는지 확인한 다음 Crush를 다시 시작하세요.

참고

  • crushrc는 셸 스크립트로 실행됩니다. 키를 이 파일에 붙여 넣지 마세요.
  • 다른 Capriole AI 모델을 추가하려면 model add 줄을 하나 더 추가하세요. GET https://api.caprioletech.com/v1/models는 모든 모델 ID를 나열합니다.
  • 공식 참고: Crush, Crush configuration.
마지막 수정일 2026년 10월 20일