Claude Platform 2026년 8월 19일 릴리스 노트: Files·Skills·사용자 관리가 정식이 된 날 | DAKER 커뮤니티

새 모델이 나온 날로 읽기 쉬운 업데이트가 있지만, 2026년 8월 19일 Claude Platform 릴리스 노트의 핵심은 다른 곳에 있습니다. 이번 변화는 가중치가 아니라 API의 상태 변화, 곧 파일과 스킬, 그리고 엔터프라이즈 사용자 관리가 정식으로 전환됐다는 점입니다.

특히 베타 헤더를 붙인 채 써 오던 구현은 이제 그대로 두기보다 한 번 점검하는 것이 좋습니다. 같은 날 헤더 요구사항이 사라지고 응답 형식도 함께 달라진 항목이 있어서, 겉으로는 호출이 되더라도 목록 처리나 운영 문서가 어긋날 수 있기 때문입니다.

파일과 스킬이 정식이다

이 소식은 anthropic.com 뉴스룸이 아니라 Claude Platform 릴리스 노트에 올라와 있습니다. 날짜는 2026년 8월 19일입니다. 도움말 센터 최신 제품 메모는 8월 6일이고, 같은 날 claude.com에는 Slack 인터뷰가 있습니다. 다만 이 글은 그 가운데 플랫폼 GA에만 범위를 두고 정리합니다.

이번 릴리스에서 실제로 정식이 된 것

이번 업데이트의 중심은 Files API, Agent Skills와 Skills API, 그리고 엔터프라이즈 관리 API의 사용자 관리입니다. 모두 베타 헤더 없이 호출할 수 있게 됐다는 공통점이 있습니다.

오늘의 핵심은 새 모델이 아니라 어떤 API가 정식이 됐는지입니다.

Files API

Files 문서에 따르면 /v1/files와 업로드한 파일을 참조하는 Messages 요청에서 files-api-2025-04-14 헤더가 더 이상 필요하지 않습니다. 업로드 시 expires_in_seconds를 넣을 수 있고, 파일 객체에는 expires_at이 포함됩니다.

목록 형식도 바뀌었습니다. 이제 page와 next_page, 그리고 ids[] 필터를 사용합니다. 반면 예전 베타 헤더를 계속 보내면 예전 형식인 before_id/after_id와 expires_at이 없는 응답이 유지됩니다. 즉, 헤더를 떼는 시점과 목록 형식이 바뀌는 시점이 같습니다. 둘을 따로 옮기면 목록 코드가 깨질 수 있습니다.

Files API는 헤더를 떼는 날과 목록 형식이 바뀌는 날이 같습니다.

한도도 문서에 명시돼 있습니다. 파일당 500MB, 조직당 1TB, 분당 약 500회입니다. Files API의 생성·조회·삭제 자체는 무료지만, Messages에 들어간 내용은 입력 토큰으로 청구됩니다. 업로드가 무료라고 토큰까지 무료인 것은 아닙니다.

격리 범위는 워크스페이스입니다. 같은 워크스페이스의 키는 그 안의 파일을 읽을 수 있으므로, 문서는 file_id를 서버 쪽 비밀처럼 다루라고 적고 있습니다. 여러 테넌트가 있는 앱이라면 테넌트마다 워크스페이스를 쓰는 것이 좋습니다. 워크스페이스는 최대 100개이며, 더 필요하면 계정 팀에 요청합니다.

Skills API와 Agent Skills

Agent Skills와 Skills API /v1/skills도 정식입니다. Skills 개요에 따르면 Skills API와 Messages의 container.skills에서 skills-2025-10-02 헤더가 더 이상 필요하지 않습니다. 예전 헤더를 보내도 동작은 계속됩니다.

다만 스킬은 코드 실행 도구가 있어야 하며, 요청당 최대 20개까지 넣을 수 있습니다. 또 스킬을 삭제하면 모든 버전이 함께 삭제됩니다. 문서는 이 동작을 GA 전용이라고 적고 있어, 베타 시기와 삭제 범위가 다를 수 있음을 시사합니다. 버전을 남겨야 한다면 삭제 전에 먼저 복사해 두는 편이 안전합니다.

