GASでClaude APIの利用トークン数と
料金を自動で記録・集計する方法

// Claude APIの成功レスポンスには usage が含まれる。
// ここに正確な入力・出力トークン数が入っている。
// {
//   "content": [{ "type": "text", "text": "..." }],
//   "model": "claude-haiku-4-5",
//   "usage": { "input_tokens": 1234, "output_tokens": 567 }
// }

function callClaude(userText) {
  const apiKey = PropertiesService.getScriptProperties()
    .getProperty("CLAUDE_API_KEY");
  const model = "claude-haiku-4-5";

  const res = UrlFetchApp.fetch("https://api.anthropic.com/v1/messages", {
    method: "post",
    contentType: "application/json",
    headers: {
      "x-api-key": apiKey,
      "anthropic-version": "2023-06-01",
    },
    payload: JSON.stringify({
      model: model,
      max_tokens: 512,
      messages: [{ role: "user", content: userText }],
    }),
    muteHttpExceptions: true,
  });

  if (res.getResponseCode() !== 200) {
    throw new Error("Claude API error: " + res.getContentText());
  }

  const body = JSON.parse(res.getContentText());
  return {
    text: body.content[0].text,
    model: body.model,                     // 実際に使われたモデル名
    inputTokens: body.usage.input_tokens,  // 入力トークン数
    outputTokens: body.usage.output_tokens // 出力トークン数
  };
}

// モデルごとの単価テーブル（100万トークンあたりのドル単価）。
// ※単価は変更されることがあるため、必ず公式の料金ページで
//   最新の値を確認して設定すること。ここはサンプル値。
const PRICE_PER_MTOK = {
  // model名: { input: 入力単価, output: 出力単価 }
  "claude-haiku-4-5":  { input: 1.0,  output: 5.0 },
  "claude-sonnet-4-5": { input: 3.0,  output: 15.0 },
  // 未知のモデルに備えたフォールバック
  "default":           { input: 3.0,  output: 15.0 },
};

const USD_TO_JPY = 160; // 円換算レート（任意。ドルのままでもよい）

// トークン数から概算料金（USDと円）を計算する
function estimateCost(model, inputTokens, outputTokens) {
  const price = PRICE_PER_MTOK[model] || PRICE_PER_MTOK["default"];
  const usd =
    (inputTokens  / 1000000) * price.input +
    (outputTokens / 1000000) * price.output;
  return {
    usd: usd,
    jpy: usd * USD_TO_JPY,
  };
}

// 呼び出しの結果を「利用ログ」シートに1行追記する。
// シートの列: 日時 / モデル / 入力トークン / 出力トークン / USD / 円 / 用途
function logUsage(result, purpose) {
  const sheet = SpreadsheetApp.getActive().getSheetByName("利用ログ")
    || SpreadsheetApp.getActive().insertSheet("利用ログ");

  // 見出し行が無ければ作る
  if (sheet.getLastRow() === 0) {
    sheet.appendRow(["日時", "モデル", "入力トークン", "出力トークン", "USD", "円", "用途"]);
  }

  const cost = estimateCost(result.model, result.inputTokens, result.outputTokens);
  sheet.appendRow([
    new Date(),
    result.model,
    result.inputTokens,
    result.outputTokens,
    Number(cost.usd.toFixed(6)),
    Math.round(cost.jpy),
    purpose || "",
  ]);
}

// 呼び出しと記録をまとめたラッパー。今後はこれ経由で呼ぶ。
function callClaudeTracked(userText, purpose) {
  const result = callClaude(userText);
  logUsage(result, purpose);
  return result.text;
}

// 使い方
function demo() {
  const answer = callClaudeTracked("この文を3行で要約して: ...", "議事録要約");
  Logger.log(answer);
}

// 数百件を処理するときは、1件ごとにappendRowせず
// 配列に貯めて最後にまとめて書き込むと速い。
function processRowsWithTracking(texts, purpose) {
  const rows = [];
  for (const text of texts) {
    const r = callClaude(text);
    const cost = estimateCost(r.model, r.inputTokens, r.outputTokens);
    rows.push([
      new Date(), r.model, r.inputTokens, r.outputTokens,
      Number(cost.usd.toFixed(6)), Math.round(cost.jpy), purpose || "",
    ]);
  }

  const sheet = SpreadsheetApp.getActive().getSheetByName("利用ログ");
  if (sheet.getLastRow() === 0) {
    sheet.appendRow(["日時", "モデル", "入力トークン", "出力トークン", "USD", "円", "用途"]);
  }
  // まとめて1回で書き込む
  sheet.getRange(sheet.getLastRow() + 1, 1, rows.length, rows[0].length)
    .setValues(rows);
}

// 利用ログを読み、当月の合計とモデル別内訳を集計する。
function summarizeThisMonth() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("利用ログ");
  const values = sheet.getDataRange().getValues();
  const header = values.shift(); // 見出し行を除く

  const now = new Date();
  const y = now.getFullYear();
  const m = now.getMonth(); // 0始まり

  let totalUsd = 0;
  let totalJpy = 0;
  const byModel = {}; // モデル別のUSD合計

  for (const row of values) {
    const date = row[0];
    if (!(date instanceof Date)) continue;
    if (date.getFullYear() !== y || date.getMonth() !== m) continue;

    const model = row[1];
    const usd = Number(row[4]) || 0;
    const jpy = Number(row[5]) || 0;
    totalUsd += usd;
    totalJpy += jpy;
    byModel[model] = (byModel[model] || 0) + usd;
  }

  Logger.log("今月の合計: $" + totalUsd.toFixed(2) + " / 約" + Math.round(totalJpy) + "円");
  Object.keys(byModel).forEach((model) => {
    Logger.log("  " + model + ": $" + byModel[model].toFixed(2));
  });

  return { totalUsd: totalUsd, totalJpy: totalJpy, byModel: byModel };
}

// 予算のしきい値を超えたらメールで通知する。
// 時間主導トリガー（毎日1回）で回しておくと、
// 月末の請求前に気づける。
const MONTHLY_BUDGET_USD = 20; // 月の予算（ドル）

function checkBudget() {
  const summary = summarizeThisMonth();
  const ratio = summary.totalUsd / MONTHLY_BUDGET_USD;

  // 予算の8割を超えたら通知
  if (ratio >= 0.8) {
    const to = Session.getActiveUser().getEmail();
    const subject = "[Claude API] 今月の利用が予算の" + Math.round(ratio * 100) + "%に到達";
    const body =
      "今月のClaude API利用状況\n" +
      "合計: $" + summary.totalUsd.toFixed(2) +
      " / 約" + Math.round(summary.totalJpy) + "円\n" +
      "予算: $" + MONTHLY_BUDGET_USD + "\n";
    MailApp.sendEmail(to, subject, body);
  }
}