홈가이드
Cursor용 Claude Code API: 사용자 지정 엔드포인트 설정
단일 벤더에 의존하지 않는 claude code api for cursor 설정을 찾고 계신가요? Cursor는 모든 OpenAI 호환 엔드포인트와 통신할 수 있으며, 이 안내서에서 필요한 각 설정을 설명합니다.
업데이트

설정할 내용
Cursor는 내장 AI 기능이 있는 편집기입니다. 모델 설정 중에는 OpenAI Base URL을 사용자 자신의 URL로 대체할 수 있는 필드와 키를 입력할 공간이 있습니다. 이를 통해 OpenAI 채팅-완성 형식을 따르는 모든 서비스에 채팅 요청을 보낼 수 있습니다. 이 서비스도 해당 형식을 따르므로 Cursor는 이를 채팅 및 인라인 편집의 모델로 사용할 수 있습니다.
입력할 값은 고정됩니다. Base URL: https://api.claudecodeapikey.com/v1. 모델 이름: uncensored. 키: 계정에 있는 키로, Bearer 토큰으로 전송합니다. 서버 측에는 다른 구성이 필요하지 않습니다.
이것이 무엇인지 명확히 하십시오. 엔드포인트의 모델은 독립적인 제공업체의 오픈 웨이트 모델입니다. Claude 모델이 아니며 Anthropic 또는 기타 업체의 공식 API도 아닙니다. Cursor 내부에 Claude 자체를 기대하고 여기로 오셨다면, 이는 다른 것이며 마지막 섹션에서 작업에 적합한지 평가하는 방법을 설명합니다.
Cursor 열기 전
중간에 멈추지 않도록 먼저 준비하십시오.
- Google 또는 이메일과 비밀번호로 계정을 생성합니다.
- API 키 페이지를 열고 키를 생성합니다. 키 가이드에서 각 버튼의 위치를 확인하십시오.
- 지불하지 않고 테스트하려면 $0.50 무료 체험 크레딧을 청구하십시오. 클릭 한 번으로 카드가 필요 없으며 7일 동안 유효합니다.
- 편집기를 탓하기 전에 터미널에서 빠른 검사를 실행하여 키가 작동하는지 확인하십시오.
curl https://api.claudecodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"Say ready."}]}'
메시지가 포함된 JSON 응답은 키와 URL이 올바르다는 의미입니다. HTTP 401은 키가 잘못되었거나 불필요한 공백이 있음을 의미합니다. 여기에서 수정하십시오. Cursor의 오류 메시지는 curl보다 구체적이지 않기 때문입니다.
Cursor 단계별 구성
메뉴 이름은 Cursor 버전에 따라 다르므로 아래 레이블을 가이드로 사용하고 가장 가까운 일치 항목을 찾으십시오.
- Cursor 설정을 열고 모델 섹션으로 이동하세요.
- OpenAI API 키 필드를 찾아 이 서비스에서 키를 붙여넣으세요.
- OpenAI Base URL 재정의 옵션을 켜고
https://api.claudecodeapikey.com/v1를 입력합니다. 끝에/v1을 포함하고/chat/completions과 같은 후행 경로 없이 입력하십시오. - 사용자 지정 모델 추가 옵션을 사용하고
uncensored를 정확히 소문자로 입력합니다. - 키 필드 옆의 확인 또는 저장 버튼을 누릅니다. Cursor는 작은 테스트 요청을 보냅니다.
- 채팅 패널을 열고 모델 드롭다운에서
uncensored를 선택한 후 짧은 프롬프트를 보냅니다.
확인 단계가 실패했지만 curl 검사가 통과했다면 URL이 키 필드가 아닌 Base URL 필드에 입력되었는지, 그리고 Cursor 버전이 업데이트 후 재정의 설정을 초기화하지 않았는지 확인하십시오. 빠른 시작에는 이 편집기에 대한 현재 단계가 유지됩니다.
알아두면 좋은 단일 세부 사항: 단일 덮어쓰기 설정은 OpenAI 제공자 슬롯에 적용됩니다. 해당 슬롯을 통해 실제 OpenAI 모델을 사용하는 경우, 해당 모델도 이제 이 엔드포인트로 라우팅됩니다. 많은 사용자가 되돌리고 싶을 때 별도의 Cursor 프로필을 유지하거나 덮어쓰기를 끕니다.
실제 코딩 프롬프트로 테스트
인사는 작은 증거일 뿐입니다. 컨텍스트와 지시사항을 테스트하는 프롬프트를 사용하세요. 프로젝트에서 함수를 선택하고 채팅을 연 후, 입력 검증 및 단위 테스트 추가와 같이 구체적인 작업을 요청하세요. 다음 세 가지를 주의 깊게 확인하세요.
- 스트리밍. 응답은 토큰 단위로 표시되어야 합니다. 엔드포인트는 SSE를 통해 스트리밍하므로, 긴 대기 후 텍스트 블록이 나타나면 프록시 또는 설정이 버퍼링하고 있음을 의미합니다.
- 컨텍스트 사용. 두세 개의 파일을 첨부하고 모든 파일이 필요한 질문을 하십시오. 컨텍스트 창은 100,000 토큰으로 많은 소스를 담을 수 있지만, 편집기가 실제로 전송하는 양은 편집기가 결정합니다.
- 지시 따르기. diff-only 응답이나 엄격한 출력 형식을 요청하고 모델이 이를 따르는지 확인하십시오. 오픈 웨이트 모델은 여기서 차이가 나며, 첫날에 이를 학습해야 합니다.
자체 저장소에서 실제 작업 5개를 짧은 목록으로 유지하고, 온도(temperature)와 같은 설정을 변경할 때마다 다시 실행하십시오. 자체 코드로 평가하는 것은 저희를 포함한 모든 일반 주장보다 낫습니다.
일반적인 오류 수정
401 또는 유효하지 않은 키
키가 잘못되었거나 클립보드에서 복사한 키가 만료되었거나, 키 주변에 공백이 있습니다. 다시 붙여넣으세요. Authorization 스키마가 Bearer인지 확인하세요. OpenAI 키 필드를 사용할 때 Cursor가 자동으로 설정해 줍니다.
404 또는 모델을 찾을 수 없음
거의 항상 Base URL 문제입니다. /v1 누락 또는 /chat/completions 추가가 경로를 깨뜨립니다. 모델 이름도 uncensored여야 하며, 대문자나 공백이 없어야 합니다.
속도 제한 또는 동시 요청으로 인한 429
한도에 도달했습니다. 체험 키는 분당 60개, 동시 2개의 요청을 허용하며, 일반 키는 분당 300개, 동시 8개의 요청을 허용합니다. 편집기는 여러 요청을 동시에 실행할 수 있습니다(예: 채팅과 백그라운드 편집). 스트리밍은 종료될 때까지 슬롯을 유지합니다. 오류 코드는 어떤 한도에 도달했는지 알려줍니다. rate_limited은 분당 요청 수를, concurrency은 동시 요청 수를 나타냅니다. 일시적인 과부하도 429 상태 코드와 Retry-After: 5를 반환하므로, 5초 후 재시도하는 것이 정확합니다.
응답이 잘림
컨텍스트 창은 100,000 토큰이며 프롬프트와 완료를 포함합니다. 매우 큰 첨부 파일은 응답에 거의 여지를 남기지 않습니다. 파일을 더 적게 보내거나 새 채팅을 시작하십시오.
역할을 하지 않는 기능
API는 텍스트 전용이며 임베딩을 제공하지 않습니다. Cursor 기능이 임베딩 모델이나 이미지 입력이 필요한 경우, 이 엔드포인트를 통해 작동하지 않습니다.
작동 후 조정할 설정
첫 성공적인 채팅 후, 몇 가지 조정으로 일상적인 사용을 더 원활하게 만들 수 있습니다.
편집 작업의 온도를 낮추십시오. 편집기에서 노출하는 경우, 약 0.2의 값이 더 안정적인 코드를 제공합니다. 브레인스토밍에는 온도를 높이십시오. 다음으로 첨부된 컨텍스트 양에 주의를 기울이십시오. 컨텍스트 창은 넉넉하지만, 첨부된 모든 파일은 입력으로 청구되므로 관련 없는 탭을 닫고 빌드 폴더를 제외하면 비용이 절감되고 응답이 더 집중됩니다.
에이전트 또는 다단계 모드를 사용하는 경우 도구 호출 지원을 기억하십시오. 엔드포인트는 tools 및 tool_choice을 허용하고 tool_calls을 스트리밍합니다. 특정 Cursor 기능이 이를 사용하는지는 버전에 따라 다르므로, 큰 변경 전에 작은 에이전트 작업을 실행하고 발생 사항을 읽은 후 신뢰하십시오. 마지막으로, 작업 중간에 낮은 잔액으로 놀라지 않도록 터미널 테스트에서 X-Balance-USD 헤더를 가끔 확인하십시오.
스크립트에서 동일한 키 사용
OpenAI 호환 엔드포인트의 한 가지 장점은 Cursor에 설정한 키가 코드에서도 작동한다는 것입니다. 여기 빌드 스크립트 또는 커밋 메시지 도구에 유용한 Node 예제가 있습니다.
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.claudecodeapikey.com/v1",
apiKey: process.env.API_KEY,
});
const out = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Write a conventional commit message for: fixed null check in parser" },
],
});
console.log(out.choices[0].message.content);
키를 파일에 저장하지 말고 환경 변수에 저장하십시오. 각 응답에는 X-Balance-USD 헤더가 포함되므로 스크립트는 크레딧이 부족할 때 경고할 수 있습니다.
비용 및 유지 결정 시점
에디터 사용은 입력이 많기 때문에 비용이 많이 듭니다. 각 요청에는 파일 컨텍스트가 포함됩니다. 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50의 가격으로, 입력 토큰 15,000개와 출력 토큰 1,000개를 처리하는 요청의 비용은 0.015 x $0.15 + 0.001 x $0.50 = $0.00225 + $0.0005 = $0.00275입니다. 이러한 요청 100개의 비용은 $0.275입니다. 가격 책정 페이지에서는 $20부터 시작하는 충전 금액과 $50부터 적용되는 보너스를 확인할 수 있습니다.
특정 벤더의 모델에 의존하여 복잡한 리팩토링이 필요한 경우나, 일반 채팅 엔드포인트에서는 사용할 수 없는 기능에 워크플로우가 의존하는 경우 기존 설정을 유지하세요. 토큰당 낮은 가격, 단순한 API, 합법적인 작업에 대한 콘텐츠 거부 횟수 감소를 원한다면 이 API를 사용하세요. 많은 개발자는 두 가지를 모두 구성하고 작업에 따라 전환합니다.
더 많은 가이드
질문과 답변
Cursor에서 어떤 베이스 URL을 입력해야 하나요?
https://api.claudecodeapikey.com/v1을 입력할 때 /v1을 포함하세요. 끝에 /chat/completions을 추가하지 마세요.
어떤 모델 이름을 추가해야 하나요?
소문자로 된 uncensored라는 사용자 정의 모델을 추가하세요. 이 API가 제공하는 유일한 모델 ID입니다.
이것으로 Cursor에서 Claude 모델을 사용할 수 있나요?
아닙니다. 이 엔드포인트는 독립적인 제공업체의 단일 오픈 웨이트 모델을 제공합니다. Anthropic 또는 기타 벤더의 공식 API가 아닙니다.
에디터에서 429 오류가 발생하는 이유는 무엇인가요?
분당 속도 제한을 초과했거나 동시에 요청이 너무 많습니다. 체험용 키는 동시 2개, 분당 60개의 요청을 허용하며, 일반 키는 동시 8개, 분당 300개의 요청을 허용합니다.
결제 없이 사용해 볼 수 있나요?
네. 신규 사용자는 API 키 페이지에서 $0.50의 무료 체험 크레딧을 받을 수 있습니다. 카드 등록이 필요 없으며 7일 동안 유효합니다.
키는 양식 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.