Claude 시리즈
Anthropic의 Claude 모델로 Opus, Sonnet, Haiku, Fable 시리즈가 있습니다. Anthropic 네이티브 API로 호출하는 것을 권장하며, 확장 사고, 프롬프트 캐싱, PDF 입력 등의 기능이 공식 API와 동일하게 동작합니다. OpenAI 호환 API도 사용할 수 있으며, 이미 OpenAI SDK 코드가 있는 프로젝트에 적합합니다.
주요 작업
모델
모든 모델이 텍스트, 이미지, PDF 입력과 도구 호출을 지원합니다. 전체 모델 목록과 실시간 가격은 모델 페이지 를 참고하거나 Models API로 조회하십시오.
anthropic/claude-opus-5.5anthropic/claude-sonnet-5.5anthropic/claude-haiku-5.5anthropic/claude-fable-5.1모델 ID에서 anthropic/ 접두사를 생략하거나 Anthropic 공식 표기법을 사용할 수도 있습니다. 다음 표기법은 모두 같은 모델을 가리킵니다.
모델별로 사용할 수 있는 별칭은 Models API가 반환하는 aliases 필드를 참고하십시오. 응답의 model 필드는 항상 표준 표기법으로 반환됩니다.
엔드포인트 선택
전체 요청 파라미터는 Anthropic Messages API와 Chat Completions API를 참고하십시오.
공급자
Claude 모델은 두 공급자가 제공하며, 같은 모델이라도 공급자에 따라 지원 기능이 다릅니다.
Anthropic 네이티브 API에서는 요청 헤더로 공급자를 지정할 수 있습니다.
-H "X-OfoxAI-Provider-Type: anthropic"지정한 공급자가 해당 모델을 제공하지 않으면 400이 반환되며, 오류 메시지에 사용 가능한 공급자가 나열됩니다. 예:
No available channel for platform 'anthropic' on model 'anthropic/claude-sonnet-4.6'. Available platforms for this model: aws_bedrock.다른 지정 방법은 공급자 라우팅을 참고하십시오.
호출 예시
Python(Anthropic SDK)
import os
import anthropic
client = anthropic.Anthropic(
base_url="https://api.ofox.io/anthropic",
api_key=os.environ["OFOX_API_KEY"],
)
message = client.messages.create(
model="anthropic/claude-sonnet-4.6",
max_tokens=1024,
system="당신은 숙련된 백엔드 엔지니어입니다. 간결하게 답하십시오.",
messages=[{"role": "user", "content": "멱등성이 무엇인지 한 문장으로 설명해 주세요."}],
)
print(message.content[0].text)max_tokens는 Anthropic 네이티브 API의 필수 파라미터이며, 모델의 최대 출력을 넘을 수 없습니다.
Claude Code에서 사용
Claude Code는 Anthropic 네이티브 API로 호출하며, 기본 주소는 https://api.ofox.io/anthropic입니다. 설정 방법은 Claude Code 설정을 참고하십시오.
https://api.ofox.io/anthropic자주 발생하는 오류
기타 일반 오류는 오류 처리를 참고하십시오.
공식 문서
공식 문서는 Anthropic에 직접 연결할 때의 동작을 설명합니다. OfoxAI에서 호출할 때는 모델 ID와 엔드포인트 주소를 이 페이지 기준으로 사용하십시오.
자주 묻는 질문
Claude 모델 ID는 어떻게 작성합니까?
표준 표기법은 anthropic/claude-sonnet-4.6입니다. anthropic/ 접두사를 생략하거나 공식 표기법인 claude-sonnet-4-6, claude-sonnet-4-6-20260217을 사용해도 모두 같은 모델을 가리킵니다.
OpenAI SDK로 Claude를 호출할 수 있습니까?
가능합니다. base_url을 https://api.ofox.io/v1로 설정하고 모델 ID에 anthropic/claude-sonnet-4.6 등을 입력하십시오. 확장 사고나 전체 캐시 사용량 정보가 필요하면 Anthropic 네이티브 API를 권장합니다.
Claude에서 사고 모드는 어떻게 켭니까?
네이티브 API에서는 thinking: {"type": "enabled", "budget_tokens": 2000}을 전달합니다. budget_tokens는 1024 이상이고 max_tokens보다 작아야 합니다. 또는 {"type": "adaptive"}를 전달해 모델이 결정하게 할 수 있습니다. OpenAI 호환 API에서는 reasoning: {"max_tokens": 2000}을 전달합니다. 사고를 켤 때는 temperature를 설정하지 마십시오.
Claude 프롬프트 캐싱이 적용되지 않으면 어떻게 합니까?
다음을 순서대로 확인하십시오. 고정 콘텐츠 블록에 cache_control을 표시했는지(두 API 모두 자동으로 캐시하지 않음), 콘텐츠가 최소 캐시 가능 길이에 도달했는지, 두 요청의 접두부가 완전히 같은지, 두 요청 사이가 5분을 넘지 않았는지 확인하십시오.
prompt is too long 오류가 나면 어떻게 합니까?
입력이 모델 컨텍스트를 초과한 것입니다. Haiku 4.5의 컨텍스트는 200K 토큰이고 나머지 Claude 모델은 1M 토큰입니다. 다른 모델로 바꾸거나 입력을 줄이십시오.
Claude는 1M 컨텍스트를 지원합니까? beta 요청 헤더를 추가해야 합니까?
Haiku 4.5를 제외한 모든 모델이 1M 컨텍스트를 지원하며, OfoxAI에서는 beta 요청 헤더를 전달할 필요가 없습니다.
Claude의 답변이 잘리면 어떻게 합니까?
응답의 stop_reason을 확인하십시오. max_tokens이면 출력이 상한에 도달한 것이므로 max_tokens를 늘리십시오. 사고를 켠 경우 사고 내용도 max_tokens 한도를 사용합니다.
OfoxAI의 Claude는 어느 공급자가 제공합니까?
모든 모델은 기본 공급자인 Amazon Bedrock이 제공합니다. Fable 5, Opus 4.8, Opus 4.7, Sonnet 5는 Anthropic 공급자도 있으며, Anthropic 네이티브 API에서만 사용할 수 있고 X-OfoxAI-Provider-Type: anthropic 요청 헤더로 지정해야 합니다.
Claude로 웹 검색을 할 수 있습니까?
가능하지만 Anthropic 공급자를 지정해야 하며, Fable 5, Opus 4.8, Opus 4.7, Sonnet 5에서만, 그리고 Anthropic 네이티브 API에서만 지원됩니다. tools에 {"type": "web_search_20250305", "name": "web_search"}를 추가하십시오.
Claude는 PDF를 읽을 수 있습니까?
가능합니다. 네이티브 API는 document 콘텐츠 블록으로 base64 인코딩된 PDF를 전달합니다. OpenAI 호환 API는 file 콘텐츠 블록을 사용하며, file_data는 data:application/pdf;base64,... 형식입니다.