← Volver a las guías

用 Claude Code 审查并重构 TypeScript 服务的实战流程

为什么先审查，再让 AI 重构

Claude Code 很适合处理真实仓库中的代码审查与重构，但正确顺序不是“把整个项目交给 AI 改写”。更可靠的做法是：先让它基于 Git Diff 找出风险、要求它说明证据与影响范围，再只对已确认的问题实施小步修改。下面以一个 TypeScript 订单金额计算服务为例，演示可复用的工作流。

如果团队需要频繁运行审查、测试修复和多轮重构，调用成本也需要控制。59API 提供与 Claude Code 兼容的 API 中转服务，基础地址为 https://api.59api.com，支持按量付费调用 Claude Opus、Sonnet、Haiku、Fable 及 GPT 模型。它使用原生官方质量模型而非降级模型，适合把 AI 审查纳入日常开发流程。

配置 Claude Code 使用 59API

先在 59API 控制台创建 API Key。macOS 或 Linux 终端中可设置以下环境变量，然后在项目根目录启动 Claude Code：

export ANTHROPIC_BASE_URL=https://api.59api.com
export ANTHROPIC_AUTH_TOKEN=你的_59API_KEY
claude

不要把 Key 写入仓库、提交到 .env.example，或粘贴到聊天记录中。建议写入本机 shell 配置或 CI 的 Secret。进入 Claude Code 后，可用 /model 查看并选择当前账户可用模型：日常 Diff 审查通常使用 Sonnet 即可；涉及复杂并发、架构边界或高风险支付逻辑时，再选择 Opus；Haiku 更适合快速生成测试清单和重复性检查。

准备一个可审查的最小变更集

假设开发者刚修改了订单折扣逻辑。先运行已有测试，再将待审代码加入暂存区，避免 Claude Code 把无关的本地实验文件也纳入上下文。

git checkout -b fix/order-discount
npm test
git add src/services/order-price.ts test/order-price.spec.ts
git diff --cached

在开始前，自己先确认 Diff 是否只包含本次任务。这个习惯非常重要：AI 的结论质量依赖输入范围，过大的 Diff 会让真正的风险被格式化修改、日志调整等噪声掩盖。

使用结构化提示词完成代码审查

启动 Claude Code 后，不要只输入“帮我 review”。应明确审查对象、禁止修改、输出格式和优先级。可以直接使用下面的提示词：

仅审查当前 Git 暂存区的 Diff，不要修改任何文件。请检查金额计算、边界条件、空值处理、并发安全性、异常处理和测试覆盖率。按 P0、P1、P2 输出问题；每项必须包含文件与函数、触发条件、为什么是问题、最小修复建议。没有证据不要猜测。最后列出你建议补充的测试用例。

例如，Claude Code 可能指出：折扣率为 0 时使用了 price || defaultPrice，导致合法的 0 被错误替换；或者优惠券金额超过商品金额时，最终价格变成负数。此时不要立即接受全部建议，而是让它继续回答：“针对 P1 问题，给出一个失败测试和预期结果，保持现有公开接口不变。”先用测试验证问题，能显著避免过度重构。

让 Claude Code 分两阶段执行重构

确认问题后，先要求设计方案，不直接授权大范围修改：

基于已确认的 P1 问题，提出最小重构计划。列出将修改的文件、每个函数的职责变化、可能影响的调用方和测试策略。不要执行修改，等待我确认。

确认计划后，再给出约束明确的执行指令：

现在执行方案：将价格计算拆分为计算商品小计、应用百分比折扣、应用固定优惠券三个纯函数；保留 calculateOrderPrice 的签名；金额不得小于 0；不要修改 API 路由或数据库层；为 0 折扣、优惠券超额、空优惠券新增测试。每完成一个文件先说明修改原因。

这种“审查—测试证明—计划—实施”的流程比一次性要求“优化代码”更可控。纯函数拆分后，业务规则也更容易被单元测试覆盖，后续规则变化可局部调整。

用命令验证 AI 修改，而不是凭感觉合并

Claude Code 修改完成后，仍应由本地工具链做最终裁决。至少执行：

git diff --check && npm test && npm run lint

接着再次请求审查，但范围只限于 AI 产生的新 Diff：“审查刚才的修改，重点寻找接口兼容性破坏、重复计算、测试断言过弱和遗漏分支；不要改代码。”最后人工阅读关键金额公式、异常路径和测试名称，再提交 Pull Request。AI 可以加速发现问题，却不能替代对业务规则的责任确认。

以较低成本建立持续审查习惯

将 Sonnet 用于常规 PR 审查和小型重构、将 Haiku 用于测试用例枚举、仅在复杂设计决策时使用 Opus，能在质量与费用之间取得实际平衡。59API 的按量计费模式适合个人开发者和小团队按任务使用，也提供推荐返利机制。若你准备把 Claude Code 接入本地开发或 CI 审查流程，可以注册 59API，创建 Key 后先从一个小型 Git Diff 开始验证效果。

Precios · Docs