
Claude 구 Workbench 폐지 및 실험적 프롬프트 API 종료, 8/17까지의 이행 대응 정리
요약
Anthropic이 2026년 8월 17일부로 구 Workbench와 실험적 프롬프트 API 3종을 폐지한다고 발표했습니다. 해당 API를 사용하는 경우 서비스 중단이 발생하는 Breaking Change이므로, 데이터 엑스포트 및 코드 이행이 필요합니다.
핵심 포인트
- 2026년 8월 17일 구 Workbench 및 실험적 API 3종 폐지
- 실험적 API 사용 시 요청 에러가 발생하는 Breaking Change 주의
- 저장된 프롬프트, 변수, 평가(evals) 데이터 사전 엑스포트 필수
- Messages API 등을 활용한 대체 로직 구현 및 점검 필요
2026년 7월 17일 자로 Anthropic으로부터 Claude Developer Platform (Claude Console)에 관한 중요한 폐지 공지가 있었습니다.
구 Workbench (platform.claude.com/workbench)가 2026년 8월 17일에 액세스 종료 - 같은 날,
실험적 프롬프트 도구 API 3종 (generate_prompt / improve_prompt / templatize_prompt)도 폐지
특히 실험적 프롬프트 도구 API는 severity: critical로 평가되어 있으며, 이 API들을 CI/CD 파이프라인이나 사내 도구에 포함하고 있는 경우, 폐지일 이후에는 요청이 에러로 실패하는 파괴적 변경(Breaking Change)입니다. 이행 유예 기간은 약 1개월밖에 되지 않으므로 빠른 점검이 필요합니다.
📌 영향을 받는 사람
- Claude Console의 Workbench에서 작성한 프롬프트, 변수, 평가(evals)를 저장하고 있는 사람
/v1/experimental/generate_prompt,/v1/experimental/improve_prompt,/v1/experimental/templatize_prompt를 코드나 스크립트에서 호출하고 있는 사람- 사내에서 프롬프트 엔지니어링 지원 도구를 이러한 API를 기반으로 구축하고 있는 팀
이번 변경은 '구 Workbench의 폐지'와 '그에 부수되는 실험적 API의 폐지'가 세트로 구성되어 있습니다. 관계성을 도표로 정리합니다.
구 Workbench의 종료와 실험적 API군의 폐지가 **동일한 날(2026년 8월 17일)**에 발생한다는 점이 포인트입니다. 데이터 이행과 코드 이행을 병행하여 진행해야 합니다.
| 항목 | 내용 |
|---|---|
| 대상 | platform.claude.com/workbench (레거시 버전) |
| 폐지일 | 2026년 8월 17일 |
| severity | high |
| 후속 | 신 Workbench (platform.claude.com/playground) |
| ... |
신구 Workbench의 기능 차이는 다음과 같습니다.
| 엔드포인트 | 용도 | 폐지 후의 동작 |
|---|---|---|
POST /v1/experimental/generate_prompt | 프롬프트 생성 | 에러를 반환 |
POST /v1/experimental/improve_prompt | 프롬프트 개선 | 에러를 반환 |
POST /v1/experimental/templatize_prompt | 프롬프트 템플릿화 | 에러를 반환 |
⚠️ Breaking Change
2026년 8월 17일 이후, 상기 3개 엔드포인트에 대한 요청은 모두 에러가 됩니다. 이것들을 이용한 자동화 스크립트, 사내 도구, CI 작업이 있는 경우, 폐지일까지 이행하거나 호출 부분을 삭제하는 것이 필수입니다.
구 Workbench 데이터 점검: 저장된 프롬프트, 변수, 평가(evals)를 파악함
- 엑스포트(Export) 실행: 화면 배너 또는 Organizational Settings에서 데이터를 엑스포트
- 실험적 API 이용箇所 검색: 리포지토리 내에서
generate_prompt,improve_prompt,templatize_prompt를 grep 하여 파악함 - 대체 구현으로 교체: 신 Workbench 상에서의 수동 프롬프트 작성, 또는 일반적인 Messages API를 이용한 자체 로직으로 이행
- 기한 내 동작 확인: 2026년 8월 17일 이전에, 이행 후의 코드가 문제없이 작동하는지 확인
판단 플로우로 만들면 다음과 같습니다.
사내 가이드라인이나 README에 실험적 API 이용에 관한 기술이 있는 경우, 다음과 같은 주의 사항을 추가해 두면 안전합니다.
## API 이용 시 주의사항
+ - 실험적 프롬프트 도구 API (/v1/experimental/generate_prompt, improve_prompt, templatize_prompt)는 2026년 8월 17일에 폐지됩니다.
...
실험적 API를 직접 호출하고 있는 코드가 있는 경우의 대응 이미지입니다.
Before (폐지 예정인 실험적 API를 이용)
import anthropic
client = anthropic.Anthropic()
# 2026-08-17에 폐지되는 실험적 엔드포인트 (experimental endpoint)
...
After (일반적인 Messages API로 대체 구현)
import anthropic
client = anthropic.Anthropic()
# 일반적인 Messages API를 사용하여, 프롬프트 생성 그 자체를 태스크 (task)로 요청함
...
💡 Tips
실험적 API (experimental API)가 담당했던 "프롬프트 생성·개선·템플릿화"는, 일반적인 Messages API에 대해 "〇〇를 하기 위한 프롬프트를 만들어줘"라고 요청하는 것만으로도 거의 동등한 결과를 얻을 수 있습니다. 전용 엔드포인트 (endpoint)에 대한 의존도를 줄임으로써, 향후의 폐지 리스크에도 강한 구현이 됩니다.
기존 Workbench (platform.claude.com/workbench)는 2026년 8월 17일에 액세스 종료. 저장된 프롬프트·변수·평가 (evals)는 새로운 Workbench로 이관되지 않으므로, 사전 익스포트 (export)가 필수
실험적 프롬프트 도구 API 3종 (generate_prompt / improve_prompt / templatize_prompt)도 같은 날 폐지. 폐지 후에는 에러가 발생하는 파괴적 변경 (breaking change, severity: critical)
대응 유예 기간은 약 1개월. 리포지토리 (repository) 내의 이용 사례를 파악하고 데이터 익스포트를 조기에 실시할 것을 권장
대안으로서, 일반적인 Messages API에 대해 프롬프트 생성 태스크를 요청하는 구현으로 많은 케이스를 커버 가능
기한이 임박했으므로, 우선 자신들의 프로덕트 (product)나 스크립트가 해당 엔드포인트에 의존하고 있지 않은지 지금 바로 확인하는 것을 추천합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기