Coding Agent 설정

Crush 설정: API Key, Base URL, 모델

crushrc에 BetterToken API Key와 Base URL을 설정하고 모델을 선택해 No providers configured 오류를 해결하세요.

crushrc의 openai-compat 제공자로 Crush를 BetterToken에 연결하세요. GPT 모델을 사용한 macOS 테스트에서 Crush 0.98.2는 콜드 스타트 텍스트 요청 세 건과 /v1/chat/completions를 통한 파일 읽기 도구 호출을 완료했습니다.

주요 설정

필드	값
API Key	`--api-key`로 전달하는 BetterToken API Key
Base URL	`--base-url`로 전달하는 `https://bettertoken.ai/v1`
모델	`bettertoken/YOUR_MODEL_ID`
제공자 유형	`openai-compat`
구성 파일	`~/.config/crush/crushrc`

사전 요구 사항

아래 설치 명령을 위한 Homebrew
BetterToken API Key: 등록하고 발급받기
모델 광장의 Model ID와 컨텍스트 한도

설치

공식 Crush 저장소의 Homebrew 명령을 사용하세요.

brew install charmbracelet/tap/crush
crush --version

수동 설정

Crush를 실행할 터미널에서 BetterToken API Key를 설정하세요.

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

권장 Bash 구성 형식으로 ~/.config/crush/crushrc를 만드세요. 모든 YOUR_MODEL_ID를 바꾸고 --context-window를 선택한 모델의 문서화된 한도로 설정하세요. 예제의 128000은 클라이언트 선언값이며 BetterToken 모델 한도로 확인된 값이 아닙니다.

provider add bettertoken --type openai-compat --base-url "https://bettertoken.ai/v1" --api-key "$BETTERTOKEN_API_KEY"
model add bettertoken/YOUR_MODEL_ID --name "YOUR_MODEL_ID" --context-window 128000
model large bettertoken/YOUR_MODEL_ID
model small bettertoken/YOUR_MODEL_ID
permissions allow view

이 명령을 crushrc에 저장하면 Crush가 시작할 때 실행합니다. permissions allow view는 파일 보기 도구를 허용합니다. 이전 JSON 구성 형식은 개발 프로젝트에서 더 이상 권장하지 않지만 계속 작동하며 테스트에서 해당 텍스트 요청도 통과했습니다.

연결 확인

같은 터미널에서 프로젝트 디렉터리 기준으로 실행하세요.

crush run "Reply with only: OK"

최종 답변이 OK인지 확인하세요. 파일 접근을 확인하려면 Crush에 프로젝트의 알려진 파일을 읽도록 요청하고 view 도구 결과와 최종 답변을 모두 확인하세요.

모델 전환

model add로 모델을 추가하고 crushrc의 model large 및 model small 선택을 업데이트한 뒤 새 실행을 시작하세요.

자주 발생하는 오류

증상	확인할 내용
`No providers configured`	사용할 수 있는 제공자가 로드되지 않으면 Crush가 요청을 보내기 전에 이 오류를 표시합니다. `crushrc`의 위치와 내용을 확인하고 프로젝트 구성이 이를 덮어쓰는지도 확인하세요.
`401`	Crush를 시작하기 전에 `BETTERTOKEN_API_KEY`를 export하고 값을 확인하세요.
구성에 모델이 명시되지 않음	제공자만 구성했을 때 테스트에서 Crush는 `/v1/models`를 통해 모델을 검색했습니다. `model add` 항목을 명시하면 이 예제에서 사용할 모델 이름을 지정할 수 있습니다.
파일 접근에 승인이 필요함	로드된 구성에서 `permissions allow view`를 확인하세요.

기술 세부 정보

테스트된 openai-compat 제공자는 생성 요청을 /v1/chat/completions로 보냈습니다. 모델 항목을 명시하지 않았을 때 /v1/models를 사용해 모델을 검색했습니다.