1. 满屏圆角框不是主题问题定位 Codex 架构图 Skill 的模型出口最近在给 Codex 加架构图 Skill 时又碰到那个很具体的问题Skill 能跑通节点和连线也都在但导出的架构图满屏都是圆角框分组边界、子系统边界和部署边界糊在一起。排查后发现渲染层其实没有写死圆角真正影响风格的是 Skill 调用的模型出口。为了把出口换成更可控的 TaoToken我先到官网入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentcodex_arch_skill_intro 拿了 KeyBase URL 使用 https://taotoken.net/api。本文按 API 集成工程师的视角把 endpoint 替换步骤、Codex config.toml、调用日志和排障记录完整写出来目标是让架构图 Skill 再出图时不再被默认圆角框淹没。很多人第一次遇到“满屏圆角框”会下意识去改主题文件比如把border-radius改成 0或者换一套 SVG 模板。这样做有时有效但问题会反复出现因为架构图 Skill 的流程通常是两段式第一段由模型根据提示词生成结构化描述比如节点、分组、连线、层级第二段由渲染器把结构化描述转成 SVG 或 PNG。圆角框只是最终表现真正决定“要不要用圆角矩形表达分组”的是模型在结构化阶段输出的shape、style、group.type等字段。如果模型出口不稳定同一套渲染模板也会被喂进不同的结构最后看起来就像主题失效。这次要换的 endpoint 并不复杂核心只有两个值TaoToken 的 Base URL 和 API Key。Base URL 固定为https://taotoken.net/apiKey 使用占位符YOUR_API_KEY。但作为 API 集成工程师不能只改一个环境变量就结束还要确认 Codex 的config.toml是否真正接管了 provider确认架构图 Skill 是走 Codex CLI 还是自己发 HTTP 请求确认 Claude Code、CC Switch 的配置不会串到 Codex 环境里。下面按可复现的顺序展开。2. 拿 Key 与 Base URL在 TaoToken 官网准备 Codex 的调用凭证换 endpoint 之前先把凭证准备好。打开 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentcodex_arch_skill_key 进入控制台后创建 API Key。建议给这个 Key 起一个能区分用途的名字比如codex-arch-skill不要和 Claude Code、其他脚本共用同一个 Key。这样后续看日志时能快速判断某次 401 是哪个工具造成的。创建完成后你会拿到一串 Key。本文统一用YOUR_API_KEY代替实际配置时请换成真实值。不要把 Key 写进仓库里的config.toml并提交推荐用环境变量注入。Codex 侧建议使用TAOTOKEN_API_KEY这个变量名不要用ANTHROPIC_API_KEY或ANTHROPIC_AUTH_TOKEN因为 Codex 的 provider 配置和 Claude Code 的 Anthropic 兼容配置是两套体系混用会让排障变得很麻烦。准备清单可以按下面四项核对TaoToken 账号可登录控制台能看到 API Key 管理入口。已创建独立 Key记录 Key 名称和创建时间。确认 Base URL 为https://taotoken.net/api不要自行拼接/v1或额外路径。确认本机 Codex 版本支持model_providers配置。如果版本较旧先升级 Codex CLI。如果后面要让架构图 Skill 直接发 HTTP 请求而不是通过 Codex CLI 转发那么还需要准备一组 OpenAI 兼容环境变量。此时仍然建议使用独立的 Key并且只在当前 shell 会话中导出不要写进全局配置文件。例如export TAOTOKEN_API_KEYYOUR_API_KEY export OPENAI_BASE_URLhttps://taotoken.net/api export OPENAI_API_KEY$TAOTOKEN_API_KEY注意这里的OPENAI_API_KEY只是为了兼容部分 Skill 内部的 HTTP 客户端。Codex 本身仍然优先读取config.toml中的 provider 配置。下一节会把 Codex 的配置写清楚避免出现“环境变量改了但 Codex 没走新 endpoint”的假成功。3. 替换 endpointCodex config.toml 与架构图 Skill 的三处改动Codex 的 provider 配置写在~/.codex/config.toml。如果你使用项目级配置也可能是仓库根目录下的.codex/config.toml具体以codex --help和当前版本说明为准。下面给出一份最小可用配置把默认 provider 指向 TaoToken# ~/.codex/config.toml model gpt-4o model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat这份配置里有三个关键点。第一model_provider必须和[model_providers.taotoken]的节名一致否则 Codex 会继续走默认出口。第二base_url使用https://taotoken.net/api不要带 UTM 参数也不要写成https://taotoken.net/api/v1。第三env_key指定的是环境变量名不是 Key 本身。你还需要在启动 Codex 的 shell 里导出这个变量export TAOTOKEN_API_KEYYOUR_API_KEY codex --profile taotokenWindows PowerShell 可以这样写$env:TAOTOKEN_API_KEY YOUR_API_KEY codex --profile taotoken接下来是架构图 Skill 的三处改动。不同 Skill 的实现方式不一样但通常离不开以下三种入口按顺序检查即可。第一处Skill 如果通过codex exec调用模型那么它继承的是 Codex 的 provider 配置。你不需要在 Skill 里再写一遍 Base URL只要确认执行 Skill 的进程环境里有TAOTOKEN_API_KEY并且 Codex 读取的是你改过的config.toml。可以用下面的命令验证codex --profile taotoken exec 只输出当前 provider 和 base_url不要执行其他操作如果日志里出现providertaotoken和base_urlhttps://taotoken.net/api说明第一处已经接管。第二处Skill 如果自己维护config.yaml、settings.json或.env里面可能写死了旧的 endpoint。把其中和模型出口相关的字段改成provider: taotoken base_url: https://taotoken.net/api api_key_env: TAOTOKEN_API_KEY如果字段名是endpoint、api_base、openai_base_url值都指向https://taotoken.net/api。不要在这个文件里写 Claude Code 的ANTHROPIC_BASE_URL那是另一套配置。第三处Skill 如果带缓存目录比如.cache/architecture-diagram、tmp/skill-output换 endpoint 后先清一次缓存。否则它可能继续复用旧模型返回的结构化描述导致你误以为 endpoint 没生效。清理命令由你在本地执行例如rm -rf .cache/architecture-diagram rm -rf tmp/skill-output三处改完后重启 Codex 会话和 Skill 进程。不要只重跑 Skill 而不重启 Codex因为 provider 配置通常在进程启动时加载。到这里endpoint 替换动作就完成了下一节用调用日志确认真实出口。4. 再出图验证Codex 调用日志、SVG 输出与圆角参数检查验证时不要只看“有没有出图”要看日志里的 provider、base_url、model 和 Skill 内部参数。下面是一段示例调用先生成一张订单系统的部署架构图要求分组框直角、节点圆角为 0codex --profile taotoken exec 调用 architecture-diagram skill生成订单系统的部署架构图。要求分组框使用直角矩形节点 cornerRadius0箭头水平或垂直输出 arch-order.svg对应的 Codex 调用日志可以重点看这些行[codex] profiletaotoken [codex] providertaotoken [codex] base_urlhttps://taotoken.net/api [codex] modelgpt-4o [skill:architecture-diagram] load config ok [skill:architecture-diagram] plan nodes8 edges11 groups3 [skill:architecture-diagram] render corner_radius0 [skill:architecture-diagram] outputarch-order.svg [codex] elapsed18.4s如果日志里出现base_urlhttps://taotoken.net/api说明 Codex 已经走 TaoToken。如果 Skill 日志里出现corner_radius0说明提示词约束被渲染器接收。接下来检查 SVG 输出不要只看 PNG 预览。SVG 里可以直接搜索这些属性grep -n rx\|ry\|border-radius arch-order.svg如果还有大量rx8、ry8或border-radius: 8px说明圆角来自渲染模板而不是模型出口。此时要分两种情况处理情况一模型返回的结构里明确要求圆角分组。检查 Skill 的提示词是否包含“所有分组框使用直角矩形”“不要使用圆角矩形表示系统边界”等约束。情况二模型返回的结构正确但渲染器默认给所有rect加了圆角。这时需要改本地渲染模板或主题文件把默认cornerRadius改为 0。换 endpoint 的价值在于你可以选择对结构化输出更稳定的模型并在提示词里固定输出格式。比如在 Skill 的 prompt 中加一段输出 JSON 时必须遵守 1. 分组节点 type 固定为 groupshape 固定为 rect。 2. 所有节点的 cornerRadius 必须是 0。 3. 不允许输出 roundedRect、stadium、pill 等形状。 4. 连线使用正交路由禁止曲线。这段约束配合 TaoToken 的模型出口能显著减少“满屏圆角框”反复出现。每次出图后保留一份日志和 SVG后续对比模型响应变化时会有依据。5. Claude Code 与 CC Switch 三件套不要把 ANTHROPIC_* 写进 Codex很多团队同时用 Codex 和 Claude Code配置容易串。这里必须强调Codex 用config.tomlClaude Code 用settings.json和ANTHROPIC_*两者不要互相复制。Claude Code 的典型配置如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: claude-3-5-sonnet-20241022 } }这份配置放在 Claude Code 的settings.json中或者通过 CC Switch 管理。CC Switch 三件套可以理解为供应商名称、Base URL、Token。映射到 Claude Code 体系里就是ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL。如果你用 CC Switch 保存多套配置建议单独建一个名为taotoken的条目{ name: taotoken, base_url: https://taotoken.net/api, api_key: YOUR_API_KEY, model: claude-3-5-sonnet-20241022 }再次提醒上面这些ANTHROPIC_*字段只用于 Claude Code不要写进 Codex 的config.toml。Codex 侧只认TAOTOKEN_API_KEY、base_url https://taotoken.net/api和model_provider taotoken。如果你在 Codex 的 Shell 里同时导出了ANTHROPIC_AUTH_TOKEN通常不会直接影响 Codex但会让日志排障更混乱建议分终端会话运行。如果你需要把 Codex、Claude Code、CC Switch 的配置都集中管理可以按工具拆目录~/.codex/config.toml ~/.claude/settings.json ~/.cc-switch/providers/taotoken.json每个文件只负责自己的工具Key 通过各自的环境变量注入。这样当架构图 Skill 出问题时你能快速判断是 Codex provider 没生效还是 Claude Code 配置被误改。更多 Claude Code 接入细节可以看 TaoToken 的文档文末会给出带参数的入口。6. 常见报错与排障401、404、流式中断、模型名不匹配换 endpoint 后最常见的四类报错如下。第一类401 Unauthorized。优先检查TAOTOKEN_API_KEY是否在当前 shell 生效。可以用echo ${TAOTOKEN_API_KEY:0:6}只打印前几位确认变量不是空值。如果变量存在但仍 401检查 Key 是否被删除、是否复制时带了空格、是否在 Codex 启动后才导出。Codex 进程启动后再改环境变量通常无效需要重启会话。第二类404 Not Found。多数情况是 Base URL 写错比如写成了https://taotoken.net/api/v1、https://taotoken.net/api/chat或者末尾多了斜杠导致路径拼接异常。按本文约定Base URL 固定为https://taotoken.net/api。如果某个 Skill 内部会自动拼接/v1/chat/completions也不要手动重复加/v1。第三类流式中断。表现是 Codex 日志开始有响应但中途断开Skill 只拿到半截 JSON。优先检查超时设置和网络代理环境变量。把超时调到 60 秒以上重试次数设为 2。对于架构图这种需要生成较长结构的任务建议关闭过短的流式超时或者在 Skill 层做一次完整响应校验失败后重新请求。第四类模型名不匹配。不同 provider 支持的模型名不一样Codex 的config.toml里写gpt-4o只是一个示例。你需要根据 TaoToken 控制台或模型列表确认可用模型名。如果模型名错误通常会返回 400 或 404并在响应体里提示 model not found。遇到这种情况先改回一个确认可用的模型再排查 Skill 是否把模型名写死在了自己的配置文件里。还有一类不算报错但很常见endpoint 已经换了圆角框却没消失。这时按第 4 节的顺序检查 SVG 属性、Skill prompt、渲染模板。不要把所有问题都归因于 endpoint模型出口只负责结构化输出最终形状由渲染器决定。7. 稳定出图的工程化建议超时、重试、缓存与提示词约束如果你要把这套流程放到 CI 或团队共享环境里建议加几层工程化约束。第一固定模型和参数。把 Codexconfig.toml中的model、provider、Base URL 固化不要依赖开发者本机默认值。对于架构图 Skill可以把 temperature 调低减少形状字段的随机变化。第二给 Skill 加输出校验。模型返回 JSON 后先校验必需字段比如nodes、edges、groups、shape、cornerRadius。如果cornerRadius不是 0可以在渲染前强制覆盖为 0或者在 prompt 中再次强调。这样即使模型偶尔返回了圆角结构最终图也不会失控。第三设置超时和重试。建议单次请求超时 60 秒失败重试 2 次并记录每次请求的耗时和 provider。日志里至少包含provider、base_url、model、skill、output五个字段。不要记录完整 API Key只记录 Key 名称或前几位。第四缓存结构化结果。架构图生成通常不需要每次都重新推理。可以按「项目名 版本 模型名」做缓存换 endpoint 后清一次缓存。这样既能减少重复调用也能让同一版本的架构图保持稳定。第五提示词里明确形状约束。不要只写“画一张架构图”要写清楚“分组框直角、节点圆角 0、禁止圆角矩形、使用正交连线、输出 SVG”。如果 Skill 支持 schema最好把形状字段做成枚举避免模型自由发挥。第六区分 Codex 与 Claude Code 的环境。Codex 的config.toml和 Claude Code 的settings.json分开维护CC Switch 三件套只服务 Claude Code。团队共享时可以提供一个.env.example里面只放TAOTOKEN_API_KEYYOUR_API_KEY和OPENAI_BASE_URLhttps://taotoken.net/api真实 Key 由各成员本地注入。做到这几点后Codex 架构图 Skill 的 endpoint 替换就不仅是“改一个地址”而是一套可复现、可排障、可交接的接入流程。下次再遇到满屏圆角框你可以先看 Codex 调用日志再看 Skill 的渲染参数而不是盲目换主题。8. 文末 CTA从模型对话到 Coding Plan再到创建 Key 与 Claude Code 文档如果你还没准备 Key建议按下面路径走一遍。先到 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentcodex_arch_skill_cta 了解模型能力再到模型对话页面快速验证提示词和模型名https://taotoken.net/models/detail/chat?utm_sourcetaotoken_aicg_blog_endutm_contentcodex_arch_skill_chat如果你打算把 Codex、Claude Code 和架构图 Skill 长期放在一起用可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcodex_arch_skill_plan确认方案后到控制台创建或管理 API Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentcodex_arch_skill_keys最后如果你同时使用 Claude Code配置方式与 Codex 不同参考 Claude Code 文档https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentcodex_arch_skill_doc把 Codex 的config.toml指向https://taotoken.net/api用TAOTOKEN_API_KEY注入YOUR_API_KEY再跑一次架构图 Skill查看调用日志里的providertaotoken和base_urlhttps://taotoken.net/api。确认无误后清掉旧缓存重新生成 SVG。这样再出图时满屏圆角框的问题会更容易定位也更容易被提示词和渲染参数彻底约束住。