Claude Code 대체 OpenAI: 코딩 에이전트 설정
Claude Code는 Anthropic 자체 API와 통신하므로 OpenAI 스타일 엔드포인트로 단순히 연결할 수 없습니다. 대신 다음을 사용하세요: 사용자 정의 OpenAI Base URL을 허용하는 코딩 에이전트 및 이 API와의 연결 방법.
업데이트됨

주요 포인트
- Claude Code는 Anthropic API 형식을 기반으로 하며, 본 서비스는 OpenAI 채팅 완료 형식을 사용합니다.
- Aider, Continue, Cline 및 Cursor 스타일 도구는 사용자 정의 OpenAI 호환 Base URL 및 모델 이름을 허용합니다.
- Base URL https://api.minimaxapikey.com/v1과 모델 ID uncensored, Bearer 키를 사용하세요.
- 먼저 curl로 테스트한 후 동시 요청을 8개 이하로 유지하세요. 에이전트는 한 번에 많은 호출을 발생시키기 때문입니다.
짧은 답변
Claude Code 대체 OpenAI를 검색하셨다면, 먼저 대체하려는 대상을 결정해야 합니다. Claude Code는 Anthropic의 터미널 코딩 에이전트입니다. Anthropic 자체 API를 사용하도록 설계되었으며, 이 API는 OpenAI와 다른 요청 형식을 사용합니다. 이 서비스는 OpenAI 채팅 완성 형식을 구현하므로 URL만 변경해서는 서로 호환되지 않습니다.
작동하는 방법은 OpenAI 호환 엔드포인트를 허용하는 코딩 에이전트 및 편집기 플러그먼트의 큰 계열입니다. Base URL, 키 및 모델 이름을 제공하면 일반 POST /v1/chat/completions 요청을 보냅니다. Aider, Continue, Cline은 모두 이 그룹에 속하며, 여러 편집기는 OpenAI 모델에 대한 Base URL 재지정을 제공합니다. 이 API의 경우 세 값은 Base URL https://api.minimaxapikey.com/v1, 모델 ID uncensored 및 Bearer 토큰으로 설정한 키입니다.
기대를 현실적으로 유지하세요. 엔드포인트의 모델은 독립 제공자가 실행하는 오픈 웨이트 모델 중 하나로, 합법적인 성인 사용에 대한 콘텐츠 거부 없이 답변하도록 조정되었습니다. Claude가 아니며, 어떤 모델 벤더의 공식 API도 아닙니다. 이 모델이 귀하의 저장소에 적합한지 여부는 자체 작업에서 확인해야 하며, 이 기사는 해당 테스트를 저렴하게 실행하는 방법을 보여줍니다.
Claude Code에서 URL만 변경할 수 없는 이유
API 형식은 주소보다 더 많습니다. Anthropic API에는 자체 메시지 구조, 시스템 프롬프트 표현 방식, 도구 사용 블록 및 자체 스트리밍 이벤트가 있습니다. OpenAI 스타일 서버는 role이 있는 messages, 함수 정의의 tools 배열, choices[0].delta를 전달하는 서버 전송 이벤트를 기대합니다. 한 형식을 위해 구축된 클라이언트는 URL이 연결 가능하더라도 다른 형식을 위한 서버에서 실패하거나 잘못 동작할 수 있습니다.
일부 사람들은 두 형식 사이에 번역 레이어를 배치합니다. 이는 요청과 응답을 다시 쓰는 작은 프록시로, 별도의 소프트웨어이며 직접 실행하고 디버깅해야 합니다. 도구 호출 및 스트리밍 주변의 동작은 이러한 레이어가 깨지는 경향이 있는 부분입니다. Claude Code가 타사 엔드포인트에 대한 공식 설정을 제공하는지 여부는 Anthropic의 최신 문서에서 확인해야 합니다. 이러한 옵션은 변경될 수 있기 때문입니다.
더 간단한 경로는 이미 OpenAI 형식을 지원하는 에이전트를 선택하는 것입니다. 기본 루프 측면에서 손실되는 것이 없습니다. 에이전트는 파일을 읽고, 프롬프트를 구성하고, 모델에 편집을 요청하고, 적용합니다. 모델은 교체하는 부분이며, 이 부분에는 호환되는 엔드포인트만 필요합니다.
도구를 건드리기 전에 curl로 엔드포인트 테스트
원시 API가 작동하는지 알면 통합 문제를 진단하기 쉽습니다. API key page에서 키를 생성하고 내보낸 후 요청을 하나 실행하세요. 성공하면 이후 실패는 키나 네트워크 문제가 아니라 도구 설정 문제입니다.
export UNCENSORED_KEY="paste-your-key-here"
curl -s https://api.minimaxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise coding assistant."},
{"role": "user", "content": "Write a Python function that parses an ISO date string."}
]
}'
GET /v1/models로 모델을 나열할 수도 있습니다. 많은 도구는 공급자를 저장할 때 이 엔드포인트를 호출하여 키가 유효한지 확인하므로, 설정하기 전에 반환되는 것을 확인하는 것이 좋습니다. 문서 페이지에 전체 요청 참조가 있습니다.
각 도구가 base URL을 입력하는 위치
설정 이름은 다르지만 아이디어는 모든 곳에서 동일합니다. 표에는 일반적인 코딩 도구와 입력할 필드가 나열되어 있습니다. 메뉴는 버전 간에 이동하므로 지도로 취급하고 현재 레이아웃을 위해 각 도구의 자체 문서를 확인하세요.
| 도구 | 엔드포인트 입력 위치 | 사용할 모델 이름 |
|---|---|---|
| Aider | OpenAI base URL 및 키를 위한 환경 변수 또는 명령줄 플래그 | openai/uncensored |
| Continue | 공급자 openai 및 apiBase이 있는 구성 파일의 모델 항목 | uncensored |
| 클라인 | 공급자 목록, OpenAI 호환 옵션 선택 | uncensored |
| Cursor | 모델 설정, base URL 재지정이 있는 OpenAI API 키 섹션 | 사용자 정의 모델로 uncensored |
| 사용자 스크립트 | 모든 OpenAI SDK의 base_url 인수 | uncensored |
본 서비스는 정확히 하나의 모델만 노출하므로 구성할 모델 선택기가 없습니다. 도구가 모델 이름을 요구하는 모든 곳에 uncensored를 입력하세요. 도구가 알려진 모델 목록을 고집하고 알려지지 않은 이름을 거부하는 경우 "사용자 정의 모델" 또는 "모델 추가" 옵션을 찾아보세요.
Aider 예제
Aider는 터미널에서 실행되며 git 저장소의 파일을 편집하고 결과를 커밋합니다. 이는 Claude Code와 정신적으로 가장 유사합니다. LiteLLM을 내부적으로 사용하므로 모델 이름에는 공급자 접두사가 붙습니다. OpenAI 호환 서버의 경우 이 접두사는 openai/입니다.
pip install aider-chat
export OPENAI_API_BASE="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
cd your-repo
aider --model openai/uncensored
시작한 후 단일 파일의 작은 변경 사항을 요청하고 diff를 확인하세요. 여러 파일 작업을 위임하기 전에 docstring 추가나 함수 이름 바꾸기처럼 몇 초 만에 확인할 수 있는 작업부터 시작하세요. Aider는 매 단계마다 저장소 맵과 채팅에 추가한 파일을 보내므로 프롬프트가 빠르게 커집니다. 100,000토큰 창(프롬프트 및 완성 포함)은 넉넉하지만, 큰 저장소의 경우 관련 파일만 추가해야 합니다.
Aider가 컨텍스트 크기나 모델 가격을 알지 못한다고 경고하면 이는 예상된 것입니다. 사용자 정의 모델 이름에 대한 항목이 없기 때문입니다. 이 경고는 작동하는 것을 방해하지 않습니다.
Continue 예제
Continue는 VS Code 및 JetBrains 내에서 채팅, 편집 및 자동 완성 기능을 추가하는 편집기 확장 프로그램입니다. 구성에는 공급자 및 선택적 재지정이 있는 각 모델이 나열됩니다. 이 API의 모델 항목은 다음과 같습니다. 정확한 파일 이름 및 스키마는 설치된 Continue 버전에 따라 다르므로 현재 문서와 비교하세요.
{
"models": [
{
"title": "Uncensored API",
"provider": "openai",
"model": "uncensored",
"apiBase": "https://api.minimaxapikey.com/v1",
"apiKey": "paste-your-key-here"
}
]
}
채팅 및 편집 요청은 이러한 엔드포인트와 잘 작동합니다. 탭 자동 완성은 다른 작업입니다: 입력 중 거의 모든 일시 정지에서 발생하며 매우 낮은 지연 시간이 필요하므로 작은 로컬 모델이 더 적합합니다. 인라인 완성에 호스팅 채팅 모델을 사용하면 분당 300회 제한에 대해 요청을 소모하지만 별다른 성과를 얻지 못합니다.
최소 에이전트 직접 구축
기존 도구가 맞지 않으면 도구 호출 지원으로 작은 에이전트를 쉽게 작성할 수 있습니다. API는 tools 및 tool_choice을 받고, tool_calls를 스트리밍하며, role: "tool" 메시지 형태로 결과를 받습니다. 아래 루프는 파일을 읽는 함수 하나를 모델에 제공하고, 모델이 일반 텍스트로 답변할 때까지 계속합니다.
import json
from openai import OpenAI
client = OpenAI(base_url="https://api.minimaxapikey.com/v1", api_key="paste-your-key-here")
tools = [{
"type": "function",
"function": {
"name": "read_file",
"description": "Return the text of a file in the current project.",
"parameters": {
"type": "object",
"properties": {"path": {"type": "string"}},
"required": ["path"],
},
},
}]
messages = [{"role": "user", "content": "Summarise what main.py does."}]
while True:
resp = client.chat.completions.create(model="uncensored", messages=messages, tools=tools)
msg = resp.choices[0].message
messages.append(msg)
if not msg.tool_calls:
print(msg.content)
break
for call in msg.tool_calls:
args = json.loads(call.function.arguments)
with open(args["path"], encoding="utf-8") as f:
result = f.read()
messages.append({"role": "tool", "tool_call_id": call.id, "content": result})
쓰기 함수와 실행 전 확인 프롬프트를 추가하면 약 50줄로 코딩 에이전트의 핵심을 가질 수 있습니다. 읽거나 쓰기 전에 항상 경로를 검증하세요. 모델은 원하는 모든 경로를 요청할 수 있습니다.
계획해야 할 제한 및 비용
에이전트는 사람 채팅과 다릅니다. 일괄 요청을 보내며, 종종 여러 요청을 병렬로 보냅니다. 전체 키는 동시 요청 8개와 분당 300개 요청을 허용합니다. 체험 키는 동시 2개, 분당 60개로 에이전트에는 빡빡할 수 있습니다. 제한을 초과하면 API는 HTTP 429와 오류 코드 rate_limited 또는 concurrency로 응답합니다. 일시적 과부하 시에도 Retry-After: 5와 함께 429를 반환합니다. 대부분의 클라이언트는 429에서 재시도하지만, 그렇지 않다면 병렬 설정을 낮추세요. 스트리밍 요청은 스트림이 끝날 때까지 동시 슬롯을 유지하므로, 긴 스트리밍 편집은 8개 제한에 포함됩니다.
비용 측면에서 선불 크레딧에서 사용한 만큼 지불하며, 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50입니다. 세션에서 40개의 요청이 각각 30,000개의 입력 토큰을 보내고 각각 1,000개의 출력 토큰을 받는다고 가정해 봅시다. 이는 1,200,000개의 입력 토큰(또는 $0.18)과 40,000개의 출력 토큰(또는 $0.02)으로 총 $0.20입니다. 실패하거나 거부된 요청에는 요금이 부과되지 않으며 크레딧은 만료되지 않습니다. 충전 금액 및 보너스는 요금제 페이지를 참조하세요.
새 계정은 키 페이지에서 한 번의 클릭으로 $0.50의 무료 체험 크레딧을 청구할 수 있으며, 카드가 필요하지 않고 7일 동안 유효합니다. 이는 curl 테스트와 몇 가지 작은 Aider 편집을 실행하기에 충분합니다. 프롬프트는 학습에 사용되지 않습니다.
더 많은 가이드
질문과 답변
Claude Code 자체에서 이 API를 사용할 수 있나요?
직접적으로는 불가능합니다. Claude Code는 Anthropic의 API 형식을 위해 설계되었으며, 본 서비스는 OpenAI 스타일의 채팅 완료(endpoints)를 구현하고 있습니다. Claude Code가 지원하는 내용을 확인하려면 Anthropic의 최신 문서를 참조하세요. 이 엔드포인트를 사용하려면 OpenAI 호환 에이전트를 사용하세요.
커스텀 OpenAI Base URL과 호환되는 코딩 도구는 무엇인가요?
Aider, Continue, Cline 모두 OpenAI 호환 Base URL, API 키 및 모델 이름을 입력할 수 있습니다. Cursor도 OpenAI 스타일 모델에 대한 Base URL 재지정을 제공하지만, 최신 설정 및 계약 제한 사항을 확인해야 합니다.
API는 에이전트를 위한 함수 호출을 지원하나요?
네. 도구와 tool_choice를 전송하고, 스트리밍된 tool_calls를 수신하며, role tool을 사용하여 결과를 반환할 수 있습니다. 특정 편집기 플러그인이 이러한 필드를 사용하는지는 플러그인에 따라 다릅니다.
코딩 세션 비용은 얼마인가요?
가격은 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50입니다. 에이전트는 컨텍스트를 많이 다시 전송하므로, 일반적으로 입력 토큰이 청구서의 대부분을 차지합니다.
키는 양식 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.