Claude 시리즈 모델은 공식 네이티브 API를 통해 액세스할 수 있습니다. 사용하기 전에 anthropic 종속성을 설치하거나 업그레이드해야 합니다:
Claude가 아닌 모델의 경우 OpenAI API 형식을 대신 사용하십시오.
모델 정보 모델 Claude Opus 4 Claude Sonnet 4 Claude Sonnet 3.7 Claude Sonnet 3.5 Claude Haiku 3.5 Claude Opus 3 Claude Haiku 3 확장된 사고 예 예 예 아니요 아니요 아니요 아니요 컨텍스트 창 200K 200K 200K 200K 200K 200K 200K 최대 출력 32000 토큰 64000 토큰 64000 토큰 8192 토큰 8192 토큰 4096 토큰 4096 토큰 훈련 컷오프 2025년 3월 2025년 3월 2024년 11월 2024년 4월 2024년 7월 2023년 8월 2023년 8월
버전 3.5 이상 모델의 경우 4096 토큰보다 긴 출력이 필요한 경우 위 표의 최대 출력 열을 참조하여 "max_tokens" 매개변수를 명시적으로 지정해야 합니다.
Sonnet 3.7의 경우 extra_headers={"anthropic-beta": "output-128k-2025-02-19"}를 전달하여 최대 출력을 64K에서 128K로 늘릴 수 있습니다. 아래 “스트리밍 128K” 예제를 참조하십시오.
Claude 4 새로운 기능 새로운 거부 중지 사유 Claude 4 모델은 모델이 안전상의 이유로 생성을 거부하는 콘텐츠에 대해 새로운 refusal 중지 사유를 도입합니다:
{ "id" : "msg_014XEDjypDjFzgKVWdFUXxZP" , "type" : "message" , "role" : "assistant" , "model" : "claude-sonnet-4-20250514" , "content" : [{ "type" : "text" , "text" : "기꺼이 도와드리겠습니다. 당신은 할 수 있습니다 " }], "stop_reason" : "refusal" , "stop_sequence" : null , "usage" : { "input_tokens" : 564 , "cache_creation_input_tokens" : 0 , "cache_read_input_tokens" : 0 , "output_tokens" : 22 } } Claude 4로 마이그레이션할 때 refusal 중지 사유를 처리하도록 애플리케이션을 업데이트해야 합니다.
확장된 사고 확장된 사고가 활성화되면 Claude 4 모델용 메시지 API는 Claude의 전체 사고 과정 요약을 반환합니다. 요약된 사고는 확장된 사고의 전체 지능 이점을 제공하면서 오용을 방지합니다.
API는 Claude 3.7 및 4 모델에서 일관되지만 확장된 사고에 대한 스트리밍 응답은 스트리밍 이벤트 간에 지연이 발생할 수 있는 “덩어리” 전달 패턴으로 반환될 수 있습니다.
요약은 요청에서 대상으로 하는 모델과 다른 모델에 의해 처리됩니다. 사고 모델은 요약된 출력을 보지 않습니다.
인터리브된 사고 Claude 4 모델은 도구 사용과 확장된 사고를 인터리브하는 것을 지원하여 도구 사용과 응답이 일반 메시지와 혼합될 수 있는 보다 자연스러운 대화를 가능하게 합니다.
인터리브된 사고는 베타 버전입니다. 인터리브된 사고를 활성화하려면 API 요청에 베타 헤더 interleaved-thinking-2025-05-14를 추가하십시오:
extra_headers = { "anthropic-beta" : "interleaved-thinking-2025-05-14" } 엔드포인트: POST /v1/messages사용법 Curl
Python
Python 스트리밍 128K
Python 인터리브된 사고
curl https://aihubmix.com/v1/messages \ # 공식 엔드포인트를 AiHubMix의 API 엔드포인트로 교체 --header "x-api-key: $AIHUBMIX_API_KEY " \ # AiHubMix에서 생성한 키로 교체 --header "anthropic-version: 2023-06-01" \ --header "content-type: application/json" \ --data \ '{ "model": "claude-3-5-sonnet-20241022", "max_tokens": 1024, "messages": [ {"role": "user", "content": "안녕하세요, 세상"} ] }'
요청 본문 { "model" : "claude-3-5-sonnet-20241022" , "max_tokens" : 1024 , "messages" : [ { "role" : "user" , "content" : "삶의 의미는 무엇입니까?" } ] } 요청 매개변수 이름 위치 유형 필수 설명 x-api-key 헤더 문자열 아니요 Bearer AIHUBMIX_API_KEY Content-Type 헤더 문자열 아니요 없음 body 본문 객체 아니요 없음 » model 본문 문자열 예 없음 » messages 본문 [객체] 예 없음 »» role 본문 문자열 아니요 없음 »» content 본문 문자열 예 없음 » max_tokens 본문 숫자 예 없음
응답 예제 { "id" : "msg_013Uf6CwwyjSe35n3yVaPbLM" , "type" : "message" , "role" : "assistant" , "model" : "claude-3-5-sonnet-20241022" , "content" : [ { "type" : "text" , "text" : "그것은 인류의 가장 오래 지속되고 복잡한 철학적 질문 중 하나입니다! 보편적인 답은 없지만, 저는 복잡성을 인정하면서 그러한 질문을 신중하게 탐구하는 것을 목표로 합니다. 저는 의미 있는 대화를 나누고 제가 할 수 있는 곳에서 돕는 데 집중하려고 노력합니다. 당신에게 삶의 의미는 무엇입니까?" } ], "stop_reason" : "end_turn" , "stop_sequence" : null , "usage" : { "input_tokens" : 14 , "cache_creation_input_tokens" : 0 , "cache_read_input_tokens" : 0 , "output_tokens" : 61 } } 응답 결과 상태 코드 상태 설명 설명 데이터 모델 200 OK 없음 인라인
Claude 4로 마이그레이션 Claude 3.7에서 Claude 4 모델로 마이그레이션하는 경우 다음 변경 사항에 유의하십시오:
모델 이름 업데이트 # Claude 3.7에서 model = "claude-3-7-sonnet-20250219" # Claude 4로 마이그레이션 model = "claude-sonnet-4-20250514" # 또는 "claude-opus-4-20250514" 새로운 중지 사유 처리 새로운 refusal 중지 사유를 처리하도록 애플리케이션을 업데이트하십시오:
if response.stop_reason == "refusal" : print ( "Claude가 이 콘텐츠 생성을 거부했습니다" ) elif response.stop_reason == "end_turn" : print ( "정상적으로 완료됨" ) 지원되지 않는 기능 제거
토큰 효율적인 도구 사용 : Claude Sonnet 3.7에서만 사용 가능하며 Claude 4에서는 더 이상 지원되지 않음확장된 출력 : output-128k-2025-02-19 베타 헤더는 Claude Sonnet 3.7에서만 사용 가능
Claude Sonnet 3.7에서 마이그레이션하는 경우 요청에서 이러한 베타 헤더를 제거하는 것이 좋습니다:
# 이러한 헤더 제거 (있는 경우) # "token-efficient-tools-2025-02-19" # "output-128k-2025-02-19" 애플리케이션에서 Claude 사용 (예: Lobe-Chat) Lobe-Chat과 같은 타사 애플리케이션에서 Claude 모델을 구성하는 방법은 다음과 같습니다:
설정 페이지로 이동하여 모델 제공자로 Claude 를 선택합니다.
AiHubMix에서 API 키 를 입력합니다.
API 프록시 엔드포인트를 다음으로 설정합니다:
(권장) “클라이언트 요청 모드” 옵션을 활성화합니다.
선택한 모델을 모델 목록에 추가합니다.
AiHubMix의 설정 페이지에서 모델 이름을 복사하여 애플리케이션에 붙여넣는 것이 좋습니다.
Claude 텍스트 편집기 도구 Claude는 Anthropic의 텍스트 편집기 도구를 사용하여 텍스트 파일을 보고 수정하여 코드나 기타 텍스트 문서의 디버깅, 수정 및 개선을 도울 수 있습니다. 이를 통해 Claude는 제안만 하는 것이 아니라 파일과 직접 상호 작용하여 실질적인 지원을 제공할 수 있습니다.
텍스트 편집기 도구 사용 전 준비 사항 호환되는 모델 선택
Anthropic의 텍스트 편집기 도구는 다음 Claude 모델을 지원합니다:
Claude 4 모델 (claude-opus-4-20250514, claude-sonnet-4-20250514): text_editor_20250429Claude 3.7 Sonnet (claude-3-7-sonnet-20250219): text_editor_20250124Claude 3.5 Sonnet (claude-3-5-sonnet-20241022): text_editor_20241022
Claude 4 모델은 이전 버전과 호환되지 않는 완전히 새로운 텍스트 편집기 도구를 사용합니다. 올바른 도구 유형과 이름을 사용해야 합니다.
모델별 도구 구성 모델 버전 도구 유형 도구 이름 지원되는 기능 Claude 4 (Opus/Sonnet) text_editor_20250429str_replace_based_edit_toolview, str_replace, create Claude 3.7 Sonnet text_editor_20250124str_replace_editorview, str_replace, create, undo_edit Claude 3.5 Sonnet text_editor_20241022str_replace_editorview, str_replace, create, undo_edit
중요 변경 사항: Claude 4 모델은 더 이상 undo_edit 명령을 지원하지 않습니다. 코드에서 이 기능에 대한 모든 종속성을 제거하십시오.
사용 사례 평가 다음은 텍스트 편집기 도구를 사용하는 몇 가지 일반적인 시나리오입니다:
코드 디버깅: 구문 오류에서 논리적 문제에 이르기까지 코드의 문제를 식별하고 수정하는 데 도움을 줍니다.
코드 리팩토링: 대상 편집을 통해 코드 구조, 가독성 및 성능을 개선합니다.
문서 생성: 코드베이스에 docstring, 주석 또는 README 파일을 추가합니다.
테스트 생성: 구현 이해를 기반으로 단위 테스트를 생성합니다.
텍스트 편집기 도구 사용 메시지 API를 통해 Claude에 텍스트 편집기 도구를 제공합니다:
anthropic 패키지를 설치해야 합니다:
사용 예: python-Claude 4
python-Claude 3.7
Curl-Claude 4
Curl-Claude 3.7
import anthropic client = anthropic.Anthropic( api_key = "AIHUBMIX_API_KEY" , # AiHubMix에서 생성한 키로 교체 base_url = "https://aihubmix.com" ) response = client.messages.create( model = "claude-sonnet-4-20250514" , # 또는 claude-opus-4-20250514 max_tokens = 1024 , tools = [ { "type" : "text_editor_20250429" , "name" : "str_replace_based_edit_tool" } ], messages = [ { "role" : "user" , "content" : "primes.py 파일에 구문 오류가 있습니다. 수정하는 데 도움을 주시겠습니까?" } ] ) print ( "응답 내용:" ) for message in response.content: print (message.text)
Claude 4로 마이그레이션（텍스트 편집기 도구） Claude 3.7 Sonnet에서 Claude 4 모델로 마이그레이션하는 경우 다음 변경 사항에 유의하십시오:
도구 구성 업데이트 # Claude 3.7 Sonnet tools = [ { "type" : "text_editor_20250124" , "name" : "str_replace_editor" } ] # Claude 4 (Opus/Sonnet) tools = [ { "type" : "text_editor_20250429" , "name" : "str_replace_based_edit_tool" } ] 지원되지 않는 기능 제거
undo_edit 명령코드에서 undo_edit에 의존하는 모든 논리를 제거하십시오.
응답 예:
{ "id" : "msg_bdrk_012xyNaFCQg4zsVcTk5VkDAe" , "type" : "message" , "role" : "assistant" , "content" : [ { "type" : "text" , "text" : "`primes.py` 파일의 구문 오류를 수정하는 데 기꺼이 도움을 드리겠습니다. 먼저 문제를 식별하기 위해 파일을 살펴보겠습니다." }, { "type" : "tool_use" , "text" : "" , "id" : "toolu_bdrk_01P6jQG6suDSsDjzugqGVHWC" , "name" : "str_replace_based_edit_tool" , "input" : { "command" : "view" , "path" : "/repo/primes.py" } } ], "model" : "claude-sonnet-4-20250514" , "stop_reason" : "tool_use" , "usage" : { "input_tokens" : 1042 , "output_tokens" : 115 } } 
