Crush API 키 설정
Crush API 키: crushrc에 자신의 키 설정
아래 블록을 crushrc에 붙여넣고 자신의 API 키로 바꾸면 Crush에서 Claude 및 기타 모델을 사용할 수 있습니다. 사용한 만큼 지불하세요.
# ~/.config/crush/crushrc
provider add aicodewith --type openai-compat \
--base-url "https://api.aicodewith.ai/v1" \
--api-key "sk-***"
model add aicodewith/claude-haiku-4-5-20251001 --name "Claude Haiku 4.5"
model add aicodewith/gpt-5.5 --name "GPT-5.5"
model add aicodewith/deepseek-flash --name "DeepSeek Flash"설정 단계
나중에 사용할 터미널을 위해 이 키를 저장하세요
로그인하면 이 명령에 사용자의 키가 포함됩니다. 복사해서 한 번 실행하면 도구가 테스트한 위치에 키를 보관합니다.
mkdir -p "$(dirname "$HOME/.config/crush/crushrc")"
cat > "$HOME/.config/crush/crushrc" << 'EOF'
# ~/.config/crush/crushrc
provider add aicodewith --type openai-compat \
--base-url "https://api.aicodewith.ai/v1" \
--api-key "sk-***"
model add aicodewith/claude-haiku-4-5-20251001 --name "Claude Haiku 4.5"
model add aicodewith/gpt-5.5 --name "GPT-5.5"
model add aicodewith/deepseek-flash --name "DeepSeek Flash"
EOF로그아웃한 방문자에게는 자리 표시자만 표시됩니다. 로그인하면 키를 채워 드립니다. Sign in · 콘솔에서 키 받기
복사는 명령을 클립보드에 넣을 뿐입니다. 아직 터미널에서 실행하거나 도구 설정에 키를 붙여넣어야 합니다. API 키 받는 방법
이 단계들은 Linux(bash)에서 테스트되었습니다. macOS와 Windows는 아직 테스트되지 않아 목록에 없습니다.
아직 Crush가 없나요? 설치하세요 (설치되어 있으면 건너뛰세요)
npm i -g @charmland/crush를 실행한 다음crush --version을 실행하세요. 버전 번호가 표시되면 설치된 것입니다.npm i -g @charmland/crush로 Crush를 설치하세요. crush --version을 실행하면 픽셀 로고가 그려지고 crush 버전 v0.98.1이 출력됩니다. crushrc에 설정을 붙여넣고 API 키를 추가하세요
~/.config/crush/crushrc를 열고, 이 페이지 상단의 블록을 붙여넣은 다음,sk-***를 API 키로 교체하세요 (API 키 받기).--api-key뒤에"$AICODEWITH_API_KEY"가 아닌 실제 키를 작성해야 새 터미널에서도 유지됩니다.~/.config/crush/crushrc에서 --api-key를 자신의 키로 설정하세요 (여기서는 sk-***로 마스킹됨) 새 터미널을 열고 Crush를 테스트하세요
새 터미널을 열고
crush run --quiet -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK"를 실행하세요.OK가 표시되면 Crush가 API 키를 사용 중인 것입니다.확인: 터미널을 닫고 새 터미널을 열어 crush run --quiet -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK"를 실행하세요. OK 응답이 오면 설정이 완료된 것입니다. OK가 안 나오나요? 오류를 확인하세요
터미널의 오류를 아래 일반적인 오류와 비교하세요. 각 오류에는 원인과 해결 방법이 나와 있습니다.
Crush 모델 전환: -m 뒤의 이름을 변경하세요
-m뒤에aicodewith/와 crushrc에서model add로 추가한 모델을 작성하세요. 예:aicodewith/deepseek-flash. 모델 ID는 모델 및 가격에서 확인할 수 있습니다.
자주 발생하는 오류
키 미설정: Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}.
표시되는 내용
Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}.
(영어: "요청에 유효한 API 키를 제공하세요.")- 원인
- crushrc의 --api-key가 "$AICODEWITH_API_KEY"이고, 새 터미널에는 해당 변수가 없습니다
- 해결 방법
- 2단계에서처럼 --api-key 뒤에 키를 직접 입력하세요
2단계로 돌아가기: crushrc에 설정을 붙여넣기 →
잘못된 키: Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}.
표시되는 내용
Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}.
(영어: "요청에 유효한 API 키를 제공하세요.")- 원인
- --api-key의 키가 잘못되었습니다. 키가 없을 때와 같은 오류입니다
- 해결 방법
- 콘솔에서 키를 다시 복사해 --api-key 따옴표 안의 값을 바꾸세요
2단계로 돌아가기: crushrc에 설정을 붙여넣기 →
403 Forbidden
표시되는 내용
403 Forbidden (메시지 텍스트는 네트워크에 따라 다릅니다. 예: Request not allowed 또는 Country, region, or territory not supported)
- 원인
- 명령에 -m aicodewith/<model>이 없어서 Crush가 기본 Anthropic 엔드포인트(api.anthropic.com)를 호출합니다
- 해결 방법
- -m aicodewith/deepseek-flash(또는 설정에 있는 다른 모델)를 추가하세요
3단계로 돌아가기: 새 터미널을 열고 Crush 테스트 →
FAQ
Crush에서 내 API 키를 어떻게 사용하나요?
~/.config/crush/crushrc에서 provider add로 openai-compat provider를 추가하고 --base-url https://api.aicodewith.ai/v1를 설정한 뒤 --api-key 뒤에 키를 입력하세요. 새 터미널에서도 유지됩니다.
openai 또는 openai-compat?
openai-compat를 사용하세요. OpenAI에 직접 연결할 때는 openai를 유지하세요.
Crush crushrc는 어디에 있나요?
전역: ~/.config/crush/crushrc. 프로젝트의 .crushrc 또는 crushrc가 우선합니다.
Crush가 unauthorized라고 합니다. 이제 어떻게 하나요?
crushrc의 --api-key가 비어 있거나 잘못되었습니다. 해결 방법은 위의 일반적인 오류를 참고하세요.