Crush API 키 설정

Crush API 키: crushrc에 자신의 키 설정

아래 블록을 crushrc에 붙여넣고 자신의 API 키로 바꾸면 Crush에서 Claude 및 기타 모델을 사용할 수 있습니다. 사용한 만큼 지불하세요.

~/.config/crush/crushrccrushrc
config
# ~/.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"

설정 단계

나중에 사용할 터미널을 위해 이 키를 저장하세요

로그인하면 이 명령에 사용자의 키가 포함됩니다. 복사해서 한 번 실행하면 도구가 테스트한 위치에 키를 보관합니다.

bash
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는 아직 테스트되지 않아 목록에 없습니다.

  1. 아직 Crush가 없나요? 설치하세요 (설치되어 있으면 건너뛰세요)

    npm i -g @charmland/crush를 실행한 다음 crush --version을 실행하세요. 버전 번호가 표시되면 설치된 것입니다.

    npm i -g @charmland/crush로 Crush를 설치하세요. crush --version을 실행하면 픽셀 로고가 그려지고 crush 버전 v0.98.1이 출력됩니다.
  2. crushrc에 설정을 붙여넣고 API 키를 추가하세요

    ~/.config/crush/crushrc를 열고, 이 페이지 상단의 블록을 붙여넣은 다음, sk-***를 API 키로 교체하세요 (API 키 받기). --api-key 뒤에 "$AICODEWITH_API_KEY"가 아닌 실제 키를 작성해야 새 터미널에서도 유지됩니다.

    ~/.config/crush/crushrc에서 --api-key를 자신의 키로 설정하세요 (여기서는 sk-***로 마스킹됨)
  3. 새 터미널을 열고 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 응답이 오면 설정이 완료된 것입니다.
  4. OK가 안 나오나요? 오류를 확인하세요

    터미널의 오류를 아래 일반적인 오류와 비교하세요. 각 오류에는 원인과 해결 방법이 나와 있습니다.

  5. 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에 설정을 붙여넣기 →

키 미설정: crushrc가 "$AICODEWITH_API_KEY"를 참조하지만 새 터미널에는 해당 변수가 없습니다. crush run --quiet -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK"를 실행하면 빨간 ERROR 레이블 아래에 Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}. 라는 메시지가 출력됩니다. (영어: "요청에 유효한 API 키를 제공하세요.")

잘못된 키: 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에 설정을 붙여넣기 →

잘못된 키: grep -n sk-wrong ~/.config/crush/crushrc를 실행하면 3번째 줄이 --api-key "sk-wrong"임을 보여줍니다. crush run --quiet -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK"를 실행하면 빨간 ERROR 레이블 아래에 Agent processing failed: failed to start agent processing stream: unauthorized: {"error":"请在请求中提供有效的 API Key。"}. 라는 메시지가 출력됩니다. 키가 없을 때와 동일합니다.

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 테스트 →

일반적인 오류: -m aicodewith/<model> 없이 Crush가 기본 Anthropic 엔드포인트(api.anthropic.com)를 호출하고 403 Forbidden을 받습니다(메시지 텍스트는 네트워크에 따라 다릅니다. 예: Request not allowed 또는 Country, region, or territory not supported). -m aicodewith/deepseek-flash(또는 설정에 있는 다른 모델)를 추가하세요

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가 비어 있거나 잘못되었습니다. 해결 방법은 위의 일반적인 오류를 참고하세요.

출처

관련 링크