Claude Code 사용자를 위한 빠른 시작

인증

우리 프록시로 보내는 모든 요청에는 유효한 API 키가 필요합니다. API 키 받기 페이지에서 가입하면 즉시 이 키를 받게 됩니다. Authorization 헤더에 Bearer 토큰 형태로 포함하세요. 키가 없거나 유효하지 않으면 API가 401 오류를 반환합니다. 대시보드에서 언제든지 키를 재생성할 수 있으며, 이전 키는 즉시 무효화됩니다. 이를 통해 분실되거나 침해된 키로 선불 크레딧에 계속 접근하는 것을 방지합니다.

채팅 완료 엔드포인트

코딩 프롬프트를 표준 채팅 완성 엔드포인트로 보내세요. 모든 요청의 기본 URL은 https://api.claudecodeapikey.com/v1입니다. 대형 언어 모델에 접근하려면 모델 ID uncensored를 사용하세요. 이 모델은 합법적인 성인 용도에서 콘텐츠 거부 없이 답변하도록 조정되어 있어 불필요한 차단 없이 코드를 생성하는 데 이상적입니다. 이 엔드포인트는 표준 및 스트리밍 응답을 모두 지원합니다. 아래는 curl을 사용한 기본 요청 예시입니다.

Copycurl https://api.claudecodeapikey.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."}]
  }'

요청 본문은 8 MB 미만이어야 합니다. 이 한도를 초과하면 서버가 페이로드를 거부합니다. 모델은 입력 토큰과 출력 토큰을 모두 합쳐 100,000개의 토큰 컨텍스트 창을 처리합니다. 이를 통해 즉각적인 잘림 없이 상당한 양의 코드 스니펫과 긴 대화 기록을 다룰 수 있습니다.

Python SDK

Python을 사용하는 개발자의 경우 공식 OpenAI SDK를 사용하여 우리 API를 통합할 수 있습니다. 클라이언트를 우리 기본 URL로 지정하고 API 키를 제공하기만 하면 됩니다. uncensored 모델 ID는 SDK에서 다른 OpenAI 호환 모델과 정확히 동일하게 작동합니다. 완료 메서드를 호출하고 응답을 표준 텍스트 객체로 처리할 수 있습니다. 이 방법은 배치 처리나 더 큰 자동화 스크립트에 통합하는 데 이상적입니다.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.claudecodeapikey.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)

SDK가 JSON 직렬화를 처리한다는 점을 기억하세요. base_url 변수가 우리 프록시를 가리키도록 하기만 하면 됩니다. 응답 객체에는 생성된 텍스트가 포함되어 있으며, 이를 파일에 쓰거나 대화 컨텍스트에 다시 피드백할 수 있습니다.

Node SDK

Node.js 개발자는 OpenAI npm 패키지를 사용하여 프록시와 상호 작용할 수 있습니다. 사용자 정의 기본 URL과 API 키로 클라이언트를 구성하세요. 사용 패턴은 Python 구현과 동일합니다: 클라이언트를 생성하고 채팅 완료 엔드포인트를 호출한 후 결과를 처리합니다. 이는 서버 측 코드 생성 또는 실시간 코딩 어시스턴트에 유용합니다.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.claudecodeapikey.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 SDK는 HTTP 연결을 효율적으로 관리합니다. 사용자 정의 기본 URL을 지원하는 SDK 버전을 사용하고 있는지 확인하세요. 응답 구조는 OpenAI 표준과 일관되므로 필요시 다른 OpenAI 호환 공급자 간에 쉽게 전환할 수 있습니다.

스트리밍 응답

실시간 코딩 어시스턴스를 위해 요청에 stream: true을 설정하여 스트리밍을 활성화하세요. API는 서버 전송 이벤트(SSE) 스트림을 반환합니다. 각 청크에는 부분 응답이 포함되어 생성되는 코드를 표시할 수 있습니다. 이는 대화형 코딩 에이전트에서 사용자 경험을 크게 향상시킵니다.

Copystream = 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는 API 키당 분당 300개의 요청 제한을 시행합니다. 이를 초과하면 429 오류가 발생합니다. 애플리케이션에 지수 백오프 재시도 로직을 구현해야 합니다. 또한 각 계정은 하나의 API 키로 제한되며, 필요시 재생성할 수 있습니다. 402 오류는 선불 크레딧이 고갈되었음을 나타냅니다. 암호화폐(USDT 또는 USDC)로 $10부터 충전할 수 있습니다. 크레딧은 만료되지 않으므로 잔액을 잃지 않고 자신의 속도로 사용 중단을 재개할 수 있습니다.