사전 준비: 의존성 설치
요청을 보내기 전에 환경에 필요한 도구가 있는지 확인하세요. 명령줄 테스트에는 curl이 필요합니다. Python 프로젝트의 경우 pip install openai을 통해 공식 OpenAI SDK를 설치하세요. Node.js의 경우 npm install openai를 실행하세요. 이러한 라이브러리는 OpenAI 호환 프로토콜을 자동으로 처리하여 엔드포인트를 변경해도 애플리케이션 논리를 변경하지 않아도 됩니다.
base URL 및 키 구성
클라이언트를 우리의 특수 claude code 프록시 엔드포인트로 연결하세요. 표준 OpenAI base URL을 우리 호스트로 바꾸고 고유한 API 키를 제공하세요. 이 단일 구성 변경은 모든 트래픽을 무검열 모델 서버로 보내며 표준 SDK 메서드와의 완전한 호환성을 유지합니다.
curl https://api.claudecodeproxyapi.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'BASE_URL을 https://api.claudecodeproxyapi.com/v1로 설정하고 Authorization 헤더에 키를 전달하세요. 이 설정은 OpenAI 호환 엔드포인트를 지원하는 모든 클라이언트에서 작동합니다.
채팅 완료로 테스트
간단한 텍스트 요청으로 연결을 확인하세요. /v1/chat/completions로 POST 요청을 보내고 uncensored 모델 ID를 사용하세요. 이는 키가 유효하고 프록시가 요청을 올바르게 라우팅하는지 확인합니다. 응답에는 법적 성인 콘텐츠에 대한 표준 콘텐츠 필터 없이 모델의 직접적인 답변이 포함됩니다.
from openai import OpenAI
client = OpenAI(base_url="https://api.claudecodeproxyapi.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)openai Python 클라이언트를 사용하여 메시지를 보내세요. 코드는 표준 OpenAI 사용법을 반영하여 다른 제공업체에서 전환할 때 마찰이 없도록 보장합니다.
스트리밍 응답 활성화
낮은 지연 시간과 실시간 토큰 표시를 위해 스트리밍을 활성화하세요. 클라이언트 구성에서 stream=True을 설정하세요. API는 토큰이 생성될 때 Server-Sent Events(SSE)를 반환합니다. 이는 즉각적인 피드백이 사용자 경험을 향상시키는 CLI 인터페이스나 애플리케이션에 이상적입니다.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.claudecodeproxyapi.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);Node.js에서 비동기 생성기를 반복하여 스트리밍을 구현하세요. 이 접근 방식은 부분 응답을 효율적으로 처리하여 긴 출력 중에도 UI가 응답 가능하도록 유지합니다.
함수 호출 사용
프록시는 향상된 에이전트 기능을 위한 함수 호출을 지원합니다. 요청 페이로드에 도구를 정의하면 모델이 도구 실행을 위한 구조화된 JSON을 반환합니다. 이 기능은 uncensored 모델과 원활하게 작동하여 벤더 종속성 없이 강력한 에이전트 워크플로우를 가능하게 합니다.
API 키 및 제한 관리
계정에는 하나의 API 키가 포함되어 있으며 언제든지 재생성할 수 있습니다. 재생성하면 이전 키가 즉시 무효화됩니다. 중단 없이 사용량을 모니터링하세요. 크레딧이 부족하면 요청이 402 오류를 반환하고 분당 300개 요청을 초과하면 429 오류가 발생합니다. 컨텍스트 창은 프롬프트와 완성을 합쳐 100,000 토큰입니다.
스트리밍
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)기술 사양
크레딧을 구매하기 전에 확인할 수 있도록 API의 실제 한도와 기능을 한곳에 정리했습니다.
| 항목 | 내용 |
|---|---|
| 형식 | OpenAI 호환: 어떤 OpenAI SDK든 base URL과 키만 바꾸면 동작 |
| 인증 | Authorization: Bearer YOUR_KEY |
| 엔드포인트 | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.claudecodeproxyapi.com/v1 |
| 모델 ID | uncensored |
| JSON 모드 | response_format: {"type": "json_object"} |
| 함수 호출 | 지원 — tools, tool_choice; 응답에 tool_calls (스트리밍 포함), 결과는 role: tool로 전송 |
| 최대 출력 | 100,000 토큰 윈도우의 남은 만큼; max_tokens는 선택 사항(별도 상한 없음) |
| 파라미터 | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| 컨텍스트 창 | 100,000 토큰 (입력 + 출력) |
| 스트리밍 | 지원 — SSE, 마지막 청크에 토큰 사용량 포함 |
| 응답 헤더 | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| 동시 요청 | 키당 동시 8개 |
| 속도 제한 | 키당 분당 300회 |
| 요청 크기 | 최대 8 MB |
| 보너스 | $50 이상 +5%, $100 이상 +10%, $200 이상 +15% |
| 과금 | 선불 크레딧에서 실제 사용량만큼 차감, 오류·거부는 무료 |
| 유효기간 | 유료 크레딧은 만료되지 않으며 구독 없음 |
| 가격 | 입력 100만 토큰당 $0.15 · 출력 100만 토큰당 $0.50 |
| 충전 | USDT (TRC20) 또는 USDC (Base), $20~$500 사이 원하는 정수 금액 |
| 무료 체험 | $0.50, 7일, 카드 불필요 · 체험 키: 동시 요청 2건, 분당 60건. 첫 충전 후 전체 한도(8건, 300건) 적용 |
| 로그인 | Google 또는 이메일과 비밀번호 |
| 콘텐츠 | 성인 콘텐츠 허용, 미성년자가 관련된 성적 콘텐츠는 거부 |
| 키 | 계정당 활성 키 1개, 새 키를 만들면 이전 키는 무효 |
오류 코드
오류는 고정된 type을 가진 JSON으로 반환되며, 실패하거나 거부된 요청은 과금되지 않습니다.
| 코드 | 유형 | 의미 |
|---|---|---|
400 | bad_request | 잘못된 JSON, 빈 메시지, 잘못된 파라미터 또는 컨텍스트 초과 |
401 | missing_key · invalid_key · key_revoked | 키 없음·잘못됨·새 키로 교체됨 |
402 | no_credit | 잔액 없음 — 충전하면 즉시 재개 |
403 | content_blocked | 미성년자 관련 성적 콘텐츠 — 거부, 과금 없음 |
404 | not_found | 알 수 없는 엔드포인트 |
413 | request_too_large | 본문 8 MB 초과 |
429 | rate_limited · concurrency | 분당 300회 또는 동시 8개 초과 — 잠시 후 재시도 |
503 | upstream_busy | 모델 혼잡 — 몇 초 후 재시도 |
질문과 답변
이것은 공식 Claude 또는 OpenAI 서비스인가요?
아니요, 오픈 웨이트 무검열 모델을 실행하는 독립적인 서비스입니다. OpenAI API 형식과 호환되지만 GPT 또는 Claude 모델을 제공하지 않습니다.
크레딧이 부족하면 어떻게 되나요?
이후 요청은 402 Payment Required 오류를 반환합니다. 암호화폐(TRC20의 USDT 또는 Base의 USDC)를 통해 언제든지 계정을 충전하여 서비스를 복원할 수 있습니다.
Claude Code CLI와 함께 사용할 수 있나요?
네, CLI를 구성하여 base URL과 API 키를 사용하도록 하면 핵심 애플리케이션 코드를 수정하지 않고도 이 무검열 프록시를 통해 요청을 라우팅할 수 있습니다.
키는 양식 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 다음 base URL을 변경하세요. 설정은 이것뿐입니다.