Claude Code辅助遗留系统重构：可行性评估、小步落地与多仓WMS整合建议

Claude Code辅助遗留系统重构：可行性评估、小步落地与多仓WMS整合建议

摘要：遗留系统“不敢动、看不懂、改得慢”的根因不是“代码老”，而是规则不可追溯、测试缺失、接口债务深。Claude Code 在这类场景中真正解决的是“读代码、抽规则、补测试、出适配器、做局部重构”的工程成本，不替代架构决策与业务签核。本文按实操文标准组织：给出可行性五维评分卡、可直接复制的 CLAUDE.md 与特征测试、2–4周试点甘特图、多仓WMS异构整合方案、风险与成本口径、FAQs。文中示例数据明确标注“演示口径”，请勿作为真实业务承诺。

一、先解决最大疑问：Claude Code 真能“救”几十年老系统吗

不能把“救”理解为“整库翻译一遍就上线”。真正的遗留系统难点往往不是语法老，而是下面三座大山：

• 规则不可追溯：折扣、税额、批次、库位分配、波次策略、历史回退散在存储过程、定时任务、配置文件和线下Excel里。
• 没有安全网：测试覆盖率极低，改一行不知道炸断哪条链路。
• 接口与数据债深：主数据重复、库存口径不一、系统间用FTP/SOAP/直连库点对点连接。

Claude Code 的价值，业界实践和官方资料都集中在“代码理解与增量现代化”：依赖图、死代码识别、补测试、生成文档、小步重构、老接口包适配器。大规模语言/框架迁移还会先建“规则书 → 依赖顺序 → 差异清单”，再用“实现→评审→修复”循环做行为对拍，而不是单独模型逐文件盲翻。

因此，更严谨的定位是：

一句话结论：
Claude Code 解决老系统的“看不懂、不敢动、改得慢”；不解决“业务说不清、数据对不上、组织不配合”。

二、可行性评估：五维评分卡，拒绝拍脑袋

不要问“整个系统能不能改”，要问“哪个域适合先用 Claude Code 改”。

2.1 五维评分表

2.2 评分法

总分15分。≥11分可启动2–4周试点；8–10分先做规则抽取和业务访谈；≤7分暂停，先补数据治理或测试基线。

示例评估一个入库模块：

三、小步落地流水线：只读→规则→测试→重构→对拍→灰度

3.1 实验环境与版本

为避免读者“版本对不上”，这里给一个实际可执行的口径：

操作系统：Ubuntu 22.04 LTS / macOS 14
Claude Code：v2.x 命令行版（以官方最新发布为准）
模型：Claude Opus 4.5 用于跨模块架构分析；Claude Sonnet 4.5 用于子域规则抽取与代码生成
被测老系统：
– WMS-A：VB6 + SQL Server 2014，可沙箱还原
– WMS-B：Java 8 + Oracle 11g，Maven 构建
安全模式：私有API代理，所有文件路径和业务规则输出保留，PII字段脱敏

3.2 环境隔离与 CLAUDE.md

• 全量源码、库结构、DTS/ETL、定时任务拉入隔离环境。
• 禁止连接生产库；生产数据导出后脱敏。
• 创建 .claudeignore，排除依赖目录、构建产物、日志、大二进制。

根级 CLAUDE.md 示例（可直接复制使用）：

# CLAUDE.md（遗留WMS重构试点）

## 技术栈
– 老系统A：VB6 + SQL Server 2014，构建与本地运行见 docs/build-a.md
– 老系统B：Java 8 + Oracle 11g，mvn test -pl inbound 跑入库域
– 老系统C：SaaS导出Excel，原始样本在 data/c-sample/，仅用于规则对照

## 红线
– 不修改生产配置、不直连生产库、不自动执行库存写操作
– 所有业务规则输出必须带 file:line；无源码出处的写 UNVERIFIED
– 核心库存扣减、财务对账、税规则仅做分析，不自动重构

## 子域契约
– 入库域：收货/质检/上架/库位分配；规则源在 src/inbound 与 sp_inbound_* 存储过程
– 库存域：可用量=在库-锁定-质检占用-残损；各老系统口径映射见 docs/stock-mapping.md
– 接口域：优先生成只读适配器与DTO，不直接改老系统业务表

