积分变动对不上?用Claude Code写对账并列出差异
会员积分增减与订单、退货记录对不上时,客服只能逐条翻流水,差异原因说不清。本文用 Claude Code 写对账校验并列出差异,调账前仍由业务负责人确认。

适用范围与准备材料
适合会员或电商运营中,要用两份脱敏明细核对应付积分和实记账积分的技术或运营人员。需要能够按 Claude Code 官方文档在本机或已批准环境中运行,并限制它只读样本数据。
不适合没有可核对的流水、把客服口头承诺当成已入账积分,或希望脚本不经确认就直接改生产积分账的情况。
准备时先使用自制、脱敏的订单明细和积分流水,去掉真实手机号和完整账号。指定审核人,并写清停止条件:脚本不得连接生产写权限,差异不得自动调账。先确认当前环境如何启动 Claude Code,以及仓库或目录的访问范围。
产品功能可能随版本、地区、套餐和账号权限变化,以实际界面与官方说明为准。
详细实施步骤
步骤 1
在隔离目录中开始一次只读对账任务,不要指向生产数据库。打开 Claude Code,说明要用两份本地脱敏表生成差异列表,并禁止任何更新语句。
输入示例:任务说明「会员积分对账(脱敏样例)。输入:orders.csv 与 points.csv。只生成差异报告,不修改源文件,不连接生产库。」
预期输出:工作目录和禁止项已写明。
检查点:可见输入是本地样本文件,而不是生产连接串。
若环境或权限不清楚,先对照官方文档和实际界面,不要把任务指到正式库。
步骤 2
约定对账键和规则:例如订单号+变动类型,积分增加应能对到已完成订单,退货应能对到扣回。无法匹配的进入未匹配清单。
输入示例:「规则:用order_id对齐;completed订单应有对应earn记录;refunded订单应有对应clawback;金额或积分数不一致列入差异;缺键或重复键单独列出。输出CSV和简要说明。」
预期输出:规则已写入任务。
检查点:匹配键和差异类型定义清楚。
若字段名与实际表头不符,先改规则再写脚本,不要猜测列名。
步骤 3
让 Claude Code 编写并在本地运行校验脚本,检查输出是否覆盖重复键、缺记录和数值不一致。运行后核对源文件未被改动。
输入示例:「请编写可重复运行的对账脚本并在本目录执行。先用我提供的3类样本:正常、退货未扣回、重复入账。输出differences.csv。」
预期输出:脚本运行完成,差异文件包含预期的三类问题中已放入的样本。
检查点:源CSV未被修改;报告可打开。
若脚本失败或改写了源文件,停止使用,恢复样本并收窄权限后再试。
步骤 4
抽查差异报告中的若干行,人工对照原始两表。把误报和规则漏洞记下来,再让 Claude Code 只改校验逻辑,不改数据。
输入示例:抽查记录:「差异行04(退货未扣回)属实;行09因日期时区被误报,需在规则中统一日期口径。」
预期输出:抽查记录和待修改规则。
检查点:误报被识别,没有直接拿去调账。
若抽查发现大量错位,先停止扩大数据量,修正规则后再跑。
步骤 5
业务负责人确认差异分类后,再走正式调账或补记流程。调账在业务系统中完成,不由对账脚本执行。保存脚本版本、输入文件版本和报告日期。
输入示例:审核记录(脱敏样例):「审核人:会员运营N;日期:2026-11-14。退货未扣回3笔进入人工调账单;时区误报已排除;脚本不得对生产执行更新。」
预期输出:已确认的差异清单和调账流转记录。
检查点:任何调账都能回溯到报告行和审核记录。
若源数据稍后重导,应重跑对账,不得继续使用旧差异单直接调账。
结果验收
- 对账脚本在隔离目录只读运行,源文件和生产数据未被脚本修改。
- 差异报告能区分未匹配、数值不一致和规则待确认。
- 抽查后才进入业务调账流程。
- 脚本版本与输入文件版本可追溯。
用含正常、退货未扣回和重复入账的脱敏样本运行:报告应命中后两类,且两个源文件内容保持不变。
常见问题与边界
常见问题是看到差异就在生产后台手工改积分,却不留下对应报告行。界限是:先有审核通过的差异分类,再走调账单。另一问题是把 Claude Code 的目录指到正式环境,发现后应立即停止并改回样本目录。
下一步
主要入口:查看自动化流程栏目的同类实施方法。
相关文章:报名表字段错位?用Claude Code写校验并列出回归项。
官方资料:Claude Code官方文档。本文为实施方法,不代表具体账号已开放全部功能;配图为AI生成主题封面。