GA 이후 스킬 삭제는 모든 버전을 함께 지웁니다.

엔터프라이즈 사용자 관리 API

엔터프라이즈 관리 API의 사용자 관리도 정식이 됐습니다. 대상은 Claude Enterprise, 즉 claude.ai입니다. 사용자 관리 문서에는 멤버, 초대, 그룹, 사용자 정의 역할이 정리돼 있습니다.

그룹과 사용자 정의 역할 호출에서는 anthropic-beta: ce-user-management-2026-07-13이 더 이상 필수가 아닙니다. 보내도 동작은 합니다. 관리 API 한도는 조직당 분당 100회이고, 초대 생성은 시간당 1,200회입니다.

여기서 중요한 제한도 있습니다. API가 지정할 수 있는 역할은 user와 managed뿐입니다. 사용자 정의 역할은 API에서 읽기만 할 수 있습니다. 또 초대 생성이 좌석을 구매하는 것은 아니며, 빈 좌석이 없으면 400이 반환됩니다. owner, membership_admin, primary_owner는 API로 지정하거나 제거할 수 없습니다.

같은 날 함께 바뀐 항목들

Managed Agents 도구도 같은 날 범위가 조금 더 구체화됐습니다. web_search와 web_fetch에는 allowed_domains 또는 blocked_domains를 넣을 수 있습니다. 도메인은 1개에서 64개, 길이는 1자에서 255자입니다. 같은 항목에 허용과 차단을 동시에 넣을 수는 없습니다.

web_fetch에는 max_content_tokens, web_search에는 user_location이 있습니다. 다만 Managed Agents는 여전히 managed-agents-2026-04-01 헤더가 필요합니다. 콘솔의 조직 단위 웹 검색 설정도 Managed Agents에는 적용되지 않습니다.

자체 호스트 Managed Agents 세션에는 메모리 저장소를 붙일 수 있습니다. Python, TypeScript, Go SDK 워커가 각 저장소를 mount_path로 받고 변경을 동기화합니다. 세션당 최대 8개이며, 기본 동기화 간격은 15초입니다. 반면 AWS 위의 Claude Platform에는 이 메모리가 없고, ant CLI 워커는 메모리 저장소를 마운트하지 않으며, Windows 호스트도 메모리 마운트를 지원하지 않습니다.

Claude Console 세션 뷰어는 타임라인 미니맵, 모델 요청 단위 대화, 비용과 원본 이벤트, 도구 통계를 보는 Inspector 형태로 바뀌었습니다.

무엇이 아닌지도 분명합니다

이번 릴리스는 새 Claude 모델 발표가 아닙니다. Files API는 Amazon Bedrock과 Google Cloud에 없고, Microsoft Foundry는 Hosted-on-Anthropic일 때만 해당합니다. 또 ZDR 대상도 아닙니다.

업로드한 파일을 다시 내려받을 수 있게 된 것도 아닙니다. 파일은 downloadable: false이며, 내려받을 수 있는 것은 스킬과 코드 실행의 출력입니다. 즉, 업로드한 원본을 다시 받는 API가 열린 날은 아닙니다.

이번 변화는 모델 출시가 아니라 플랫폼 기능의 GA입니다.

스킬도 표면 사이에 자동으로 동기화되지 않습니다. claude.ai, API, Claude Code는 서로 다른 저장소를 씁니다. API 스킬은 네트워크가 없고 런타임 패키지 설치도 없습니다. claude.ai 맞춤 스킬은 사용자 단위이며 관리자가 일괄 관리하지 않습니다. 또 스킬 검사는 Skills API와 콘솔 업로드를 아직 모두 덮지 않습니다.

관리 API 역시 콘솔 조직이 아니라 엔터프라이즈 조직을 대상으로 합니다. 사용자 정의 역할을 만들거나 수정할 수 있는 것도 아닙니다.

도메인 목록에는 Messages API의 추가 항목인 max_uses, citations, cache_control이 없습니다. 따라서 이 항목들이 오늘 새로 생겼다고 적으면 안 됩니다. 뉴스룸 글이 없는 날을 모델 출시일처럼 읽는 것도 맞지 않습니다.

