Cursor 대체 Kimicode: 커스텀 엔드포인트 설정

작동 방식과 기대 사항

내장 채팅 기능이 있는 많은 코드 편집기는 OpenAI 엔드포인트를 사용자 지정 엔드포인트로 교체할 수 있습니다. 이 설정이 이 기능을 가능하게 합니다. 편집기에 세 가지 항목을 제공합니다: 베이스 URL, API 키 및 모델 이름. 나머지는 편집기 자체의 동작입니다.

이 API는 독립적인 제공업체가 실행하는 단일 오픈 웨이트 모델을 사용한 호스팅된 OpenAI 호환 서비스이며, 합법적인 성인 사용자를 위해 콘텐츠 거부 없이 답변하도록 조정되었습니다. Kimi의 자체 서비스가 아니며 벤더 간 라우터도 아니므로 모델 선택 기능이 없습니다. uncensored만 제공되며 이것이 유일한 모델 ID입니다.

현실적인 기대를 하세요. 이 모델이 편집기 기본 제공 모델보다 코드 작성에 더 뛰어나다고 주장하지 않으며, 벤치마크 데이터도 제공하지 않습니다. 얻는 것은 제어권입니다: 자체 엔드포인트, 토큰별 과금(입력 1M 토큰당 $0.15, 출력 1M 토큰당 $0.50), 주제 때문에 요청을 거부하지 않는 모델. 잃는 것은 편집기가 자체 모델에만 활성화하는 기능입니다.

단계별: Base URL 재정의

1. 로그인하여 API 키 페이지를 엽니다. 키를 생성하세요. 신규 사용자는 카드를 입력하지 않고 한 번의 클릭으로 7일 유효한 $0.50 무료 체험 크레딧을 받을 수 있습니다.
2. 편집기에서 모델 또는 API 설정을 엽니다. 예를 들어 Cursor에는 모델 설정에서 OpenAI Base URL을 재정의하는 옵션이 있었습니다. 해당 옵션의 이름과 위치는 릴리스마다 변경되므로 찾을 수 없으면 편집기 자체 문서를 확인하세요.
3. Base URL을 입력하세요: https://api.kimicode.cc/v1. /chat/completions을 추가하지 마세요.
4. OpenAI 키 필드에 키를 붙여넣으세요.
5. uncensored라는 사용자 지정 모델을 추가하고 채팅 패널에서 선택합니다.
6. 작은 테스트 질문을 실행하세요. 편집기에서 오류가 표시되면 개발자 콘솔이나 로그를 열고 HTTP 상태 코드를 확인하세요. 401은 키 문제, 404는 URL 문제, 429는 속도 제한입니다.

일부 편집기는 여기 존재하지 않는 호스팅 모델 이름을 호출하여 키를 검증합니다. 검증은 실패하지만 채팅은 작동한다면 검증 단계를 무시하세요. 편집기가 검증 없이는 저장을 거부한다면 다음 섹션의 다른 도구를 사용하세요.

테스트 중에는 체험판 제한 사항을 염두에 두세요: 동시 요청 2개, 분당 60개. 자동 완성 및 채팅 등 여러 배경 요청을 동시에 실행하는 편집기는 동시성 한도에 도달할 수 있습니다. 전체 키는 동시 8개, 분당 300개를 허용합니다.

커스텀 엔드포인트를 지원하는 기타 편집기 및 도구

편집기가 커스텀 Base URL을 허용하지 않으면 여러 오픈 소스 도구가 이를 허용합니다. 각 도구는 동일한 세 가지 값을 사용합니다. 변경될 수 있으므로 최신 문서에서 옵션 이름을 확인하세요.

Aider는 표준 OpenAI 환경 변수를 읽고 openai/ 접두어가 있는 OpenAI 호환 모델을 사용합니다:

Copyexport OPENAI_API_BASE="https://api.kimicode.cc/v1"
export OPENAI_API_KEY="YOUR_KEY"
aider --model openai/uncensored

