클로드 AI 가격, API 사용량, 월 예산, 프롬프트 캐시 | 청구가 튀기 전에 어디에 가드를 걸까?

usage-to-usd.mjs | 호출 한 번의 달러를 찍는다
// node usage-to-usd.mjs
// ANTHROPIC_API_KEY 필요. 모델 아이디는 콘솔에서 복사.

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic();
const MODEL = process.env.CLAUDE_MODEL || 'claude-sonnet-4-6';

// 100만 토큰당 달러. 2026-08-15 공식 표. 결제 전 문서로 다시 확인.
const RATE = {
  'claude-haiku-4-5': { in: 1, out: 5, cacheWrite: 1.25, cacheRead: 0.1 },
  'claude-sonnet-4-6': { in: 3, out: 15, cacheWrite: 3.75, cacheRead: 0.3 },
  'claude-sonnet-5': { in: 2, out: 10, cacheWrite: 2.5, cacheRead: 0.2 },
  'claude-opus-5': { in: 5, out: 25, cacheWrite: 6.25, cacheRead: 0.5 },
};

function usdFromUsage(model, usage) {
  const r = RATE[model];
  if (!r) throw new Error('단가 표에 없는 모델: ' + model);
  const m = 1_000_000;
  const input = (usage.input_tokens || 0) / m * r.in;
  const output = (usage.output_tokens || 0) / m * r.out;
  const write = (usage.cache_creation_input_tokens || 0) / m * r.cacheWrite;
  const read = (usage.cache_read_input_tokens || 0) / m * r.cacheRead;
  return {
    usd: Number((input + output + write + read).toFixed(6)),
    input, output, write, read,
  };
}

const msg = await client.messages.create({
  model: MODEL,
  max_tokens: 256,
  messages: [{ role: 'user', content: '두 문장으로 응답 형식만 확인해 주세요.' }],
});

const cost = usdFromUsage(MODEL, msg.usage);
console.log({
  model: MODEL,
  usage: msg.usage,
  usd: cost.usd,
});

count-before-send.mjs | 보내기 전 입력 토큰을 잰다
// node count-before-send.mjs
import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic();
const MODEL = process.env.CLAUDE_MODEL || 'claude-sonnet-4-6';
const MAX_INPUT = Number(process.env.MAX_INPUT_TOKENS || 8000);

const messages = [
  {
    role: 'user',
    content: process.argv.slice(2).join(' ') || '첨부 없이 짧은 질문입니다.',
  },
];

const counted = await client.messages.countTokens({
  model: MODEL,
  messages,
});

console.log('입력 토큰', counted.input_tokens);

if (counted.input_tokens > MAX_INPUT) {
  console.error('입력 상한 초과. 문서를 줄이거나 모델을 내리세요.');
  process.exit(2);
}

console.log('상한 안. 이제 messages.create 를 호출하면 됩니다.');

month-ledger.mjs | 월 상한을 넘기면 호출을 막는다
// node month-ledger.mjs
// data/claude-spend.json 에 월별 합계를 쌓는다.

import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
import { dirname } from 'node:path';

const FILE = process.env.SPEND_FILE || 'data/claude-spend.json';
const MONTH_CAP = Number(process.env.MONTH_CAP_USD || 30);
const month = new Date().toISOString().slice(0, 7);

function load() {
  try {
    return JSON.parse(readFileSync(FILE, 'utf8'));
  } catch {
    return { months: {} };
  }
}

export function remainingUsd() {
  const db = load();
  const used = Number(db.months[month] || 0);
  return Number((MONTH_CAP - used).toFixed(6));
}

export function addSpend(usd) {
  const db = load();
  const used = Number(db.months[month] || 0);
  if (used + usd > MONTH_CAP) {
    throw new Error(
      month + ' 상한 ' + MONTH_CAP + '달러를 넘깁니다. 남은 값 ' + (MONTH_CAP - used).toFixed(4)
    );
  }
  db.months[month] = Number((used + usd).toFixed(6));
  mkdirSync(dirname(FILE), { recursive: true });
  writeFileSync(FILE, JSON.stringify(db, null, 2));
  return db.months[month];
}

const arg = Number(process.argv[2] || 0);
if (arg > 0) {
  console.log('누적', addSpend(arg), '남은 값', remainingUsd());
} else {
  console.log('이번 달 남은 값', remainingUsd());
}

prompt-cache.mjs | 고정 시스템 문구를 5분 캐시한다
// node prompt-cache.mjs
import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic();
const MODEL = process.env.CLAUDE_MODEL || 'claude-sonnet-4-6';

const SYSTEM = `당신은 이 저장소의 배포 규칙을 아는 도우미입니다.
- 커밋 메시지에 deploy 단어를 쓰지 않습니다.
- 기존 슬러그를 바꾸지 않습니다.
- 문의는 공개 이메일이 아니라 /partnership 경로로 안내합니다.
`.repeat(20); // 캐시 최소 길이를 맞추기 위한 연습용 반복. 실제로는 고정 매뉴얼을 넣습니다.

async function ask(userText) {
  const msg = await client.messages.create({
    model: MODEL,
    max_tokens: 200,
    system: [
      {
        type: 'text',
        text: SYSTEM,
        cache_control: { type: 'ephemeral' },
      },
    ],
    messages: [{ role: 'user', content: userText }],
  });
  return msg.usage;
}

const first = await ask('캐시 쓰기 확인용 짧은 질문');
const second = await ask('같은 시스템 문구로 두 번째 질문');
console.log('1회', first);
console.log('2회', second);
// 2회에 cache_read_input_tokens 가 늘고 cache_creation_input_tokens 가 줄어야 합니다.

route-by-budget.mjs | 남은 달러로 모델을 고른다
// node route-by-budget.mjs
import { remainingUsd } from './month-ledger.mjs';

const MODELS = {
  haiku: process.env.HAIKU_MODEL || 'claude-haiku-4-5',
  sonnet: process.env.SONNET_MODEL || 'claude-sonnet-4-6',
  opus: process.env.OPUS_MODEL || 'claude-opus-5',
};

export function pickModel({ task, remaining }) {
  if (remaining <= 0) {
    throw new Error('이번 달 상한에 닿았습니다. 콘솔 한도와 장부를 확인하세요.');
  }
  if (remaining < 3) return MODELS.haiku;
  if (task === 'classify' || task === 'extract') return MODELS.haiku;
  if (task === 'hard-review' && remaining >= 10) return MODELS.opus;
  return MODELS.sonnet;
}

const remaining = remainingUsd();
const task = process.argv[2] || 'draft';
console.log({ remaining, task, model: pickModel({ task, remaining }) });

batch-half.mjs | 당장 안 급하면 배치로 반값
// node batch-half.mjs
import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic();
const MODEL = process.env.CLAUDE_MODEL || 'claude-haiku-4-5';

const lines = [
  '첫 번째 로그: 결제 웹훅 타임아웃',
  '두 번째 로그: 재고 갱신 지연',
  '세 번째 로그: 캐시 미스 증가',
];

const batch = await client.messages.batches.create({
  requests: lines.map((text, i) => ({
    custom_id: 'log-' + (i + 1),
    params: {
      model: MODEL,
      max_tokens: 120,
      messages: [
        { role: 'user', content: '한 줄 원인 후보만 적으세요. ' + text },
      ],
    },
  })),
});

console.log(batch.id, batch.processing_status);
// 이후 client.messages.batches.retrieve(batch.id) 로 완료를 확인하고 결과를 받습니다.