SDK 미들웨어

Anthropic SDK는 요청이 전송되기 전과 응답이 수신된 후에 코드를 실행할 수 있는 "middleware"(미들웨어) 또는 인터셉터 훅을 제공합니다. 로깅, 사용자 정의 재시도, 요청 주석 추가, 거부 폴백 처리와 같은 횡단 관심사(cross-cutting concerns)에 미들웨어를 사용하세요.

각 미들웨어는 next()를 호출하기 전에 요청을 검사하거나 교체할 수 있으며, next()가 반환된 후에는 응답을 검사하거나 교체할 수 있습니다.

미들웨어 등록하기

각 미들웨어는 나가는 요청과 next 호출 가능 객체를 받는 함수입니다. next를 호출하여 요청을 체인의 나머지 부분으로 전달하거나(또는 이것이 마지막 미들웨어인 경우 SDK 코어로 직접 전달), 그 응답을 반환하세요. next 호출 이전의 모든 코드는 요청이 나갈 때 실행되고, 이후의 모든 코드는 응답이 돌아올 때 실행됩니다.

미들웨어 순서

여러 미들웨어를 등록하면 지정된 순서대로 적용됩니다. 첫 번째 미들웨어의 "이전" 코드가 가장 먼저 실행되고, "이후" 코드가 가장 마지막에 실행됩니다. 클라이언트에 등록된 미들웨어는 요청별 옵션으로 전달된 미들웨어보다 먼저 실행됩니다.

Go SDK에서는 option.WithMiddleware 호출을 반복하면 연결됩니다(클라이언트가 먼저, 그다음 메서드). 다른 SDK에서는 배열을 전달하며, 뒤에 있는 항목이 안쪽을 감쌉니다.

HTTP 클라이언트 교체하기

각 SDK는 프록시 구성, 사용자 정의 TLS 또는 연결 풀링을 위한 사용자 정의 HTTP 클라이언트도 허용합니다. SDK 클라이언트당 하나의 HTTP 클라이언트만 사용되며, 이를 설정하면 기본값이 대체됩니다. 사용자 정의 HTTP 클라이언트는 모든 미들웨어가 실행된 후에 요청을 받습니다.

기본 제공 미들웨어

SDK에는 Claude Fable 5가 거부한 요청을 폴백 모델에서 자동으로 재시도하는 거부 폴백 미들웨어가 포함되어 있습니다. 설정 방법과 언어별 예제는 폴백 모델에서 감지 및 재시도를 참조하세요.