重构的代码刚合并进主干仓库里那张架构图就成了历史文件。这次我没再打开 draw.io 手动画一遍而是先到 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentarchify_topology_rerun 拿了一把 API Key把 Base URL 指向 https://taotoken.net/api然后让 Claude Code 驱动 Archify 把整个仓库重新读了一遍重跑了一次拓扑验证。先说清楚为什么要先解决模型入口这件事。Archify 这类 Agent Skill 的工作方式是读你本地的代码文件产出一份结构化的 JSON 中间表示IR再由引擎做原子化校验最后确定性地编译成 HTML/SVG。这个链路里 AI 要反复读文件、反复改 IR、反复重试一次生成动辄几十轮工具调用。如果模型入口不稳定、上下文长度不够、或者每轮都在换供应商验证过程就会卡在改一半失败上比手动画图还耽误时间。把入口固定成 TaoToken 之后Claude Code 和 Codex 可以共用同一个端点我只需要维护一份 KeyArchify 的多次重跑就不会因为鉴权或限流中断。这篇文章按维护者的视角写重构前先生成一张基线图重构后重新生成一张中间那份 Delta 用来做评审最后沉淀一份可以照着勾的重新验证清单。所有命令都在你本地仓库执行。1. 重构完的第一件事是把过期的拓扑重跑一遍先说痛点。手动画架构图的成本不在画这个动作而在维护。在画布软件里拖方框、对齐、连线半小时能出一张看着挺像样的图两周后一次模块拆分这张图立刻失去参考价值而重画一次又要半小时——于是没人画了它就静静躺在 docs 目录里等着误导下一个接手的人。后来大家改用让模型直接生成 Mermaid 贴进文档。省事是真省事但布局引擎排出来的图经常节点重叠、箭头交叉放进正式方案里需要手动调很久。更麻烦的是幻觉你让它照着仓库画一张架构图它可能顺手补一个根本不存在的事件总线或者画一条从来没实现过的调用关系。图看起来头头是道拓扑却是错的而这种错误在评审会上极难被发现因为它看起来很像真的。所以画图这件事的真正难点只有两个词准确、及时。图要对得上真实系统还要跟得上代码变化。Archify 的做法是把画图拆成两步。第一步AI 产出类型化的 JSON IR把系统描述成结构化数据第二步引擎对这份数据做原子化校验一条不过就打回AI 拿到的是可以逐条修复的诊断清单改完再验通过之后才允许编译成图。节点还能关联到真实的文件路径——你说这个模块负责鉴权那就把文件路径亮出来AI 想编一个不存在的服务过不了验证这一关。它内置五种图表类型拿不准选哪种的时候按你想回答什么问题来挑图表类型回答的问题架构图系统有哪些服务、怎么分层、依赖关系是什么工作流一个业务流程从头到尾怎么走时序图一次调用在组件之间来回传消息的时间线数据流图数据从哪来、经过什么加工、落到哪里生命周期图一个对象或任务从创建到消亡的状态流转重构场景用架构图加 Delta 视图就够了。2. 先把模型入口固定下来Claude Code 的 settings.json 与 ANTHROPIC_ 三件套在装 Archify 之前先确认 Claude Code 走的是你自己的模型入口。这一步做完之后后面所有的重跑验证才有稳定的前提。Key 在这里拿https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentarchify_key_createClaude Code 的配置分两种写法选一种即可。第一种是写进用户级或项目级的settings.json{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: 从模型列表里挑一个支持长上下文的模型, ANTHROPIC_SMALL_FAST_MODEL: 从模型列表里挑一个便宜快速的模型 } }ANTHROPIC_MODEL控制主对话用哪个模型Archify 读代码、改 IR 这种需要长上下文的活儿建议挑上下文窗口大的ANTHROPIC_SMALL_FAST_MODEL用于标题生成、简单判断之类的小任务挑便宜的就行。两个值都从控制台的模型列表里复制不要凭记忆手写。第二种是走环境变量适合临时在某个终端会话里试export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODEL模型 ID export ANTHROPIC_SMALL_FAST_MODEL模型 ID配置完先做一次最小验证别急着跑 Archifyclaude -p 只回答两个字通了能正常返回就说明入口是通的。如果返回 401先检查ANTHROPIC_AUTH_TOKEN有没有多余空格如果返回 404检查ANTHROPIC_BASE_URL是不是被误加了路径后缀——Base URL 就是https://taotoken.net/api不要自己在后面拼/v1。顺便说一个和重构验证直接相关的点Archify 在重跑时要读几十上百个文件如果主模型上下文偏小中途会开始遗忘前面读过的文件产出的 IR 里就容易出现对不上的节点。这也是我建议重构场景专门切一个长上下文模型的原因。3. Codex 用 config.tomlCC Switch 管切换别把 ANTHROPIC_ 抄到 Codex 里这一段是给同时在用多个客户端的人看的。最常见的错误是把 Claude Code 的ANTHROPIC_*变量原样抄进 Codex 的配置里——这两个客户端的配置体系完全不同抄过去只会得到一个连不上的客户端。Codex 用的是~/.codex/config.toml走的是 OpenAI 兼容风格的自定义 providermodel 从模型列表里选一个擅长读代码的模型 model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api responses对应的 Key 放在环境变量里不要明文写进配置文件export TAOTOKEN_API_KEYYOUR_API_KEY注意base_url的取值以 TaoToken 控制台或文档给出的 OpenAI 兼容端点为