AI 완전 정복 10편 — API로 직접 만들기와 비용 최적화

// npm i @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic(); // ANTHROPIC_API_KEY 환경변수, 일시적 오류는 SDK가 자동 재시도
 
const res = await client.messages.create({
  model: "claude-haiku-5-5",
  max_tokens: 300,
  system: "너는 한국어로 답하는 시니어 백엔드 개발자다. 답은 3문장 이내.",
  messages: [{ role: "user", content: "N+1 쿼리 문제가 뭐야?" }],
});
 
console.log(res.content[0].type === "text" ? res.content[0].text : "");
console.log(res.usage); // input_tokens, output_tokens, cache_* — 비용 계산의 근거

// npm i @anthropic-ai/sdk zod   (ANTHROPIC_API_KEY 환경변수 필요)
import Anthropic from "@anthropic-ai/sdk";
import { zodOutputFormat } from "@anthropic-ai/sdk/helpers/zod";
import { z } from "zod";
import { execSync } from "node:child_process";
 
const CommitMessage = z.object({
  type: z.enum(["feat", "fix", "refactor", "test", "docs", "chore"]),
  scope: z.string().describe("변경 모듈, 없으면 빈 문자열"),
  subject: z.string().describe("명령형 한국어, 50자 이내"),
  body: z.string().describe("무엇을, 왜 바꿨는지. 없으면 빈 문자열"),
});
 
const client = new Anthropic();
const diff = execSync("git diff --staged", { encoding: "utf8" }).slice(0, 40_000);
if (!diff) { console.error("staged 변경이 없습니다"); process.exit(1); }
 
const res = await client.messages.parse({
  model: "claude-haiku-5-5",          // 단순한 요약 작업 → 가장 저렴한 모델
  max_tokens: 400,
  thinking: { type: "disabled" },     // 요약에 긴 생각은 필요 없다. 켜 두면 생각 토큰이 400 안에서 답을 밀어낸다
  output_config: { format: zodOutputFormat(CommitMessage) }, // 응답을 이 스키마의 JSON으로 고정
  messages: [{ role: "user", content: `<diff>\n${diff}\n</diff>\n위 변경의 커밋 메시지를 작성해줘.` }],
});
 
const m = res.parsed_output;
if (!m) { console.error("형식에 맞는 응답을 받지 못했습니다"); process.exit(1); }
console.log(`${m.type}${m.scope ? `(${m.scope})` : ""}: ${m.subject}${m.body ? `\n\n${m.body}` : ""}`);

// client와 diff는 앞의 커밋 메시지 생성기와 같다
import { readFileSync } from "node:fs";
 
const manual = readFileSync("docs/coding-guide.md", "utf8"); // 수만 토큰짜리 사내 가이드
 
const res = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 1024,
  system: [
    { type: "text", text: "너는 사내 코딩 가이드에 따라 코드를 리뷰한다." },
    { type: "text", text: manual, cache_control: { type: "ephemeral" } }, // 여기까지 캐시
  ],
  messages: [{ role: "user", content: `이 diff를 리뷰해줘:\n${diff}` }],
});
console.log(res.usage.cache_creation_input_tokens, res.usage.cache_read_input_tokens);

// files: { content: string }[] — 처리할 파일 목록
const batch = await client.messages.batches.create({
  requests: files.map((f, i) => ({
    custom_id: `doc-${i}`,
    params: {
      model: "claude-sonnet-5-5",
      max_tokens: 2000,
      messages: [{ role: "user", content: `다음 파일의 export 함수에 JSDoc을 추가해줘:\n${f.content}` }],
    },
  })),
});
console.log(batch.id, batch.processing_status); // 나중에 상태를 조회해 결과를 받는다