ClaudeのJSON出力を業務で使う：形式の正しさと意味の正しさを分ける

ローカルで再現する：JSONの構文と請求額の意味を分ける

架空の請求額に対して、合計一致、不一致、通貨欠落、文字列の金額を実際に検査します。JSONの構文が通るだけでは、業務条件は保証されません。

以下は公開コードを実行して得た結果です。入力は学習用に作った架空データで、Claude API・外部サービスへの通信は行っていません。モデルの回答品質や実サービスの性能を測定した結果ではありません。

実行：2026-11-03T15:20:36.412Z
Node.js v24.22.1 · darwin/arm64 · 4ケース

再現の手順

1. 実行コードを保存する（.mjs）
2. Node.js 20以上の環境で、保存したフォルダから次のコマンドを実行します。追加パッケージやAPIキーは不要です。
3. 出力の各ケースを読み、入力を一つ変えて判断の違いを確かめてください。

node claude-json-semantic-validation.mjs

実際の入力と出力

{
  "cases": [
    {
      "name": "金額と合計が一致",
      "input": {
        "currency": "JPY",
        "lines": [
          1000,
          500
        ],
        "total": 1500
      },
      "expected": "accepted",
      "actual": "accepted",
      "pass": true
    },
    {
      "name": "JSONは正しいが合計が不一致",
      "input": {
        "currency": "JPY",
        "lines": [
          1000,
          500
        ],
        "total": 1700
      },
      "expected": "sum_mismatch",
      "actual": "sum_mismatch",
      "pass": true
    },
    {
      "name": "通貨が欠落",
      "input": {
        "lines": [
          1000,
          500
        ],
        "total": 1500
      },
      "expected": "currency_required",
      "actual": "currency_required",
      "pass": true
    },
    {
      "name": "文字列の金額を暗黙変換しない",
      "input": {
        "currency": "JPY",
        "lines": [
          1000,
          "500"
        ],
        "total": 1500
      },
      "expected": "invalid_amount",
      "actual": "invalid_amount",
      "pass": true
    }
  ]
}

// Learnify local experiment. Fictional invoice values; no model call.
export function validateInvoice(value) {
  if(!value||typeof value!=='object'||Array.isArray(value))return 'invalid_object';
  if(value.currency!=='JPY')return 'currency_required';
  if(!Array.isArray(value.lines)||value.lines.length===0)return 'lines_required';
  if(!Number.isSafeInteger(value.total)||value.total<0||value.lines.some(n=>!Number.isSafeInteger(n)||n<0))return 'invalid_amount';
  const sum=value.lines.reduce((n,v)=>n+v,0);
  if(!Number.isSafeInteger(sum)||sum!==value.total)return 'sum_mismatch';
  return 'accepted';
}
export function run() {
  const fixtures=[
    {name:'金額と合計が一致',input:{currency:'JPY',lines:[1000,500],total:1500},expected:'accepted'},
    {name:'JSONは正しいが合計が不一致',input:{currency:'JPY',lines:[1000,500],total:1700},expected:'sum_mismatch'},
    {name:'通貨が欠落',input:{lines:[1000,500],total:1500},expected:'currency_required'},
    {name:'文字列の金額を暗黙変換しない',input:{currency:'JPY',lines:[1000,'500'],total:1500},expected:'invalid_amount'},
  ];
  return {cases:fixtures.map(c=>{const actual=validateInvoice(c.input);return {...c,actual,pass:actual===c.expected};})};
}
if(typeof process!=='undefined'&&process.argv?.[1]&&import.meta.url===new URL('file://'+process.argv[1]).href)console.log(JSON.stringify(run(),null,2));

コードのSHA-256：f43fd2a5a9d76336a5d0c0745a69125357bc869868f0d70c5aab6809a1fd482e

5実験の実行記録を保存する（JSON）

この検証で分かる範囲

この検査は円建ての非負整数と加算だけです。税計算、為替、丸め、実際の請求書の正しさ、モデルによる抽出精度を検証したものではありません。