## 测试要求
– 先写特征测试锁定当前行为；行为差异超阈值人工复核
– 任何重构PR必须附：依赖影响范围、规则溯源表、测试结果

3.3 只读分析与运行实录

建议按子域启动，不要一个会话分析全库。提示词示例：

只读取 src/inbound 与数据库存储过程 sp_inbound_*，输出：
1. 模块职责与对外调用关系；
2. 入库校验、质检判定、库位分配的业务规则，每条标注 file:line；
3. 死代码、重复逻辑、超高复杂度函数；
4. 无测试覆盖且被多处调用的高风险函数清单。
不要修改任何文件。

执行命令与输出（脱敏示意）：

$ claude -p "分析 src/inbound 下所有存储过程，输出规则溯源表" –output-format json > rules_inbound.json
$ head -20 rules_inbound.json

{
"rule_id": "R-001",
"rule": "到货数量小于0时置为0并标记异常",
"source": "src/inbound/sp_inbound_validate.sql:42",
"confidence": "confirmed",
"verification_status": "TO_BE_REVIEWED"
},
{
"rule_id": "R-002",
"rule": "当仓类型为冷库时，质检等待时间=30分钟",
"source": "src/inbound/sp_inbound_quality.sql:88",
"confidence": "unverified",
"verification_status": "UNVERIFIED"
}

3.4 特征测试：先锁行为，再谈正确

推荐 characterization test，只记录“当前行为”，不急着断言“应该怎样”。哪怕老逻辑存在已知bug，也先锁住，避免重构后“悄悄变正确”反而引发业务事故。

Python 示例：

# test_inbound_allocation_char.py
# CHARACTERIZATION: 锁定老系统当前库位分配行为，日期 2026-09-18
def test_allocation_by_zone_current(old_alloc_service, sample_order):
result = old_alloc_service.allocate(sample_order)
# 预期值来自老库存储过程 sp_allocate 实测，不按新规则改
assert result.zone == "A"
assert result.priority == 1
assert len(result.line_items) == 3

def test_allocation_when_quantity_zero(old_alloc_service):
order = make_order(qty=0)
result = old_alloc_service.allocate(order)
# 老系统历史行为：返回默认区但不生成上架任务
assert result.zone == "DEFAULT"
assert result.tasks == []

Java 版可用 JUnit 锁存储过程结果；无自动化测试的老项目，可让 Claude 生成对拍脚本：同一输入分别调老函数与新实现，diff 输出。

3.5 局部重构与翻译草稿

只选低危、边界清晰、可回滚模块，例如：

• 文件/报文格式转换；
• 入库参数校验，波次过滤条件；
• 老接口 DTO 转标准事件；
• 报表 SQL 重构；
• 单个 God class 拆分为多个有明确职责的类。

Claude 出 diff → 人工 review → 单测 → 集成测试 → 行为对拍。跨语言端口时先建“规则书”：

命名：类名PascalCase，方法camelCase，常量UPPER_SNAKE
金额：统一用decimal，精度4位，禁止double
时间：统一UTC存储，展示用+08:00
null：Optional显式处理，不隐式吞null
异常：老系统错误码映射为新的BusinessException码

关键提醒：“编译通过”不等于“行为正确”。每种行为差异必须有测试或对拍脚本覆盖，不允许仅靠“转译后看起来没问题”上线。

3.6 绞杀者迁移，不大爆炸

老系统继续跑核心，外围用适配器包一层标准API/消息；新服务经适配器调用，逐步把能力外移。

