0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【Claude Codeで会社を回す #9】Claudeを動かす前に、データを"凍らせる"

0
Posted at

連載『Claude Codeで会社を回す』#9 ── 一人会社が Claude Code で回す AI役員チームの実録。人間(@noracorn)がレビューして公開しています。

前回(#8)で、Claude が2回、ありもしない数字を作った話を書いた。だから今は「数字は機械が出す、Claude は所見だけ足す」という役割分担にしている。

今回はその一歩手前の話だ。機械が数字を出すにしても、その"入力"が毎回違っていたら、Claude が捏造しなくても結果はブレる。 月初に勝手に動く財務締めを作って、私はそこで足をすくわれた。

「先月と同じ計算」のはずなのに、数字が合わない

私は月次のキャッシュフロー締めを、毎月5日の朝に自動で走らせている。人間が叩くんじゃなく、スケジューラが Claude を非対話モード(claude --print)で起動して、前月の売上・入金・未着金をまとめてダッシュボードにする。寝てる間に終わってる。便利だ。

最初の作りはシンプルだった。起動した Claude が、その場で案件管理ツールのAPIを叩いて、最新のデータを取ってきて、集計する。素直な発想だと思う。

ところが、検証で詰まった。出てきた数字がおかしい気がして、もう一回同じジョブを走らせた。すると、さっきと微妙に違う数字が出た。

理由はすぐ分かった。1回目と2回目の間に、案件管理ツール側のデータが更新されていたから。請求のステータスが1件動いた。それだけで合計が変わる。当たり前だ。APIは「今この瞬間の事実」を返すんだから、叩くたびに違うのは正しい挙動だ。

でも、これは困る。「先月の締め」という、本来は確定しているはずの数字が、実行のたびに動く。 検証しようにも、検証中に入力が変わるから、何を見ているのか分からなくなる。再現できないものは、検証できない。

AIが嘘をつくより前に、入力が動いていた

#8 で問題にしたのは「Claude が数字を捏造する」ことだった。それは Claude を疑う話だ。

今回のはもっと地味で、もっと根が深い。Claude が一切間違えなくても、入力が実行ごとに違えば、出力は再現しない。 これはAIの賢さの問題じゃない。データの扱い方の問題だ。

非対話で定期実行するAIには、対話のときには無かった制約がつく。対話なら「あれ、さっきと数字違うね」と人間がその場で気づける。自動実行は誰も見ていない。ズレに気づく人間がいないまま、毎回ちょっと違う"正解"が量産される。

人間の経理ならどうするか、と考えた。月初に締めるとき、月末時点の残高や請求一覧を紙やCSVに一回落とす。そこから先、台帳がどう動こうと、締めはその落とした断面を正本にする。後から動いた分は翌月に回す。

それだ、と思った。Claudeを動かす前に、データを一回"凍らせる"。

凍結 = 生の事実を、日付付きのファイルに固める

やったことは単純だ。月次ジョブの先頭で、Claudeを起動するより前に、別のプログラム(私は Python にした)が案件管理ツールのデータを全件取ってきて、1個のファイルに丸ごと保存する。これを「スナップショット(snapshot)」と呼んでいる。

凍結するときのルールを2つだけ決めた。

  1. 生の事実だけを入れる。 係数を掛けない、確率を当てない、行を間引かない。ツールが「事実として持っているもの」をそのまま固める。解釈はあとでやる。
  2. いつ取ったかを必ず刻む。 対象月と、実際に取得した時刻を一緒に書く。あとで「これはいつの断面か」が一目で分かるように。

ファイルの中身は、ざっくりこんな形だ(金額・案件番号はダミー)。

{
  "snapshot_date": "2026-05-31",
  "fetched_at": "2026-06-05T00:12:30+00:00",
  "invoices_count": 1234,
  "projects_count": 643,
  "truncated": false,
  "invoices": [
    { "project_no": "NNNN", "order_status": 5, "invoice_status": 3, "total": "X,XXX,XXX" }
  ],
  "projects": [
    { "project_no": "NNNN", "client": "[顧客A]", "order_status": 5 }
  ]
}

ポイントは fetched_at と truncated だ。

fetched_at は「この断面はいつのものか」。これが入っているだけで、後から見たときに「ああ、5日の朝に凍らせた月末断面ね」と即分かる。

truncated(打ち切られたか)は、全件ちゃんと取れたかの旗だ。APIはページ単位で返してくるので、安全弁として最大ページ数を決めてある。万一そこまで取っても終端に届かなかったら、件数が欠けている=合計を過小評価しているかもしれない。だから「全部取り切れたか?」という旗を、凍結データ自身に持たせた。凍結したデータが、自分の信頼度も一緒に申告する。

凍らせたら、もう触らない。Claudeはそれを"読むだけ"

凍結ファイルができたら、あとは流れに乗せるだけだ。

大事なのは順番だ。凍結(C)が、Claude 起動(E)より必ず前にある。 Claude が動き出した時点で、入力はもう固まっている。だから同じ凍結ファイルを食わせれば、Claude が何回走っても同じ数字を相手にできる。検証中に足元が動かない。

そして Claude の仕事は、データを取りに行くことでも、合計を出すことでもない。凍ったデータを正本として読み、機械が出した数字が妥当かを検証し、人間の文脈で所見を足す。 それだけ。役割を、こうハッキリ分けた。

擬似コードにするとこんな感じだ。

# --- Claude を起動する「前」の仕事(機械の領域) ---
if refresh:                      # 月初の本実行
    snap = fetch_all_from_api()  # 全件ライブ取得
    save(snap, "2026-05-31-board.json")   # 凍結保存(fetched_at を刻む)
else:                            # 検証・再実行
    snap = load("2026-05-31-board.json")  # 凍らせた断面を読むだけ
                                          # ← APIは叩かない=入力不変=再現する

# --- ここから先で初めて Claude が動く ---
# Claude は snap(凍結正本)を読み、数字を検証し、所見を足すだけ

refresh という旗で「凍らせる実行」と「凍ったものを読む実行」を分けてある。月初の本番は前者で1回だけ凍らせる。あとの検証や再実行は全部後者=既に凍ったファイルを読むだけだから、何度やっても入力が動かない。再現性は、賢いプロンプトじゃなく、この分岐ひとつで担保される。

凍結が"失敗"したときに、黙って嘘をつかせない

もうひとつ、外せなかった配慮がある。凍らせる作業そのものが失敗したらどうするか。

API側が落ちている、ネットワークが切れている。月初の本実行で新しい断面を取れないことは、当然ありうる。そのとき何も考えずに止まると、締めが穴あきになる。かといって、空っぽのデータで突き進むと、それこそ事故だ。

だから「取得に失敗したら、前回の凍結データで継続する」という退避を入れた。先月の断面で一旦走らせて、締め自体は止めない。

ただし、ここがキモなんだけど、その場合は「これは古い断面で走ってます」という旗を立てる。 私の仕組みでは fallback(退避した)という旗で、それが立っていたら Claude はレポートのいちばん先頭に⚠を出して「当月の変動が反映されていない・要再実行」と最優先で書くように決めてある。

ここを握り潰すと最悪だ。古い断面で出した数字が、何事もなかった顔でメールに乗る。#8 で痛い目を見た「もっともらしい嘘」と、構造はまったく同じだ。だから、退避したことは隠さない。データが古いなら、古いと先頭で白状させる。(#3 で書いた「鮮度を先頭に出す」のと、根は同じ思想だ。)

真似するときの最小形

外部のデータを使ってAIを定期実行するなら、賢いモデルを選ぶより先に、これだけやっておくと足元が固まる。

  1. AIを起動する前に、入力データを一度ファイルに固める。 APIでもDBでもいい。「実行ごとに動くもの」を、その実行のあいだ動かないものに変える。
  2. 固めた断面に「いつ取ったか」を刻む。 後から「これはいつの状態か」が分からない凍結は、半分意味がない。
  3. 凍らせる実行と、凍ったものを読む実行を分ける。 本番は凍らせる、検証は読むだけ。再現性はここで生まれる。
  4. 凍結に失敗したら、それを旗として立てて、出力の先頭で白状させる。 古い断面で走ったことを隠さない。

ポイントは、AIにデータ取得を任せないこと。「最新の数字を見て判断して」とAIに丸投げすると、見るたびに違う最新を相手に、違う判断を返す。そうじゃなく、何を見るかは機械が固定して、AIには固定された断面だけを渡す。 取得は機械の仕事、判断はAIの仕事。混ぜない。(このへんの線引きは #3 とまったく同じで、私は何度も同じ教訓に戻ってくる。)

まとめ:再現できない締めは、締めじゃない

AIに月次の財務締めを任せると決めたとき、一番効いた工夫は、賢いプロンプトでも高性能モデルでもなかった。Claudeを動かす前に、データを一回凍らせることだった。

凍らせれば、同じ入力から同じ出力が出る。出力が再現するから、検証できる。検証できるから、人間が安心して承認できる。逆に言うと、実行のたびに入力が動く締めは、どれだけAIが賢くても、検証も承認もできない。

#8 では「AIに数字を作らせない」話をした。今回はその前提として「AIに渡す数字を、実行のあいだ動かさない」話だった。捏造を防ぐより前に、入力を凍らせる。 Claudeが口を開くより先に、データを固めておく。


寝てる間に走るジョブほど、足元を固めておかないと怖い。誰も見ていない時間に、毎回ちょっと違う"正解"が静かに増えていく。だからまず凍らせる。 Claudeに考えさせるのは、そのあとでいい。

この記事について

これは一人会社(合同会社)を Claude Code の AI役員チームで回している実録連載 Season2(数字編)の #9 です。実在の金額・案件・顧客名はすべてダミーに置き換えています。仕組みは私(@noracorn)が実際に運用し、レビューのうえ公開しています。

  • 前回 #8: Claudeは2回、ありもしない数字を作った
  • 次回 #10 は、AIに見せる設定と、AIから隠す設定を分ける――「Claudeに見せる設定と、隠す設定を分ける」話です。

この記事について

arecore.net の中の人が運用する AI 役員チームの実践記録です。受託開発・SES・自社プロダクト開発をやっています。ご相談・フィードバックは arecore.net からどうぞ。

0
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?