VS Code 및 JetBrains용 확장 프로그램인 Continue는 공급자가 openai로 설정된 모델 항목과 API Base를 허용합니다. 파일 형식은 버전마다 다르므로 다음과 같은 형태를 찾아야 합니다:

Copy{
  "models": [
    {
      "title": "Kimicode API",
      "provider": "openai",
      "model": "uncensored",
      "apiBase": "https://api.kimicode.cc/v1",
      "apiKey": "YOUR_KEY"
    }
  ]
}

Cline은 설정에서 OpenAI 호환 공급자를 제공하며, 동일한 Base URL, 키 및 모델 ID를 입력합니다. 모든 경우 패턴은 동일합니다: 벤더 이름이 붙은 공급자가 아닌 OpenAI 호환 공급자를 선택하세요.

코드 작업에 적합한 시스템 프롬프트

편집기는 일반적으로 자체 지침을 추가하지만, 많은 편집기에서 사용자 지정 규칙이나 시스템 프롬프트를 추가할 수 있습니다. 짧고 구체적인 프롬프트가 긴 프롬프트보다 낫습니다. 조정할 수 있는 시작 지점은 다음과 같습니다:

사용자의 프로젝트에서 작업하는 코드 어시스턴트입니다. 문제를 해결하는 가장 작은 변경 사항으로 답변하세요. 전체 파일 대신 diff 또는 변경된 함수를 표시하세요. 요구 사항이 명확하지 않으면 코드를 작성하기 전에 질문을 하나 하세요. 버전이나 프레임워크에 대한 가정은 명시하세요.

이러한 줄이 필요한 이유? "가장 작은 변경"은 출력 토큰을 줄여 비용이 더 높은 출력(1M 토큰당 $0.50)을 절감합니다. "diff 표시"는 동일한 효과를 내며 검토를 용이하게 합니다. "질문 하나 하기"는 긴 잘못된 답변을 방지합니다. "가정 명시"는 오류가 코드에 도달하기 전에 잡을 수 있는 지점을 제공합니다.

코드에는 온도를 낮게 유지하세요. 0.2에서 0.4 사이의 값은 더 안정적인 출력을 제공하며, 프롬프트 디버깅 중 반복 가능한 결과를 원하면 seed를 전달할 수 있습니다. 둘 다 모델에 전달됩니다.

편집기 기능 부족 시 스크립트 활용

편집기 기능이 커스텀 엔드포인트에 맞지 않을 때 20줄 정도의 스크립트가 간극을 메우고 전송되는 내용에 대한 완전한 제어를 제공합니다. 이 스크립트는 파일을 읽고 자체 시스템 프롬프트로 검토를 요청한 후 스트리밍으로 답변을 출력합니다.

Copyimport os, sys
from openai import OpenAI

client = OpenAI(base_url="https://api.kimicode.cc/v1", api_key=os.environ["KIMICODE_KEY"])

SYSTEM = (
    "You are a careful code reviewer. List real bugs first, then risky spots. "
    "Quote the line you mean. Skip style comments."
)

path = sys.argv[1]
code = open(path, encoding="utf-8").read()

stream = client.chat.completions.create(
    model="uncensored",
    stream=True,
    temperature=0.3,
    messages=[
        {"role": "system", "content": SYSTEM},
        {"role": "user", "content": f"Review {path}:\n\n{code}"},
    ],
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)
print()

python review.py app/server.py로 실행하세요. 1,000 토큰 파일에 600 토큰 리뷰를 추가하면 $0.00015 + $0.0003 = $0.00045가 발생합니다. $2 미만으로 수천 개의 파일을 검토할 수 있습니다.

커밋 메시지, 테스트 생성, docstrings에도 동일한 패턴이 적용됩니다. 편집기 키에 스크립트를 바인딩하면 플러그인 없이 사용자 지정 명령어를 가질 수 있습니다.

이것이 적합한 곳과 적합하지 않은 곳