#mermaid-svg-tXMFTmHVapOtwP7g{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-tXMFTmHVapOtwP7g .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-tXMFTmHVapOtwP7g .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-tXMFTmHVapOtwP7g .error-icon{fill:#552222;}#mermaid-svg-tXMFTmHVapOtwP7g .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-tXMFTmHVapOtwP7g .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-tXMFTmHVapOtwP7g .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-tXMFTmHVapOtwP7g .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-tXMFTmHVapOtwP7g .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-tXMFTmHVapOtwP7g .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-tXMFTmHVapOtwP7g .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-tXMFTmHVapOtwP7g .marker{fill:#333333;stroke:#333333;}#mermaid-svg-tXMFTmHVapOtwP7g .marker.cross{stroke:#333333;}#mermaid-svg-tXMFTmHVapOtwP7g svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-tXMFTmHVapOtwP7g p{margin:0;}#mermaid-svg-tXMFTmHVapOtwP7g .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-tXMFTmHVapOtwP7g .cluster-label text{fill:#333;}#mermaid-svg-tXMFTmHVapOtwP7g .cluster-label span{color:#333;}#mermaid-svg-tXMFTmHVapOtwP7g .cluster-label span p{background-color:transparent;}#mermaid-svg-tXMFTmHVapOtwP7g .label text,#mermaid-svg-tXMFTmHVapOtwP7g span{fill:#333;color:#333;}#mermaid-svg-tXMFTmHVapOtwP7g .node rect,#mermaid-svg-tXMFTmHVapOtwP7g .node circle,#mermaid-svg-tXMFTmHVapOtwP7g .node ellipse,#mermaid-svg-tXMFTmHVapOtwP7g .node polygon,#mermaid-svg-tXMFTmHVapOtwP7g .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-tXMFTmHVapOtwP7g .rough-node .label text,#mermaid-svg-tXMFTmHVapOtwP7g .node .label text,#mermaid-svg-tXMFTmHVapOtwP7g .image-shape .label,#mermaid-svg-tXMFTmHVapOtwP7g .icon-shape .label{text-anchor:middle;}#mermaid-svg-tXMFTmHVapOtwP7g .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-tXMFTmHVapOtwP7g .rough-node .label,#mermaid-svg-tXMFTmHVapOtwP7g .node .label,#mermaid-svg-tXMFTmHVapOtwP7g .image-shape .label,#mermaid-svg-tXMFTmHVapOtwP7g .icon-shape .label{text-align:center;}#mermaid-svg-tXMFTmHVapOtwP7g .node.clickable{cursor:pointer;}#mermaid-svg-tXMFTmHVapOtwP7g .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-tXMFTmHVapOtwP7g .arrowheadPath{fill:#333333;}#mermaid-svg-tXMFTmHVapOtwP7g .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-tXMFTmHVapOtwP7g .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-tXMFTmHVapOtwP7g .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-tXMFTmHVapOtwP7g .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-tXMFTmHVapOtwP7g .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-tXMFTmHVapOtwP7g .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-tXMFTmHVapOtwP7g .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-tXMFTmHVapOtwP7g .cluster text{fill:#333;}#mermaid-svg-tXMFTmHVapOtwP7g .cluster span{color:#333;}#mermaid-svg-tXMFTmHVapOtwP7g div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-tXMFTmHVapOtwP7g .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-tXMFTmHVapOtwP7g rect.text{fill:none;stroke-width:0;}#mermaid-svg-tXMFTmHVapOtwP7g .icon-shape,#mermaid-svg-tXMFTmHVapOtwP7g .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-tXMFTmHVapOtwP7g .icon-shape p,#mermaid-svg-tXMFTmHVapOtwP7g .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-tXMFTmHVapOtwP7g .icon-shape .label rect,#mermaid-svg-tXMFTmHVapOtwP7g .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-tXMFTmHVapOtwP7g .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-tXMFTmHVapOtwP7g .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-tXMFTmHVapOtwP7g :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

老WMS A VB6/SQL

适配器/API网关

老WMS B Java/Oracle

老仓Excel/RF/SP

标准库存事件层 Kafka

新入库/上架/波次服务

全局库存视图/对账

业务看板/OMS/ERP

原则：先接口后内核，先只读后写回，先单域后全量。

3.7 对拍、影子、灰度

四、多仓WMS整合建议：先治理数据和接口，不先统一内核

以下为中性假设场景，不涉及具体企业名称和“全省数百仓”等无来源数据。

假设某省级流通/国资仓储体系，多个地市仓过去分别建设WMS：

4.1 主数据先行，接口其次

多仓整合最容易翻车的地方不是接口，而是主数据不一致。建议：

• 建立全局 MDM/主数据层：master_sku、仓库ID、包装层级、单位、批次规则、库存状态枚举。
• 各老WMS保留本地SKU，中台维护“本地SKU → master_sku”映射表。
• 权威来源原则：商品档案以ERP/PIM为主；库位/库区以本地WMS为主；承运商以OMS/TMS为主。

