AI허브코리아
활용법클로드

하이쿠 5.5 실무 가이드: 하루 300건 분류 파이프라인을 월 1천 원에 돌리기

관리자 Lv.10조회 1

요약

앤트로픽이 10월 7일 내놓은 클로드 하이쿠 5.5(claude-haiku-5-5)는 입력 100만 토큰 0.10달러, 출력 0.50달러다. 전작 하이쿠 4.5(1/5달러)의 10분의 1이고, 프롬프트 캐시 읽기는 0.01달러다. 단, 프롬프트가 10만 토큰을 넘는 요청은 5배(0.50/2.50달러)다. 컨텍스트 100만 토큰, 최대 출력 12만 8천 토큰, effort 5단계(기본 medium).

이 글은 발표 요약이 아니라, 이 모델로 실제 분류·선별 파이프라인을 짜서 운영 중인 사례(이 사이트의 콘텐츠 수집기)를 바탕으로 설계 포인트와 비용 계산을 정리한다.

요금표 (100만 토큰당, 달러)

하이쿠 5.5 (≤10만 토큰) 하이쿠 5.5 (>10만 토큰) 하이쿠 4.5 소넷 5.5
입력 0.10 0.50 1.00 2.00
출력 0.50 2.50 5.00 10.00
캐시 읽기 0.01 0.05 0.10 0.10
캐시 쓰기 0.125 0.625 1.25 2.50

배치 API는 50% 할인. 긴 컨텍스트 구간은 "한 요청의 프롬프트가 10만 토큰 초과"일 때 적용된다.

사례: 수집 후보 선별기

문제. 유튜브·블로그·뉴스 46개 소스에서 4시간마다 글을 긁어 오면 하루 100~300건이 쌓인다. 사람이 다 볼 수 없으니 "이 커뮤니티 독자에게 유익한 정도"를 0~10점으로 매기고, 7점 이상만 운영자 화면에 올린다.

설계 결정 네 가지.

  1. 모델은 하이쿠, 초안은 사람(또는 상위 모델). 점수 매기기는 분류 문제라 하이쿠로 충분하다. 글을 쓰는 건 별개 단계로 뺐다.
  2. 한 번에 15건 묶음. 처음 20건으로 했다가 한국어 요약 출력이 max_tokens 4000을 넘겨 JSON이 잘렸다. 15건 + max_tokens 8192로 바꿨다. 묶음이 클수록 호출 수는 줄지만 출력 상한과 실패 시 손실이 커진다.
  3. 구조화 출력. 점수·주제·한 줄·이유를 zod 스키마로 강제한다. 파싱 실패 걱정 없이 DB에 바로 넣는다.
  4. 시스템 프롬프트 캐시 + 하루 호출 상한. 평가 기준(700토큰쯤)은 매번 같으니 cache_control로 캐시한다. 호출 수는 DB에 세서 하루 40회를 넘기면 멈춘다. 키가 유출되거나 버그로 무한 호출해도 비용이 한정된다.

핵심 코드(TypeScript, Cloudflare Worker).

import Anthropic from '@anthropic-ai/sdk';
import { zodOutputFormat } from '@anthropic-ai/sdk/helpers/zod';
import { z } from 'zod';

const Result = z.object({
  items: z.array(z.object({
    id: z.number().int(),
    score: z.number().int().min(0).max(10),
    topic: z.string(),
    one_line: z.string(),
    why: z.string(),
  })),
});

const res = await client.messages.parse({
  model: 'claude-haiku-5-5',
  max_tokens: 8192,
  system: [{ type: 'text', text: SYSTEM_PROMPT, cache_control: { type: 'ephemeral' } }],
  messages: [{ role: 'user', content: `후보 ${rows.length}건입니다. 모든 id 에 대해 결과를 주세요.\n\n${list}` }],
  output_config: { format: zodOutputFormat(Result) },
});
const items = res.parsed_output?.items ?? [];

프롬프트에서 중요한 건 기준을 숫자 구간으로 못 박는 것이다. "9~10: 꼭 다뤄야 함 / 7~8: 다룰 만함 / 4~6: 참고만 / 0~3: 탈락"처럼 쓰고, "제목·설명에 없는 내용은 추측하지 마라"를 넣는다. 첫 실행 200건의 분포는 8점 3건, 7점 3건, 6점 24건, 5점 35건, 그 아래 135건이었다. 모델이 후하지 않다는 뜻이고, 문턱 7은 당분간 유지한다.

