Anthropic은 개발자들이 익숙했던 것과는 다른 규칙 세트를 적용하여 Fable 및 Mythos 모델 라인을 출시했으며, 이에 대한 반응은 뜨거웠습니다. 논의를 지배했던 두 가지 주제는 Fable 및 Mythos 트래픽에 대한 새로운 30일 데이터 보존 요구 사항과 거의 예고 없이 적용된 일련의 가드레일 변경이었습니다. 프로덕션 환경에서 Claude API에 대해 어떤 작업을 실행하고 있다면, 이러한 변경 사항은 당신에게 직접적인 영향을 미칩니다.
이 게시물은 여러분의 코드에 영향을 미치는 부분에서 불필요한 정보를 걸러냅니다. 어떤 내용이 변경되었다고 보고되었는지, 지난주와 동일하게 작동하는 부분은 무엇인지, 그리고 추측하는 대신 Apidog를 사용하여 자신의 통합을 확인하는 방법을 알게 될 것입니다. Claude 통합을 유지하고 있다면, 지금 가장 안전한 방법은 가정을 신뢰하는 것이 아니라 테스트하는 것입니다.
실제로 변경된 사항
논의에서 세 가지 사항이 혼합되고 있습니다. 이들을 분리하면 그림이 더 명확해집니다.
데이터 보존. 주요 변경 사항은 Fable 및 Mythos 요청에 적용되는 30일 보존 기간입니다. 실제로 이는 해당 모델과 관련된 요청 및 응답 데이터가 즉시 삭제되지 않고 일정 기간 동안 보존된다는 의미입니다. 엄격한 데이터 처리 의무를 가진 팀들은 이것이 자체 사용자에게 약속할 수 있는 내용을 변경하기 때문에 중요하게 생각합니다. 개인정보 처리방침에 “우리는 프롬프트를 보존하지 않습니다”라고 명시되어 있다면, 이제 상위 공급자의 보존 정책도 해당 주장의 일부가 됩니다.
가드레일. 별도의 논의에서는 일부 보안 연구자들이 반발했던 Fable의 가드레일 변경 사항이 다루어졌습니다. 불만은 가드레일이 존재한다는 것이 아니라, 동작이 조용히 변경되어 어제는 통과했던 응답이 오늘은 필터링되거나 재구성될 수 있다는 점이었습니다. 일관된 출력에 의존하는 애플리케이션의 경우, 거부 동작의 조용한 변경은 실제 버그의 원인이 됩니다.
프로그래밍 방식 접근. 이 부분은 대부분의 개발자가 실제로 조치를 취해야 하는 부분입니다. API 표면, 인증 모델 및 핵심 요청 형태는 교체되지 않았습니다. 기존 키, messages 호출 및 도구 사용 스키마는 여전히 작동합니다. 변경될 수 있는 것은 동작입니다: 어떤 프롬프트가 거부되는지, 부하 시 호출 시간이 얼마나 걸리는지, 그리고 생성 도중 가드레일이 작동할 때 스트리밍 응답이 어떻게 보이는지 등입니다.
요약하자면, 계약은 안정적이지만 동작은 안정적이라고 보장할 수 없으며, 데이터에 대한 정책은 더욱 엄격해졌습니다. 이러한 조합은 바로 테스트가 필요한 이유입니다.
여전히 작동하는 것
어떤 것을 다시 작성하기 전에, 변경되지 않은 것을 확인하여 존재하지 않는 문제를 해결하지 않도록 하세요.
- 인증. API 키와
x-api-key헤더는 이전과 동일하게 작동합니다. 이러한 변경 때문에 키를 로테이션할 필요는 없지만, 키 로테이션은 여전히 좋은 위생 습관입니다. 현재 헤더 계약에 대해서는 Anthropic의 API 레퍼런스를 참조하세요. - Messages API 형태. 요청 본문,
model필드,max_tokens,system프롬프트 및messages배열은 변경되지 않았습니다. Messages API를 대상으로 작성된 코드는 계속 실행됩니다. - 도구 사용. 도구 정의와
tool_use/tool_result왕복은 동일하게 작동합니다. 함수 호출을 기반으로 에이전트를 구축했다면, 연결은 유지됩니다. - 스트리밍. 서버 전송 이벤트는 여전히 동일한 방식으로 토큰을 스트리밍합니다. 달라질 수 있는 점은 가드레일이 중간에 개입할 때 스트림의 내용입니다.
- 모델 별칭. 부동 별칭이 아닌 전체 ID로 모델을 고정하면, 어떤 모델이 응답할지 정확히 제어할 수 있습니다. 고정하는 것은 조용한 동작 변화에 대한 최고의 방어책입니다.
따라서 긴급한 재작업이 필요한 것은 없습니다. 작업은 검증입니다: 앱이 의존하는 동작이 여전히 유지됨을 증명하고, 조용히 유지되지 않는 경우를 포착해야 합니다.
Apidog로 통합을 테스트하는 방법
이것이 바로 진정한 API 클라이언트가 제 역할을 하는 지점입니다. 변경 로그를 하루 종일 읽을 수 있지만, 통합이 어떻게 응답하는지 아는 유일한 방법은 요청을 보내고 돌아오는 내용을 검사하는 것입니다. Apidog는 이러한 요청을 설계하고, 저장하고, 업스트림을 모의하고, 자동화된 검사로 실행할 수 있는 하나의 작업 공간을 제공합니다. Postman에서 옮겨왔거나 표준화된 적이 없다면, 이곳이 깨끗하게 시작할 수 있는 곳입니다; Postman 없이 API 테스트를 수행하는 더 넓은 사례가 여기 있습니다.
1. 알려진 양호한 기준선 캡처하기
Apidog에서 Messages API를 사용하여 관심 있는 프롬프트(장난감 프롬프트가 아닌 대표적인 프로덕션 프롬프트)에 요청을 생성하세요. 전체 모델 ID를 고정하고 응답을 저장하세요. 이것이 여러분의 기준선이 됩니다. 나중에 동작이 변경될 때, 기억에 의존하는 대신 이 저장된 응답과 비교할 수 있습니다.
POST https://api.anthropic.com/v1/messages
x-api-key: {{ANTHROPIC_API_KEY}}
anthropic-version: 2023-06-01
content-type: application/json
{
"model": "claude-fable-5",
"max_tokens": 1024,
"messages": [
{ "role": "user", "content": "Summarize this support ticket and label its priority: ..." }
]
}
API 키를 하드코딩하는 대신 Apidog의 환경 변수로 저장하세요. 이렇게 하면 키가 저장된 요청에서 제외되고, 드롭다운 메뉴 하나로 스테이징 및 프로덕션 환경을 전환할 수 있습니다. 이 패턴은 Claude, Claude Code의 SDK 또는 동일한 키 뒤에 있는 다른 모델을 테스트할 때도 동일하게 작동합니다.
2. 응답에 대해 단언(assert)하기, 눈으로 확인하지 마세요
기준선은 자동으로 확인해야만 유용합니다. Apidog에서 요청에 다음 단언(assertion)을 추가하세요:
- 상태는
200입니다. stop_reason은max_tokens또는 거부가 아닌end_turn입니다.- 응답 본문에는 앱이 구문 분석하는 구조화된 필드(예: 우선순위 레이블)가 포함됩니다.
- 응답 시간은 시간 초과 예산 이내입니다.
이제 스크린샷이 아닌 테스트를 갖게 되었습니다. 이를 정기적으로 실행하면 이전에 통과했던 프롬프트가 가드레일 변경으로 인해 필터링되기 시작하는 날을 알 수 있습니다. 이것은 API 계약 테스트의 바탕이 되는 것과 동일한 원칙입니다. 즉, 다운스트림 코드가 가정하는 동작을 고정하는 것입니다.
3. 의도적으로 거부 및 가드레일 경로 테스트하기
가드레일 불만 사항이 중요한 이유는 거부 동작이 워크플로를 망칠 때까지 무시하기 쉽기 때문입니다. 콘텐츠 경계 근처에 있는 작은 요청 세트를 구축하고 응답을 저장하세요. 이전에 허용되었던 프롬프트가 거부되거나 재구성되어 돌아오기 시작하면, 단언(assertion)이 실패하고 사용자보다 먼저 알게 될 것입니다. 거부 동작을 나중에 생각할 것이 아니라 테스트된 계약으로 취급하세요.
4. Anthropic을 모의하여 자체 테스트가 실시간 API에 의존하지 않도록 하기
여러분의 CI 스위트가 매번 유료이고, 속도 제한이 있으며, 동작이 변하는 상위 시스템을 호출하는 것을 원치 않을 것입니다. Apidog의 모의 서버를 사용하면 위에서 캡처한 거부 및 오류 형태를 포함하여 미리 준비된 응답을 반환하는 가짜 Messages 엔드포인트를 설정할 수 있습니다. 개발 및 통합 테스트 중에 애플리케이션이 모의 서버를 가리키도록 하세요. 여러분의 코드는 토큰을 소비하거나 속도 제한에 걸리지 않고 실제 응답 구조를 연습합니다. 실제 서비스를 원할 때는 기본 URL을 다시 전환하세요. 이를 기반으로 에이전트를 구축하고 있나요? 동일한 모의 패턴은 좋은 AI 에이전트 테스트 설정의 중추입니다.
5. 보존에 민감한 동작 확인하기
30일 보존 기간이 규정 준수 스토리에서 중요하다면, 팀이 볼 수 있는 곳에 이를 문서화하고 보유하고 있는 제어 기능을 테스트하세요. 어떤 엔드포인트를 호출하는지, 각 요청에서 시스템을 떠나는 데이터는 무엇인지, 그리고 필요한 것보다 더 많이 보내고 있지는 않은지 확인하세요. Apidog의 요청 기록은 통합이 어떤 페이로드를 정확히 보내는지 쉽게 감사할 수 있도록 해주므로, 프롬프트에 포함될 필요가 없는 민감한 내용은 제거할 수 있습니다. Anthropic의 보존 정책을 변경할 수는 없지만, 여러분이 제공하는 내용은 제어할 수 있습니다.
6. 부하 및 시간 초과 상황에서 테스트하기
부하 상태에서의 동작은 조용한 변경 사항이 숨어 있는 곳입니다. Apidog를 사용하여 동일한 요청을 반복적으로 실행하고 지연 시간 증가, 부분 스트림 또는 간헐적인 가드레일 작동을 관찰하세요. 클라이언트에서 현실적인 시간 초과 및 재시도 정책을 설정한 다음, 재시도 기능이 문제를 악화시키는 대신 느리거나 잘린 응답을 실제로 처리하는지 테스트하세요. 상위 시스템의 속도 저하가 관찰되면, 상위 요청 시간 초과 수정에서 설명하는 디버깅 접근 방식이 직접 적용됩니다.
실용적인 체크리스트
이것을 한 번 실행하면 현재 상황을 정확히 알 수 있습니다:
- [ ] 전체 모델 ID를 고정하세요; 프로덕션 경로에 부동 별칭에 의존하는 것을 멈추세요.
- [ ] 앱이 의존하는 모든 프롬프트에 대한 기준 응답을 저장하세요.
- [ ] 상태,
stop_reason및 구문 분석하는 필드에 단언(assertion)을 추가하세요. - [ ] 거부 및 오류 형태를 캡처하세요; 조용히 변경되지 않음을 단언(assert)하세요.
- [ ] Messages API를 모의하여 CI가 실시간 엔드포인트를 호출하지 않도록 하세요.
- [ ] 30일 보존 기간에 대해 아웃바운드 페이로드를 감사하세요.
- [ ] 반복적인 부하에서 시간 초과 및 재시도 동작을 테스트하세요.
이 모든 것은 Anthropic이 더 자세한 내용을 발표하기를 기다릴 필요가 없습니다. 여러분이 검증을 통제하며, 검증은 정책 헤드라인을 팀에게 아무런 영향 없는 사건으로 만듭니다.
자주 묻는 질문
Fable 및 Mythos 변경 때문에 API 키를 변경해야 하나요? 아니요. 인증은 변경되지 않았습니다. 정기적인 키 로테이션은 여전히 좋은 관행이지만, 이러한 변경으로 인해 강제되지는 않습니다.
기존 Messages API 및 도구 사용 코드가 작동하지 않게 되나요? 요청 및 응답 계약은 안정적이므로 코드는 계속 실행됩니다. 달라질 수 있는 것은 동작입니다; 거부, 지연 시간, 가드레일 하의 스트리밍 콘텐츠 등이 있습니다. 이것은 테스트 문제이지, 재작성 문제는 아닙니다.
30일 보존 변경이란 무엇인가요? 보고에 따르면 Fable 및 Mythos 트래픽에 30일 보존 기간이 적용된다고 합니다. 자체 개인정보 보호 약속이 상위 시스템의 보존 동작에 의존하는 경우, 이를 고려하고 실제로 어떤 데이터를 보내는지 확인하세요. 항상 Anthropic의 최신 데이터 사용 문서를 확인하여 공식적인 약관을 확인하세요.
사용자보다 먼저 가드레일 변경을 어떻게 알아차릴 수 있나요? 콘텐츠 경계 근처의 프롬프트에 대한 기준 응답을 저장하고, 단언(assertion)을 추가한 다음, Apidog에서 정기적으로 실행하세요. 단언 실패는 동작이 변경된 날을 알려줍니다.
토큰을 소비하지 않고 이 모든 것을 테스트할 수 있나요? 예. Apidog의 모의 서버를 사용하여 거부 및 오류 사례를 포함한 캡처된 응답을 재생하면, 개발 및 CI 실행이 실시간 API에 절대 접근하지 않습니다.
마무리
Fable 및 Mythos 변경은 실제이지만, 대부분의 개발자에게 이는 API가 고장 난 이야기가 아니라 동작 및 정책에 대한 이야기입니다. 여러분의 키는 작동하고, Messages 호출은 작동하며, 도구는 작동합니다. 문제는 조용히 움직이는 부분에 있습니다: 거부, 지연 시간, 그리고 데이터가 시스템을 떠난 후 어떻게 처리되는지입니다. 모델을 고정하고, 기준선을 캡처하고, 이에 대해 단언(assert)하고, 상위 시스템을 모의하여 테스트가 저렴하고 정직하게 유지되도록 하세요. Apidog를 다운로드하여 "여전히 작동하는 것 같아"를 "확인했고, 여기 증거가 있어"로 바꾸세요.