4.2 统一库存口径，而不是强制覆盖

不同老系统“可用量”定义可能不同。先定义标准库存事件：

{
"event_id": "evt_20260918_001",
"event_type": "inbound.received",
"warehouse_id": "WH001",
"master_sku": "SKU-10001",
"qty": 120,
"uom": "PCS",
"batch_no": "B20260918-01",
"location": "A-01-02",
"source_system": "WMS-A",
"occurred_at": "2026-09-18T09:30:00+08:00",
"trace_id": "trace-8f7d"
}

库存状态公式由业务统一约定，例如：

available = on_hand – locked – quality_hold – damaged – other_reserved

是否计入在途按业务域分开，不要一刀切。

4.3 异构接入：按实时性选型

4.4 Claude Code 在多仓整合中的限定用法

不要让它直接改生产库存。用它做：

提示词模板：

读取 WMS-A 的 sp_inbound_validate、sp_allocate 与 WMS-B 的 InboundService.java，
抽取收货校验和库位分配规则。输出：
1. 两仓规则差异表；
2. 每条规则标注源系统、对象、file:line；
3. 生成标准事件 inbound.received / inbound.putaway 的字段映射；
4. 对无法从代码确认的规则标注 UNVERIFIED，并列出需业务确认的问题。
不修改生产代码，不假设默认业务规则。

4.5 切流顺序与KPI

#mermaid-svg-nltn7FJr10VaoDmh{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-nltn7FJr10VaoDmh .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-nltn7FJr10VaoDmh .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-nltn7FJr10VaoDmh .error-icon{fill:#552222;}#mermaid-svg-nltn7FJr10VaoDmh .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-nltn7FJr10VaoDmh .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-nltn7FJr10VaoDmh .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-nltn7FJr10VaoDmh .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-nltn7FJr10VaoDmh .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-nltn7FJr10VaoDmh .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-nltn7FJr10VaoDmh .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-nltn7FJr10VaoDmh .marker{fill:#333333;stroke:#333333;}#mermaid-svg-nltn7FJr10VaoDmh .marker.cross{stroke:#333333;}#mermaid-svg-nltn7FJr10VaoDmh svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-nltn7FJr10VaoDmh p{margin:0;}#mermaid-svg-nltn7FJr10VaoDmh .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-nltn7FJr10VaoDmh .cluster-label text{fill:#333;}#mermaid-svg-nltn7FJr10VaoDmh .cluster-label span{color:#333;}#mermaid-svg-nltn7FJr10VaoDmh .cluster-label span p{background-color:transparent;}#mermaid-svg-nltn7FJr10VaoDmh .label text,#mermaid-svg-nltn7FJr10VaoDmh span{fill:#333;color:#333;}#mermaid-svg-nltn7FJr10VaoDmh .node rect,#mermaid-svg-nltn7FJr10VaoDmh .node circle,#mermaid-svg-nltn7FJr10VaoDmh .node ellipse,#mermaid-svg-nltn7FJr10VaoDmh .node polygon,#mermaid-svg-nltn7FJr10VaoDmh .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-nltn7FJr10VaoDmh .rough-node .label text,#mermaid-svg-nltn7FJr10VaoDmh .node .label text,#mermaid-svg-nltn7FJr10VaoDmh .image-shape .label,#mermaid-svg-nltn7FJr10VaoDmh .icon-shape .label{text-anchor:middle;}#mermaid-svg-nltn7FJr10VaoDmh .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-nltn7FJr10VaoDmh .rough-node .label,#mermaid-svg-nltn7FJr10VaoDmh .node .label,#mermaid-svg-nltn7FJr10VaoDmh .image-shape .label,#mermaid-svg-nltn7FJr10VaoDmh .icon-shape .label{text-align:center;}#mermaid-svg-nltn7FJr10VaoDmh .node.clickable{cursor:pointer;}#mermaid-svg-nltn7FJr10VaoDmh .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-nltn7FJr10VaoDmh .arrowheadPath{fill:#333333;}#mermaid-svg-nltn7FJr10VaoDmh .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-nltn7FJr10VaoDmh .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-nltn7FJr10VaoDmh .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-nltn7FJr10VaoDmh .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-nltn7FJr10VaoDmh .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-nltn7FJr10VaoDmh .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-nltn7FJr10VaoDmh .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-nltn7FJr10VaoDmh .cluster text{fill:#333;}#mermaid-svg-nltn7FJr10VaoDmh .cluster span{color:#333;}#mermaid-svg-nltn7FJr10VaoDmh div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-nltn7FJr10VaoDmh .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-nltn7FJr10VaoDmh rect.text{fill:none;stroke-width:0;}#mermaid-svg-nltn7FJr10VaoDmh .icon-shape,#mermaid-svg-nltn7FJr10VaoDmh .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-nltn7FJr10VaoDmh .icon-shape p,#mermaid-svg-nltn7FJr10VaoDmh .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-nltn7FJr10VaoDmh .icon-shape .label rect,#mermaid-svg-nltn7FJr10VaoDmh .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-nltn7FJr10VaoDmh .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-nltn7FJr10VaoDmh .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-nltn7FJr10VaoDmh :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

