Codex可统一管理接口错误码:先确认是否已有集中定义,再扫描全项目生成映射表,接着补全语义与分类,最后批量替换硬编码为具名常量,全程需人工校验路径、层级和变更边界。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

让 Codex 帮你把散落在各处的接口错误码统一成一套可维护、可扩展、能自动关联业务含义的结构,而不是每次 401/500 出现都靠人肉翻文档或猜逻辑。
先确认错误码是否已集中定义
打开项目根目录,搜索 【interface ErrorResp】、【type ApiError】 或 【const ERR_】 这类关键词。如果搜到一个独立的 error.ts / api-error.ts / status-code.ts 文件,且里面包含类似 INVALID_TOKEN = 40101 的数字编码,说明已有雏形,Codex 可以在此基础上标准化;如果只在 request 拦截器里写 if (res.code === 401) 这种硬编码,那必须先让 Codex 抽出定义层,否则后续所有动作都会失效。
这一步不能跳过。Codex 不会主动帮你发现“哪里该抽象”,它只会按你给的文件路径和字段名去改——你指哪,它打哪。
用 Codex 扫描全项目并生成错误码映射表
在终端进入项目根目录,执行:
codex scan --include "src/**/*.{ts,js,tsx}" --pattern "res\.code\s*===\s*\d+" --output error-code-refs.json
这条命令会让 Codex 遍历所有 TypeScript/JS 文件,提取所有 res.code === 数字 的硬编码位置,并输出成 JSON 清单。注意:不要用 --pattern "401" 这种模糊匹配,它会把注释、URL、字符串里的 401 全扫进来,导致噪音爆炸。
执行完后检查 error-code-refs.json,确认每条记录都带文件路径和行号。如果出现大量 node_modules 或构建产物路径,立刻加 --exclude "node_modules|dist|build" 重新跑。
让 Codex 补全错误码语义与分类
把刚才生成的 error-code-refs.json 和你已有的错误定义文件(比如 src/utils/error-code.ts)一起喂给 Codex,输入指令:
通过 Telegram 命令管理 OpenAI Codex 配置文件,支持用量查询与 OAuth Token 刷新,并提供队列化安全应用(queued safe apply)及进度更新。
“基于 error-code-refs.json 中所有真实出现的 code 值,在 src/utils/error-code.ts 中补全三列:code(数字)、message(中文提示)、category(auth/network/business/data);已有定义不覆盖,只追加缺失项;category 必须从这四个值中选,不准自创。”
这一步的关键是强制 Codex 尊重已有结构。如果你只说“帮我整理错误码”,它可能直接重写整个文件,把原来团队约定的枚举顺序、注释风格、导出方式全打乱。加上“不覆盖”“只追加”“必须从四个值中选”,才能锁住变更边界。
批量替换硬编码为具名常量
第一步:确认 Codex 已识别全部目标文件。运行 codex list-files --pattern "res\.code\s*===\s*\d+",核对输出列表是否与 error-code-refs.json 一致。
第二步:执行替换命令:codex replace --files "@list" --from "res\.code\s*===\s*(\d+)" --to "res.code === ErrorCode.$1"。这里的 @list 是上一步命令的快捷引用,不是手动填路径。
第三步:Codex 会生成 Git Diff 并暂停,等你确认。重点检查两点:① 是否把 res.code === 401 错替成了 ErrorCode.CODE_401(这是错的,401 是 HTTP 状态码,不是业务码);② 是否漏掉了 res.data?.code 这类嵌套路径——Codex 默认只匹配顶层 res.code,嵌套需额外加 --deep 参数。
第四步:人工审核 Diff 后,输入 apply 执行。这步不可逆,【务必先 commit 当前分支】。










