1. 从一句需求到一张类图PlantUml 类图为什么值得用 AI 来写PlantUml 是一套用纯文本描述 UML 图的工具你写的是类似class 小汽车这样的声明式语句它负责把文本渲染成图片。类图是它最常用的场景之一继承、实现、组合、聚合、依赖这些关系都能用几个符号表达清楚。适合谁适合需要频繁改设计、又不想在拖拽式画图工具里反复对齐箭头的后端和架构同学。它的核心检索词就是 PlantUml 类图而真正让人头疼的地方在于语法符号多、方向控制弱、布局经常和你想的不一样。我自己的流程是这样的先用自然语言把类之间的关系讲清楚让大模型生成 PlantUml 代码再在本地渲染验证最后微调布局。问题也随之而来——如果每次生成都换一个模型、换一个 Key配置会散落在编辑器插件、命令行工具、脚本里改一次要翻好几个地方。所以我用 TaoToken 把模型调用统一到一个 Key 上AI 生成这一段就稳定了剩下的精力全放在类图本身。这篇就按这个链路走先讲清楚类图关系怎么描述再给出 TaoToken 统一 Key 的配置片段然后是可复制的类图代码和本地渲染验证步骤最后把常见的报错挨个排掉。你跟着做能拿到一张能编译、能导出、能进版本库的类图文件。2. TaoToken 前置统一 Key 与模型入口怎么配TaoToken 在这里扮演的角色是模型调用的统一入口。官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。你注册后在控制台创建一个 Key之后无论是编辑器插件、命令行还是脚本都指向同一个 Base URL 和同一个 Key模型 ID 按需切换。这一步的意义在于AI 生成 PlantUml 代码时你不用再为每个工具单独维护一套凭证。先拿 Key。打开控制台 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在 API Keys 页面新建一个复制出来。注意 Key 只显示一次丢了就重建。模型 ID 可以在模型对话页 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 里挑类图生成这种任务选一个擅长结构化输出的就行。接下来是配置。不同工具的配置文件路径不一样我按最常见的三类给你。第一类是 Claude Code 这类走 Anthropic 协议的工具配置写在~/.claude/settings.jsonWindows 是C:\Users\你的用户名\.claude\settings.json{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-5 } }第二类是 Codex 这类走 OpenAI 兼容协议的工具配置在~/.codex/auth.json{ OPENAI_BASE_URL: https://taotoken.net/api/v1, OPENAI_API_KEY: sk-你的TaoToken密钥, model: gpt-5 }第三类是 Cline、Continue 这类编辑器插件在设置里填三项Base URL 填https://taotoken.net/api/v1API Key 填你的 KeyModel ID 填你选的模型。这三件套——Base URL、Key、Model ID——缺一不可任何一项写错都会在请求阶段报错。如果你用的是 Claude Code还可以直接走 coding-plan 入口 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 它把长期编码场景的额度单独拎出来适合天天让 AI 写类图的人。配置完先别急着生成类图用一次最小请求验证连通性这一步放在第 4 节。3. 可复制配置把类图生成接进你的工作流这一节给你能直接抄的配置和提示词模板。核心思路是把「描述类关系」和「生成 PlantUml 语法」拆成两步模型输出更稳。先看提示词。不要只说「画个类图」要把关系讲全。比如请生成 PlantUml 类图代码要求 1. 抽象类 车用 abstract class 表示 2. 小汽车、自行车 继承 车用泛化关系空心三角实线 3. SUV 继承 小汽车 4. 小汽车 组合 发动机、轮胎用组合关系实心菱形实线 5. 学生 聚合 班级用聚合关系空心菱形实线 6. 学生 关联 学生证用实线 7. 学生 依赖 自行车用依赖关系带箭头虚线 只输出 startuml 到 enduml 之间的代码不要解释。把这段丢给模型它会返回类似下面的代码。注意关系符号的方向|--是泛化*--是组合o--是聚合--是依赖--是关联。方向写反了图就反了。startuml abstract class 车 class 小汽车 class 自行车 class SUV class 发动机 class 轮胎 class 学生 class 班级 class 学生证 车 |-- 小汽车 车 |-- 自行车 小汽车 |-- SUV 小汽车 *-- 发动机 小汽车 *-- 轮胎 学生 o-- 班级 学生 -- 学生证 学生 .. 自行车 enduml如果你用 Cline 或 Continue可以把上面的提示词存成一个自定义指令配合第 2 节的 Base URL、Key、Model ID 三件套一键生成。VS Code 里装 PlantUml 插件后把代码存成car.puml按AltD就能预览。这里有个坑PlantUml 渲染类图依赖 GraphvizWindows 下要单独装并配环境变量Linux 下sudo apt-get install graphviz即可。没装 Graphviz 时类图会报布局相关错误第 5 节细说。再给一个多文件场景的配置。如果你把类图拆成多个.puml文件用!include组织建议在项目根目录放一个.taotoken说明文件记录 Base URL 和模型 ID方便团队统一# .taotoken base_url https://taotoken.net/api/v1 model claude-sonnet-4-5 # Key 不要写进版本库用环境变量 TAOTOKEN_API_KEY 注入这样配置和代码分离Key 走环境变量不会误提交。生成类图时脚本读这个文件拼请求模型换了只改一行。4. 验证请求与渲染从生成到出图跑通一遍配置写完必须验证否则你分不清是 Key 错了还是类图语法错了。先做最小连通性测试用 curl 打一次模型接口curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $TAOTOKEN_API_KEY \ -H Content-Type: application/json \ -d { model: claude-sonnet-4-5, messages: [{role: user, content: 回复 ok}] }返回里有choices字段且内容正常说明 Base URL、Key、Model ID 三件套没问题。如果返回 401看第 5 节。连通后把第 3 节的提示词发过去拿到 PlantUml 代码存成car.puml。本地渲染有两种方式。第一种用 VS Code 插件装 PlantUml 插件打开.puml文件按AltD预览。第二种用命令行装 plantuml.jar 后java -jar plantuml.jar -tpng car.puml成功的话当前目录会生成car.png。如果报Dot executable does not exist或Cannot find Graphviz就是 Graphviz 没装或没进 PATH。Windows 下装完 Graphviz 要把C:\Program Files\Graphviz\bin加到系统环境变量重启终端再试。渲染出来后重点看三件事继承箭头是不是空心三角、组合是不是实心菱形、依赖是不是带箭头虚线。方向乱了就调关系符号的左右比如把学生 o-- 班级改成班级 o-- 学生或者加-left-、-right-控制。PlantUml 的布局确实是硬伤类一多就挤在一起这时候用skinparam调间距startuml skinparam classAttributeIconSize 0 skinparam nodesep 60 skinparam ranksep 80 你的类定义和关系写在这里 endumlnodesep控制节点间距ranksep控制层级间距调大一点图就松快了。实测下来类图超过 15 个类建议拆成多张图别硬塞。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错对照。第一个401 Unauthorized。原因通常是 Key 写错、Key 过期或者 Base URL 少了/v1。检查你的配置里ANTHROPIC_BASE_URL是不是https://taotoken.net/apiOpenAI 兼容的OPENAI_BASE_URL是不是https://taotoken.net/api/v1。两者路径不同混用会 401 或 404。第二个local proxy failed或连接被拒。这类多半是本地网络或代理配置问题检查你的工具是不是配了额外的代理地址把它清掉直连https://taotoken.net/api。如果公司网络有限制换网络环境再试。第三个reading choices相关报错比如error reading choices或返回体里没有choices。这通常是模型 ID 写错了或者请求体格式不对。确认model字段是你从模型对话页选的真实 ID请求体是标准的messages数组。用第 4 节的 curl 先验证能返回choices再往插件里配。第四个OAuth 相关报错。Claude Code 这类工具有时会走 OAuth 流程如果你已经用 Key 配置了ANTHROPIC_AUTH_TOKEN就不要再触发 OAuth 登录否则会冲突。检查settings.json里是不是同时存在 OAuth 凭证和 Key删掉多余的。如果报OAuth token expired说明你在用 OAuth 而不是 Key切回 Key 方式即可。还有一个类图专属的坑代码能生成但渲染报Syntax Error。这多半是模型输出的关系符号写错了比如把..写成..之外的形式或者类名带空格没加引号。类名有空格要用class 学生 证。每次生成后先本地渲染一遍再提交别直接进版本库。6. 把 AI 生成稳定落到本地类图文件走到这里链路已经通了描述关系、生成代码、本地渲染、排错。最后说几个让流程更稳的习惯。第一把提示词模板和.taotoken配置一起放进项目团队里谁生成都用同一套输出风格一致。第二类图文件进 Git每次改设计看 diff 就行比图片好审。第三模型调用统一走 TaoToken 的 Key换模型只改 Model IDBase URL 和 Key 不动配置不会散。如果你只是偶尔生成类图用模型对话页 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 手动贴提示词就够。如果天天写、还要接进编辑器去 API Keys 页 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 建个专用 Key配合接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 把三件套填对。长期做架构和 Agent 的coding-plan 入口 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 更合适。我踩过的坑是一开始把 Key 直接写进.puml旁边的脚本里提交后泄露了后来改成环境变量注入才安心。类图本身不复杂复杂的是让生成和渲染这两端稳定对接。把配置固定下来剩下的就是调布局和改关系那才是真正花时间的地方。