单仓影子同步

单仓低动销客户双写

差异率稳定后切外围

高动销大仓最后切

核心财务/税务对账始终并行

KPI建议：

• 主数据匹配率、重复SKU清理数；
• 库存对账差异率、接口失败率、消息重放成功率；
• 规则溯源覆盖率、特征测试通过率；
• 单域回滚时长、人工复核工时下降比例。

五、风险与合规：把幻觉拦在合并之前

六、成本测算：预算模板与止损线

止损线示例：

• 某域对拍差异率 > 1%，暂停并回溯；
• 特征测试覆盖率提升不足，说明测试基建优先级应高于重构；
• 人工复核工时超过AI节省工时的2倍，重新评估该域ROI。

七、2–4周试点计划与效果评估

7.1 试点甘特图

#mermaid-svg-dIYkfmZVkl9GLNpa{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-dIYkfmZVkl9GLNpa .error-icon{fill:#552222;}#mermaid-svg-dIYkfmZVkl9GLNpa .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-dIYkfmZVkl9GLNpa .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-dIYkfmZVkl9GLNpa .marker{fill:#333333;stroke:#333333;}#mermaid-svg-dIYkfmZVkl9GLNpa .marker.cross{stroke:#333333;}#mermaid-svg-dIYkfmZVkl9GLNpa svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-dIYkfmZVkl9GLNpa p{margin:0;}#mermaid-svg-dIYkfmZVkl9GLNpa .mermaid-main-font{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}#mermaid-svg-dIYkfmZVkl9GLNpa .exclude-range{fill:#eeeeee;}#mermaid-svg-dIYkfmZVkl9GLNpa .section{stroke:none;opacity:0.2;}#mermaid-svg-dIYkfmZVkl9GLNpa .section0{fill:rgba(102, 102, 255, 0.49);}#mermaid-svg-dIYkfmZVkl9GLNpa .section2{fill:#fff400;}#mermaid-svg-dIYkfmZVkl9GLNpa .section1,#mermaid-svg-dIYkfmZVkl9GLNpa .section3{fill:white;opacity:0.2;}#mermaid-svg-dIYkfmZVkl9GLNpa .sectionTitle0{fill:#333;}#mermaid-svg-dIYkfmZVkl9GLNpa .sectionTitle1{fill:#333;}#mermaid-svg-dIYkfmZVkl9GLNpa .sectionTitle2{fill:#333;}#mermaid-svg-dIYkfmZVkl9GLNpa .sectionTitle3{fill:#333;}#mermaid-svg-dIYkfmZVkl9GLNpa .sectionTitle{text-anchor:start;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}#mermaid-svg-dIYkfmZVkl9GLNpa .grid .tick{stroke:lightgrey;opacity:0.8;shape-rendering:crispEdges;}#mermaid-svg-dIYkfmZVkl9GLNpa .grid .tick text{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;fill:#333;}#mermaid-svg-dIYkfmZVkl9GLNpa .grid path{stroke-width:0;}#mermaid-svg-dIYkfmZVkl9GLNpa .today{fill:none;stroke:red;stroke-width:2px;}#mermaid-svg-dIYkfmZVkl9GLNpa .task{stroke-width:2;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskText{text-anchor:middle;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutsideRight{fill:black;text-anchor:start;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutsideLeft{fill:black;text-anchor:end;}#mermaid-svg-dIYkfmZVkl9GLNpa .task.clickable{cursor:pointer;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskText.clickable{cursor:pointer;fill:#003163!important;font-weight:bold;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutsideLeft.clickable{cursor:pointer;fill:#003163!important;font-weight:bold;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutsideRight.clickable{cursor:pointer;fill:#003163!important;font-weight:bold;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskText0,#mermaid-svg-dIYkfmZVkl9GLNpa .taskText1,#mermaid-svg-dIYkfmZVkl9GLNpa .taskText2,#mermaid-svg-dIYkfmZVkl9GLNpa .taskText3{fill:white;}#mermaid-svg-dIYkfmZVkl9GLNpa .task0,#mermaid-svg-dIYkfmZVkl9GLNpa .task1,#mermaid-svg-dIYkfmZVkl9GLNpa .task2,#mermaid-svg-dIYkfmZVkl9GLNpa .task3{fill:#8a90dd;stroke:#534fbc;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutside0,#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutside2{fill:black;}#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutside1,#mermaid-svg-dIYkfmZVkl9GLNpa .taskTextOutside3{fill:black;}#mermaid-svg-dIYkfmZVkl9GLNpa .active0,#mermaid-svg-dIYkfmZVkl9GLNpa .active1,#mermaid-svg-dIYkfmZVkl9GLNpa .active2,#mermaid-svg-dIYkfmZVkl9GLNpa .active3{fill:#bfc7ff;stroke:#534fbc;}#mermaid-svg-dIYkfmZVkl9GLNpa .activeText0,#mermaid-svg-dIYkfmZVkl9GLNpa .activeText1,#mermaid-svg-dIYkfmZVkl9GLNpa .activeText2,#mermaid-svg-dIYkfmZVkl9GLNpa .activeText3{fill:black!important;}#mermaid-svg-dIYkfmZVkl9GLNpa .done0,#mermaid-svg-dIYkfmZVkl9GLNpa .done1,#mermaid-svg-dIYkfmZVkl9GLNpa .done2,#mermaid-svg-dIYkfmZVkl9GLNpa .done3{stroke:grey;fill:lightgrey;stroke-width:2;}#mermaid-svg-dIYkfmZVkl9GLNpa .doneText0,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText1,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText2,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText3{fill:black!important;}#mermaid-svg-dIYkfmZVkl9GLNpa .doneText0.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText0.taskTextOutsideRight,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText1.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText1.taskTextOutsideRight,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText2.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText2.taskTextOutsideRight,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText3.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneText3.taskTextOutsideRight{fill:black!important;}#mermaid-svg-dIYkfmZVkl9GLNpa .crit0,#mermaid-svg-dIYkfmZVkl9GLNpa .crit1,#mermaid-svg-dIYkfmZVkl9GLNpa .crit2,#mermaid-svg-dIYkfmZVkl9GLNpa .crit3{stroke:#ff8888;fill:red;stroke-width:2;}#mermaid-svg-dIYkfmZVkl9GLNpa .activeCrit0,#mermaid-svg-dIYkfmZVkl9GLNpa .activeCrit1,#mermaid-svg-dIYkfmZVkl9GLNpa .activeCrit2,#mermaid-svg-dIYkfmZVkl9GLNpa .activeCrit3{stroke:#ff8888;fill:#bfc7ff;stroke-width:2;}#mermaid-svg-dIYkfmZVkl9GLNpa .doneCrit0,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCrit1,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCrit2,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCrit3{stroke:#ff8888;fill:lightgrey;stroke-width:2;cursor:pointer;shape-rendering:crispEdges;}#mermaid-svg-dIYkfmZVkl9GLNpa .milestone{transform:rotate(45deg) scale(0.8,0.8);}#mermaid-svg-dIYkfmZVkl9GLNpa .milestoneText{font-style:italic;}#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText0,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText1,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText2,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText3{fill:black!important;}#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText0.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText0.taskTextOutsideRight,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText1.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText1.taskTextOutsideRight,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText2.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText2.taskTextOutsideRight,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText3.taskTextOutsideLeft,#mermaid-svg-dIYkfmZVkl9GLNpa .doneCritText3.taskTextOutsideRight{fill:black!important;}#mermaid-svg-dIYkfmZVkl9GLNpa .vert{stroke:navy;}#mermaid-svg-dIYkfmZVkl9GLNpa .vertText{font-size:15px;text-anchor:middle;fill:navy!important;}#mermaid-svg-dIYkfmZVkl9GLNpa .activeCritText0,#mermaid-svg-dIYkfmZVkl9GLNpa .activeCritText1,#mermaid-svg-dIYkfmZVkl9GLNpa .activeCritText2,#mermaid-svg-dIYkfmZVkl9GLNpa .activeCritText3{fill:black!important;}#mermaid-svg-dIYkfmZVkl9GLNpa .titleText{text-anchor:middle;font-size:18px;fill:#333;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}#mermaid-svg-dIYkfmZVkl9GLNpa :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}2026-09-212026-09-232026-09-252026-09-272026-09-292026-10-012026-10-032026-10-052026-10-072026-10-092026-10-112026-10-132026-10-15隔离环境准备 只读分析与依赖图 规则抽取与业务签核 特征测试编写 小步重构/适配器开发 测试与对拍 影子运行与汇总 决策评审 第1周第2周第3周第4周2-4周Claude Code遗留系统试点

