이 호환성 레이어는 주로 모델 기능을 테스트하고 비교하기 위한 것이며, 대부분의 사용 사례에서 장기적이거나 프로덕션 준비가 완료된 솔루션으로 간주되지 않습니다. 완전히 기능적으로 유지하고 중단적 변경을 하지 않을 의도는 있지만, 우리의 우선순위는 Anthropic API의 안정성과 효과성입니다.알려진 호환성 제한사항에 대한 자세한 정보는 중요한 OpenAI 호환성 제한사항을 참조하세요.OpenAI SDK 호환성 기능에 문제가 발생하면 여기로 알려주세요.
최상의 경험과 Anthropic API의 전체 기능 세트(PDF 처리, 인용, 확장된 사고, 프롬프트 캐싱)에 액세스하려면 네이티브 Anthropic API를 사용하는 것을 권장합니다.

​
OpenAI SDK 시작하기

OpenAI SDK 호환성 기능을 사용하려면 다음이 필요합니다:
  1. 공식 OpenAI SDK 사용
  2. 다음 사항 변경
    • 기본 URL을 Anthropic의 API로 업데이트
    • API 키를 Anthropic API 키로 교체
    • 모델 이름을 Claude 모델을 사용하도록 업데이트
  3. 지원되는 기능에 대한 아래 문서 검토

​
빠른 시작 예제

from openai import OpenAI

client = OpenAI(
    api_key="ANTHROPIC_API_KEY",  # Your Anthropic API key
    base_url="https://api.anthropic.com/v1/"  # Anthropic's API endpoint
)

response = client.chat.completions.create(
    model="claude-opus-4-20250514", # Anthropic model name
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Who are you?"}
    ],
)

print(response.choices[0].message.content)

​
중요한 OpenAI 호환성 제한사항

​
API 동작

OpenAI 사용과의 가장 중요한 차이점은 다음과 같습니다:
  • 함수 호출의 strict 매개변수는 무시되며, 이는 도구 사용 JSON이 제공된 스키마를 따르는 것이 보장되지 않음을 의미합니다.
  • 오디오 입력은 지원되지 않으며, 단순히 무시되고 입력에서 제거됩니다
  • 프롬프트 캐싱은 지원되지 않지만, Anthropic SDK에서는 지원됩니다
  • 시스템/개발자 메시지는 대화 시작 부분으로 끌어올려지고 연결됩니다. Anthropic은 단일 초기 시스템 메시지만 지원하기 때문입니다.
지원되지 않는 대부분의 필드는 오류를 발생시키지 않고 조용히 무시됩니다. 이들은 모두 아래에 문서화되어 있습니다.

​
출력 품질 고려사항

프롬프트를 많이 조정했다면, OpenAI에 특별히 잘 맞춰져 있을 가능성이 높습니다. 좋은 시작점으로 Anthropic Console의 프롬프트 개선기를 사용하는 것을 고려해보세요.

​
시스템 / 개발자 메시지 끌어올리기

OpenAI SDK에 대한 대부분의 입력은 Anthropic의 API 매개변수에 직접 명확하게 매핑되지만, 한 가지 뚜렷한 차이점은 시스템/개발자 프롬프트의 처리입니다. 이 두 프롬프트는 OpenAI를 통해 채팅 대화 전체에 배치될 수 있습니다. Anthropic은 초기 시스템 메시지만 지원하므로, 모든 시스템/개발자 메시지를 가져와서 그들 사이에 단일 개행(\n)으로 연결합니다. 이 전체 문자열은 메시지 시작 부분에 단일 시스템 메시지로 제공됩니다.

​
확장된 사고 지원

thinking 매개변수를 추가하여 확장된 사고 기능을 활성화할 수 있습니다. 이는 복잡한 작업에 대한 Claude의 추론을 개선하지만, OpenAI SDK는 Claude의 상세한 사고 과정을 반환하지 않습니다. Claude의 단계별 추론 출력에 대한 액세스를 포함한 전체 확장된 사고 기능을 위해서는 네이티브 Anthropic API를 사용하세요. 
response = client.chat.completions.create(
    model="claude-opus-4-20250514",
    messages=...,
    extra_body={
        "thinking": { "type": "enabled", "budget_tokens": 2000 }
    }
)

​
속도 제한

속도 제한은 /v1/messages 엔드포인트에 대한 Anthropic의 표준 제한을 따릅니다.

​
상세한 OpenAI 호환 API 지원

​
요청 필드

​
단순 필드

필드지원 상태
modelClaude 모델 이름 사용
max_tokens완전 지원
max_completion_tokens완전 지원
stream완전 지원
stream_options완전 지원
top_p완전 지원
parallel_tool_calls완전 지원
stop모든 비공백 중지 시퀀스 작동
temperature0과 1 사이(포함). 1보다 큰 값은 1로 제한됩니다.
n정확히 1이어야 함
logprobs무시됨
metadata무시됨
response_format무시됨
prediction무시됨
presence_penalty무시됨
frequency_penalty무시됨
seed무시됨
service_tier무시됨
audio무시됨
logit_bias무시됨
store무시됨
user무시됨
modalities무시됨
top_logprobs무시됨
reasoning_effort무시됨

​
tools / functions 필드

​
messages 배열 필드

​
응답 필드

필드지원 상태
id완전 지원
choices[]항상 길이가 1
choices[].finish_reason완전 지원
choices[].index완전 지원
choices[].message.role완전 지원
choices[].message.content완전 지원
choices[].message.tool_calls완전 지원
object완전 지원
created완전 지원
model완전 지원
finish_reason완전 지원
content완전 지원
usage.completion_tokens완전 지원
usage.prompt_tokens완전 지원
usage.total_tokens완전 지원
usage.completion_tokens_details항상 비어있음
usage.prompt_tokens_details항상 비어있음
choices[].message.refusal항상 비어있음
choices[].message.audio항상 비어있음
logprobs항상 비어있음
service_tier항상 비어있음
system_fingerprint항상 비어있음

​
오류 메시지 호환성

호환성 레이어는 OpenAI API와 일관된 오류 형식을 유지합니다. 그러나 상세한 오류 메시지는 동등하지 않습니다. 로깅 및 디버깅용으로만 오류 메시지를 사용하는 것을 권장합니다.

​
헤더 호환성

OpenAI SDK가 헤더를 자동으로 관리하지만, 직접 작업해야 하는 개발자를 위해 Anthropic의 API에서 지원하는 헤더의 전체 목록은 다음과 같습니다.
헤더지원 상태
x-ratelimit-limit-requests완전 지원
x-ratelimit-limit-tokens완전 지원
x-ratelimit-remaining-requests완전 지원
x-ratelimit-remaining-tokens완전 지원
x-ratelimit-reset-requests완전 지원
x-ratelimit-reset-tokens완전 지원
retry-after완전 지원
request-id완전 지원
openai-version항상 2020-10-01
authorization완전 지원
openai-processing-ms항상 비어있음