비용 계산. 호출 한 번에 입력 약 2,500토큰(시스템 700은 캐시), 출력 약 2,000토큰(생각 포함).

항목 달러
입력 1,800토큰 × 0.10/M 0.00018
캐시 읽기 700토큰 × 0.01/M 0.000007
출력 2,000토큰 × 0.50/M 0.0010
호출 1회 약 0.0012
하루 200건 = 14회 0.017
한 달 약 0.5달러 (700원)

하이쿠 4.5였다면 같은 작업이 월 5달러, 소넷 5.5면 월 10달러다.

effort 설정: 분류 작업이면 low를 먼저 시험하라

output_config.effort로 low·medium·high·xhigh·max를 고른다. 하이쿠 5.5의 기본은 medium이다.

await client.messages.create({
  model: 'claude-haiku-5-5',
  max_tokens: 2048,
  output_config: { effort: 'low' },
  messages: [{ role: 'user', content: '...' }],
});
  • low: 채팅, 짧은 도구 호출, 단순 대량 요청. 가장 싸고 빠르다. 긴 에이전트 프롬프트에서는 검색이나 확인 단계를 건너뛰는 경향이 있다.
  • medium(기본): 대부분의 작업, 에이전트 코딩 포함.
  • high: 지식 작업, 긴 에이전트 작업, 지시를 엄격히 따라야 할 때.
  • xhigh·max: 평가에서 이득이 확인될 때만. 이 구간이면 소넷 5.5와 비용·속도를 비교해 볼 것.

생각(thinking)은 기본으로 켜져 있고 max_tokens에 포함된다. high 이하에서는 thinking: { type: 'disabled' }로 끌 수 있다. 분류·추출처럼 정답이 좁은 작업은 low 또는 thinking 끄기로 시작해서, 평가 세트 정확도가 떨어지는지 보고 올리는 순서가 맞다. 위 선별기는 아직 medium인데, 다음 주에 low로 바꿔 분포를 비교할 예정이다.

주의: 같은 대화 안에서 최상위 effort를 바꾸면 캐시가 깨진다. 작업 종류별로 effort를 정해 두고 고정하라.

10만 토큰 경계 다루기

긴 PDF·로그·코드베이스를 통째로 넣는 작업은 요금이 5배가 된다. 대응은 셋이다.

  1. 쪼개서 보낸다. 10만 토큰 아래 조각으로 나눠 각각 처리하고 합친다. 분류·추출은 대부분 이게 된다.
  2. 캐시로 반복 비용을 줄인다. 같은 문서에 질문을 여러 번 하면 문서를 캐시해 두고 읽기 요금(0.05달러/M)만 낸다.
  3. 10만 토큰을 넘는 긴 입력이 본업이면 모델을 바꾼다. 사이먼 윌리슨의 비교대로 OpenAI GPT-6 Luna는 27만 2천 토큰까지 기본 요금이라 이 구간에서는 더 싸다.

새 토크나이저는 같은 글에 토큰을 더 쓴다. 앤트로픽은 "약간", 윌리슨은 긴 영어 프롬프트에서 약 1.25배로 측정했다. 비용 추정 시 토큰 수를 실제 usage 값으로 재라.

Max 구독자라면: 매달 API 크레딧

같은 날 Max 5x 구독자에게 월 100달러, Max 20x에 월 200달러, Team에 팀당 최대 500달러의 API 크레딧을 매달 주는 정책이 나왔다. 이월은 안 된다. 클로드 코드만 쓰던 사람도 위 같은 파이프라인을 크레딧 안에서 돌릴 수 있다.

확인하지 못한 것

  • 위 비용표의 토큰 수는 추정치다. 운영 로그에 usage를 기록해 다음 글에서 실측값으로 바꾼다.
  • 한국어에서 토크나이저 증가 비율은 측정하지 않았다.
  • 클로드 앱(claude.ai)에서 하이쿠 5.5를 직접 고를 수 있는지는 공식 발표에 없다.
  • 이용 경로는 클로드 API, AWS, Google Cloud, Microsoft Azure로 발표됐다. 각 클라우드의 리전별 제공 시점은 확인하지 않았다.

출처

확인일: 2026-10-19

추천 0추천은 글쓴이에게 경험치와 열람권이 됩니다. 같은 사람에게는 하루 한 번만 인정됩니다.

댓글 0

첫 댓글을 남겨 보세요.

댓글을 쓰려면 로그인하세요.