7.2 示例试点效果对比

以下为演示口径，用于说明指标计算方式。实际请以贵司试点自测为准。

使用说明：示例数据不承诺真实企业收益；若试点实际值低于预期，优先检查主数据、测试基线和业务参与度，而不是责怪模型。

八、踩坑实录与 FAQ

Q1：AI 补了一条不存在的规则，怎么办？
A：在提示词中强制要求“每条规则必须返回file:line；无法确认时写 UNVERIFIED”。所有规则表必须经过业务专家签核，才能进入实现阶段。

Q2：上下文超限，全库塞不进去怎么办？
A：按业务子域拆分，每域一个CLAUDE.md和一组代理任务。禁止“一个会话分析全库”的暴力方案。

Q3：老系统没有 CI/CD，能做对拍吗？
A：可以。写独立对拍脚本，从老库和测试库取真实订单/库存事件，分别调新旧实现，diff 输出。没有 CI 也能做，但至少要能自动化运行脚本。

Q4：老系统无法在本地启动，怎么办？
A：优先考虑沙箱还原数据库和相关服务；实在无法启动，就用离线日志、数据库快照和存储过程模拟，把可执行用例限制在纯SQL/纯函数上。

Q5：业务方不配合签核规则，怎么办？
A：不签核就不动。把“规则签核”设为进入实现阶段的硬门槛。可先选一个低危、影响小的模块作为“教育型试点”，让业务看到签核的收益。