이 설정은 자체 엔드포인트를 원하고 토큰별 과금을 원하며 주제 때문에 작업을 거부하지 않는 모델을 원하는 경우 적합합니다. 솔로 개발자, 소규모 팀 및 하나의 클라이언트 라이브러리를 통해 여러 공급자와 통신하는 도구를 구축하는 사람들에게 적합합니다.

편집기의 자체 호스팅 모델에서만 작동하는 기능(특정 모델에 맞게 조정된 긴밀한 인라인 자동 완성 또는 이미지 기반 기능 등)에 의존한다면 적합도가 낮습니다. 이러한 기능이 작업 방식의 핵심이라면 기본 설정을 유지하고 채팅 패널 및 스크립트에 이 API를 사용하세요. 두 가지를 혼합하는 것은 일반적이며 추가 비용이 들지 않습니다.

단순히 체험해 보고 싶다면 API 키 페이지에서 체험판을 신청하고 편집기에 현재 작업과 관련된 세 가지 질문을 하세요. 답변을 현재 얻는 답변과 비교하세요. 이 테스트는 10분이 걸리며 센트 단위의 일부 비용만 사용합니다.

텍스트 전용 모델의 정직한 제한 사항

전환하기 전에 알아야 할 세 가지 제한 사항이 있습니다.

텍스트 전용. 이미지 입력과 임베딩 엔드포인트가 없습니다. 편집기가 임베딩으로 코드베이스를 인덱싱하는 경우 해당 인덱스는 다른 소스가 필요하거나 해당 기능이 꺼져 있어야 합니다. 오류 스크린샷을 붙여넣어도 작동하지 않습니다; 오류 텍스트를 붙여넣으세요.

100,000토큰 창. 이는 프롬프트와 완성문을 합친 것입니다. 대략적인 규칙으로, 코드는 토큰당 3~4자 정도로 처리되므로 40 KB의 큰 파일은 약 10,000~13,000 토큰에 해당합니다. 여러 파일을 첨부하는 편집자는 한계에 빠르게 도달할 수 있습니다. 컨텍스트 오류를 보거든 파일을 더 많이 첨부하지 말고 적게 첨부하세요.

숨겨진 라우팅 없음. 하나의 모델만 제공됩니다. 작업에서 실패하면 백그라운드에서 대체 모델이 없으므로 프롬프트를 다시 작성하거나 예시를 추가하거나 질문을 좁히세요.

비용 측면에서 20,000 입력 토큰과 1,000 출력 토큰이 필요한 일반적인 코딩 질문은 $0.003 + $0.0005 = $0.0035가 발생합니다. 하루에 50번이면 $0.175입니다. 가격 책정 페이지에는 $20부터 $500까지의 충전 옵션과 $50부터 적용되는 보너스가 있으며, 크레딧은 만료되지 않습니다. 프롬프트는 학습에 사용되지 않습니다.

커밋 전 체크리스트

• 장난감이 아닌, 실제 프로젝트의 실제 작업으로 체험 크레딧을 테스트하세요.
• 편집기에서 스트리밍이 작동하는지 확인하세요. 답변이 끝에만 표시되면 편집기가 버퍼링 중일 수 있습니다.
• 에이전트 기능을 사용하는 경우 도구 호출이 연결되었는지 확인하세요. 이 API는 tools와 스트리밍 tool_calls을 지원하지만, 편집기가 이를 전송할지 여부를 결정합니다.
• 오류 코드 섹션을 포함하여 문서 빠른 시작을 한 번 읽으세요.
• 월간 충전 한도를 결정하세요. 과금이 선불이므로 지출할 수 있는 최대 금액은 충전한 금액입니다.

선불 방식은 에이전트 루프를 실행하는 편집자에게 안전망 역할을 합니다. 루프가 잘못 실행되면 크레딧이 소진될 때 중단되어 예상치 못한 청구서가 발생하지 않습니다.

더 많은 가이드

• Kimi Code API 가격 vs 토큰 단위 사용량 기반 요금
• Kimi Code API URL: OpenAI 클라이언트를 위한 Base URL 설정
• Groq API: 무검열 LLM에 대한 흔한 오해와 사실