Claude API 메시지 스레드 베타, Gemini 2.5 Pro·Flash 12월 자동 전환, Vercel agent-desktop 1.0

메시지 스레드는 Messages API 대화를 서버에 잠깐 보관해 두는 기능이에요. 첫 요청에는 지금처럼 전체 대화·시스템 프롬프트·도구를 보내면서 thread 파라미터를 create로 주고 다음 턴부터는 새 메시지와 직전 응답 id만 continue로 보내요. 그러면 API가 대화를 다시 조립해 모델을 불러요. 스레드는 마지막 요청 뒤 5분이 지나면 만료되고 늦어도 1시간 안에 지워져요. 베타 헤더 message-threads-2026-08-12가 필요하고 SDK의 스레드 도우미를 쓰면 헤더와 재전송을 알아서 처리해 줘요.

thread = client.beta.messages.thread(model="claude-opus-5-5", max_tokens=1024)
thread.send({"role": "user", "content": "Hi!"})

긴 에이전트 루프에서는 턴마다 전체 대화를 다시 올리고 API가 그걸 매번 검증하고 토큰으로 나눠요. 스레드를 쓰면 이 일이 새 턴 몫으로 줄어서 대화가 길어져도 첫 토큰까지 걸리는 시간이 낮고 고르게 유지된다는 게 Anthropic 설명이에요. 다만 스레드는 '최선을 다하는' 저장이라 언제든 404가 날 수 있어요. 대화 원본은 앱이 계속 갖고 있다가 전체를 다시 보내는 경로를 처음부터 만들어 둬야 해요.

Google이 gemini-2.5-pro와 gemini-2.5-flash를 지원 종료 모델로 돌리고 Google AI Studio 선택지에서 뺐어요. 12월 1일부터 gemini-2.5-pro 요청은 gemini-3.8-flash로, gemini-2.5-flash 요청은 gemini-3.5-flash-lite로 자동으로 넘어가고 요금도 넘어간 모델 기준으로 매겨요. API로 gemini-2.5-pro를 쓸 수 있는 곳도 최근에 실제로 써 온 기존 사용자로 좁혀졌어요.

코드를 안 고쳐도 요청은 계속 성공하지만 다른 모델이 답하게 돼서 품질·지연·비용이 조용히 달라져요. Google은 함수 호출과 thought_signature 검증, thinking_budget 대신 thinking_level, 샘플링 파라미터와 모델 턴 미리 채우기(prefill) 제거를 깨지는 변경으로 꼽았어요. 2.5 모델에 맞춰 둔 프롬프트와 평가 세트가 있다면 11월 안에 새 모델로 다시 돌려 봐야 해요.

agent-desktop은 AI 에이전트가 macOS·Windows·Linux 데스크톱 앱을 운영체제 접근성 트리(화면 요소를 구조로 알려 주는 OS 기능)로 읽고 조작하게 해 주는 CLI이자 C 라이브러리예요. 스냅샷을 찍으면 눌러 볼 수 있는 요소마다 ref가 붙은 JSON이 나오고 에이전트는 그 ref로 클릭한 뒤 다시 스냅샷을 찍어 결과를 확인해요. 픽셀 이미지를 맞춰 보는 방식이 아니에요.

npm install -g agent-desktop
agent-desktop snapshot --app Finder -i

스크린샷을 보고 좌표를 찍는 컴퓨터 사용 방식보다 가볍고 결과가 JSON이라 Claude Code·Codex 같은 코딩 에이전트에 도구로 붙이기 쉬워요. 반복 루프는 내 에이전트 안에 그대로 남아서 특정 모델에 묶이지 않아요. 스냅샷과 클립보드에 개인 화면 내용이 담길 수 있으니 로그에 남기지 말라는 안내는 꼭 지켜야 해요.