Q6：财务/客户数据能用公网 Claude Code 吗？
A：不建议。使用企业版/私有化部署，或先脱敏再分析；所有 AI 改动作保留审计日志。

Q7：老系统改造预算大概多少？
A：没有标准答案。按“试点成本→单域成本→整体成本”逐步测算；可参考第6节成本模板设定止损线。

Q8：什么时候该放弃老系统，直接重买？
A：当业务已淘汰、数据全脏且无人能说清规则、合规要求新系统原生支持、维护成本长期超过替代品成本时，直接换商业SaaS可能更划算。AI辅助重构只适用于“业务还有价值、规则还可追溯”的系统。

九、结论与决策清单

Claude Code 是遗留系统的“安全测绘仪”，不是“全自动重写器”。它把看不懂的代码变成依赖图，把隐性规则变成可签核清单，把无人敢动的模块变成有测试保护的小步变更。但最终决定成败的是人：业务专家定规则，架构师定边界，测试保行为，组织能配合。

决策者清单：

• 选一个边界清晰、低危子域做2–4周试点；
• 产出依赖图、规则溯源表、特征测试、对拍报告、成本周报；
• 不满足“有人审、有测试、可回滚、可对账”不扩大；
• KPI 看“理解老系统工时、缺陷定位、测试覆盖、小模块交付周期”，不看“AI全自动改完多少行”。

文中示例数据与场景为演示口径，仅用于说明评估和计算方法，不构成对任何真实企业成效的承诺。生产改造请以本企业试点结果为准。