마이그레이션에서 특히 조심할 부분

베타 헤더를 그대로 남겨 두면 당장은 동작하더라도, 다음 사람이 목록 형식이 어느 쪽인지 판단하기 어려워집니다. 오늘 헤더를 떼고 한 번 성공한 요청을 로그에 남겨 두는 편이 좋습니다. 성공 로그가 없으면 마이그레이션이 끝났다고 보기 어렵습니다.

용량 한도도 운영 문서에서 자주 오해되는 부분입니다. 1TB와 500MB는 각각 조직과 파일 기준입니다. 팀 전체가 임의로 나눠 쓰는 수치처럼 적어 두면 실제 장애 상황에서 원인을 잘못 짚기 쉽습니다. 큰 영상을 올리다가 막히는 경우라면 모델이 아니라 파일 한도에 먼저 걸린 것일 수 있습니다. 파일 크기와 만료 시간을 함께 기록해 두면 운영이 훨씬 분명해집니다.

스킬 20개는 조직 전체 총량이 아니라 요청당 최대치입니다. 이론상 많이 넣을 수 있어도, 실제로는 코드 실행 비용과 시간이 먼저 늘어납니다. 그래서 처음 확인할 때는 파일 하나와 스킬 하나가 함께 동작하는지만 보는 편이 현실적입니다.

관리 API는 엔터프라이즈 대상이라는 점도 다시 확인할 필요가 있습니다. 역할 이름을 임의로 만들어 지정할 수 없고, API가 받는 값은 user와 managed뿐입니다. 초대가 좌석을 늘리는 것도 아니므로, 빈 좌석이 없을 때의 400 응답을 버그로 오해하지 않는 것이 좋습니다.

자체 호스트 메모리 기능도 환경 차이를 분명히 봐야 합니다. AWS 배포에 있다고 적거나, Windows에서 지원된다고 적거나, ant CLI가 메모리를 붙인다고 적으면 문서와 달라집니다. 데모 대본에 없는 기능을 넣으면 실제 심사나 운영 환경에서 바로 어긋납니다.

오늘 DAKER 빌더가 확인하면 좋은 범위

오늘 할 일은 복잡하지 않습니다. 베타 헤더를 떼고, 파일 하나를 올린 뒤 Messages에서 그 아이디를 참조해 보고, 스킬 하나를 같은 요청에 넣어 보는 것입니다. 여기에 워크스페이스 경계를 한 줄로 정리해 두면 핵심 점검은 끝납니다.

릴리스 노트 캡처가 아니라 동작하는 링크가 제출입니다.

해커톤 주간이라면 더더욱 중요한 것은 문장보다 동작입니다. 베타 헤더를 뗐다는 설명 자체가 제출을 대신하지는 않습니다. 심사위원이 여는 것은 릴리스 노트가 아니라 URL입니다. 파일이 들어가고, 스킬이 동작하고, 그 결과가 다른 브라우저에서 열릴 때 비로소 제출이 됩니다. DAKER by DACON의 규칙도 그 점에서 달라지지 않습니다.

콘솔 세션 뷰어가 좋아진 점은 운영자에게 유용한 변화이지만, 그것을 제품 기능처럼 본문에 섞어 쓰지는 않는 편이 좋습니다. Inspector의 비용 숫자 역시 그 세션의 비용이지, 곧바로 우리 서비스의 벤치마크는 아닙니다.

정리하면, 오늘 범위는 파일, 스킬, 사용자 관리입니다. 그 밖의 항목은 릴리스 노트에서 다시 확인하는 것이 맞습니다. 확인하지 않은 기능을 오늘 새로 열린 정식 기능이라고 적지 않는 편이 정확합니다.

새 모델이 아닙니다. 파일과 스킬과 사용자 관리가 정식이 된 날입니다.

참고 자료: Claude Platform release notes — 2026년 8월 19일
Files
Skills
사용자 관리 문서

여러분은 이번 변경 가운데 어떤 부분이 실제 마이그레이션에서 가장 먼저 걸릴 지점이라고 보시나요?