1. 从 401 和 404 说起先接管 Base URL再谈 IP 头像设计Skill在 Claude Code 里挂载 IP 头像设计Skill 时最常见的翻车不是 prompt 写得不够好而是请求根本没有落到正确的端点。默认配置下工具会去访问它内置的 API 地址如果你的 Key 来自 TaoToken而 Base URL 还停留在默认值终端就会抛出401 Invalid API key或404 Not Found。这时候即使 Skill 的目录结构完全正确也拿不到任何头像草稿。所以这篇实测的顺序很明确先去 TaoToken 官网拿到 Key把 Base URL 统一改成https://taotoken.net/api再回来写.env、settings.json和config.toml。TaoToken 的统一入口在这里https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentavatar_skill_intro 。访问后登录进入控制台创建 Key后面的所有工具都复用同一个 Key 和同一个 Base URL。这篇文章不会只讲概念而是把「IP 头像设计Skill」拆成可跟做的步骤准备 Key、接管 Base URL、配置 Claude Code、配置 Codex、用 CC Switch 三件套统一管理、跑两条真实命令、查看请求日志、对照 SVG 输出。你会在本地得到可渲染的头像文件也能看到每一次请求到底发到了哪里。重点不是让模型凭空画图而是让 Skill 的输出稳定落到 SVG 代码上再由本地工具渲染成 PNG。这样整条链路没有黑盒排障也更容易。先明确一个边界本文的 Skill 输出的是 SVG 矢量头像草稿不是直接调用文生图模型。它更适合做 IP 形象初稿、头像草图、风格探索。如果你需要照片级图像可以在拿到 SVG 构图后再进入其他图像流程。下面的配置全部基于 TaoToken 的 Base URLKey 占位符统一写成YOUR_API_KEY你在本地替换成真实 Key 即可。2. 在 TaoToken 官网拿 Key验证 Base URL 的最短路径2.1 创建 Key 的实际路径打开 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentavatar_skill_key 。登录后进入控制台找到 API Keys 页面。这个页面也可以直接访问https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentavatar_skill_keys 。点击创建 Key复制生成的字符串。注意不要把它提交到公开仓库本地用环境变量或.env文件保存。拿到 Key 后不要急着写进 Claude Code 的配置文件。先用一条curl命令验证 Base URL 和 Key 是否匹配。Base URL 固定为https://taotoken.net/api不要在后面额外拼/v1否则容易出现路径重复。下面这条命令以 Anthropic 兼容端点为例export TAOTOKEN_API_KEYYOUR_API_KEY curl -sS https://taotoken.net/api/v1/messages \ -H x-api-key: ${TAOTOKEN_API_KEY} \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 256, messages: [ { role: user, content: 用一句话描述一个戴眼镜的程序员头像蓝白配色极简线条。 } ] }如果配置正确你会看到类似下面的返回{ id: msg_xxx, type: message, role: assistant, content: [ { type: text, text: 戴黑框眼镜的程序员侧脸蓝色连帽衫白色背景圆形构图线条干净。 } ], usage: { input_tokens: 38, output_tokens: 46 } }如果返回401优先检查TAOTOKEN_API_KEY是否复制完整以及请求头是否用了x-api-key。如果返回404检查 URL 是否被写成了https://taotoken.net/api/v1/v1/messages。这一步验证通过后再去配置编辑器或 CLI能省掉大量来回排查时间。2.2 请求日志里要看什么一次成功的请求日志里至少应该包含这几项请求方法、完整 URL、鉴权头是否被脱敏、模型名、返回状态码、token 用量。比如[2025-06-XX 10:21:33] POST https://taotoken.net/api/v1/messages Headers: x-api-key: *** anthropic-version: 2023-06-01 content-type: application/json Body: modelclaude-sonnet-4-20250514 max_tokens256 messages1 Response: HTTP/1.1 200 OK usage: input_tokens38, output_tokens46如果你在 Claude Code 或 Codex 里看到connection error先把这条curl命令跑通。curl能通、工具不能通问题通常在工具的配置字段名或环境变量加载顺序上。curl也不通问题就在 Key、Base URL 或本地网络策略上。3. Claude Code 接管实测settings.json ANTHROPIC_* avatar-design Skill3.1 配置 settings.jsonClaude Code 读取settings.json中的env字段。推荐放在用户级目录例如~/.claude/settings.json也可以放在项目级.claude/settings.json。配置如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Read, Write, Bash(curl:*) ] } }这里的关键是ANTHROPIC_BASE_URL指向https://taotoken.net/api不是指向其他地址。ANTHROPIC_AUTH_TOKEN放你的真实 Key。不要把ANTHROPIC_*写到 Codex 的配置里Codex 使用独立的config.toml和独立的环境变量。两者混用会导致工具去读不存在的变量报出env_key not found。配置完成后可以用下面的命令检查 Claude Code 是否读取到了环境claude --version claude config list如果config list能看到ANTHROPIC_BASE_URL说明配置已经生效。接下来创建 Skill 目录。3.2 创建 IP 头像设计 Skill目录结构建议如下.claude/ skills/ avatar-design/ SKILL.md prompts/ minimal.txt cyberpunk.txt templates/ base.svgSKILL.md内容可以直接复制--- name: avatar-design description: 根据文字描述生成 IP 头像 SVG 草图支持极简、赛博朋克、手绘三种风格。 --- # IP 头像设计 Skill ## 输入 用户提供风格、角色特征、配色、用途。 ## 输出 1. 一段设计说明不超过 120 字。 2. 一份可渲染的 SVG 代码viewBox 固定为 0 0 512 512。 3. 三行修改建议。 ## 约束 - SVG 必须包含 svg 根节点。 - 不要引用外部图片。 - 颜色使用十六进制。 - 默认输出圆形头像构图。prompts/minimal.txt极简线条程序员戴黑框眼镜蓝白配色圆形头像背景透明线条粗细 6px。prompts/cyberpunk.txt赛博朋克机械耳机霓虹紫青配色暗色背景圆形头像局部高光几何切面。在 Claude Code 会话中触发 Skillclaude进入交互模式后输入/skill avatar-design 极简线条程序员戴黑框眼镜蓝白配色圆形头像如果一切正常Claude Code 会返回设计说明和 SVG 代码。把 SVG 代码保存为avatar_min.svg再用本地工具渲染。3.3 请求日志与出图Claude Code 的调试日志可以看到请求实际发往哪里[DEBUG] POST https://taotoken.net/api/v1/messages [DEBUG] modelclaude-sonnet-4-20250514 [DEBUG] streamtrue [DEBUG] headers: x-api-key***, anthropic-version2023-06-01 [DEBUG] response: 200 OK [DEBUG] usage: input_tokens412, output_tokens987拿到 SVG 后用rsvg-convert或浏览器截图渲染rsvg-convert avatar_min.svg -o avatar_min.png极简版 SVG 片段示例svg xmlnshttp://www.w3.org/2000/svg viewBox0 0 512 512 circle cx256 cy256 r240 fill#f7fbff/ circle cx256 cy220 r96 fill#e8f1ff stroke#1b4f9c stroke-width6/ rect x196 y200 width56 height40 rx8 fillnone stroke#1b4f9c stroke-width6/ rect x260 y200 width56 height40 rx8 fillnone stroke#1b4f9c stroke-width6/ path dM256 220 L256 220 stroke#1b4f9c stroke-width6/ path dM180 360 Q256 420 332 360 fillnone stroke#1b4f9c stroke-width6/ /svg赛博朋克版 SVG 片段示例svg xmlnshttp://www.w3.org/2000/svg viewBox0 0 512 512 circle cx256 cy256 r240 fill#0b1020/ path dM160 180 L352 180 L320 360 L192 360 Z fill#1b1035 stroke#00e5ff stroke-width6/ circle cx216 cy240 r28 fill#ff2bd6/ circle cx296 cy240 r28 fill#00e5ff/ rect x140 y210 width60 height90 rx12 fillnone stroke#ff2bd6 stroke-width6/ rect x312 y210 width60 height90 rx12 fillnone stroke#00e5ff stroke-width6/ path dM200 340 Q256 390 312 340 fillnone stroke#a855f7 stroke-width6/ /svg两条命令跑完后你会得到两个 PNG。极简版适合技术社区头像赛博朋克版适合游戏或直播场景。出图对照不依赖模型直接生成位图而是让模型输出结构化 SVG再由本地渲染器出图。这样做的好处是可版本控制、可微调、可复用。4. Codex 接管实测config.toml 独立配置不混用 ANTHROPIC_*4.1 为什么 Codex 不能用 ANTHROPIC_*Codex 的配置体系和 Claude Code 不同。Claude Code 读settings.json里的ANTHROPIC_*Codex 读~/.codex/config.toml并通过env_key指定环境变量名。如果你把ANTHROPIC_BASE_URL写进 CodexCodex 不会识别反而会报missing env key或provider not found。正确的做法是给 Codex 单独定义一个 provider。4.2 config.toml 可复制配置编辑~/.codex/config.tomlmodel gpt-5 model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat然后设置环境变量export TAOTOKEN_API_KEYYOUR_API_KEY运行 Codexcodex --model gpt-5 读取 .claude/skills/avatar-design/prompts/minimal.txt生成一个 512x512 的 SVG 头像只输出 SVG 代码。如果 Codex 返回401检查TAOTOKEN_API_KEY是否已经导出。如果返回404检查base_url是否多写了/v1。如果返回model not found把model换成 TaoToken 模型对话页面里列出的可用模型名。Codex 的请求日志通常在~/.codex/log/下可以看到POST https://taotoken.net/api/chat/completions providertaotoken modelgpt-5 status200 usage: prompt_tokens318, completion_tokens7424.3 Claude Code 与 Codex 的配置隔离建议把两套配置放在不同文件里不要互相引用Claude Code: ~/.claude/settings.json ANTHROPIC_BASE_URLhttps://taotoken.net/api ANTHROPIC_AUTH_TOKENYOUR_API_KEY Codex: ~/.codex/config.toml base_urlhttps://taotoken.net/api env_keyTAOTOKEN_API_KEY这样即使你同时开两个终端也不会出现 A 工具读到了 B 工具变量的问题。团队协作时把settings.json和config.toml都加入.gitignore只提交示例文件例如settings.example.json和config.example.toml。5. CC Switch 三件套settings.json、config.toml、项目级 .env5.1 三件套分别负责什么如果你同时用 Claude Code、Codex 和本地脚本推荐用 CC Switch 的思路把配置分成三件套Claude Code 的~/.claude/settings.json负责ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN。Codex 的~/.codex/config.toml负责model_providers.taotoken和env_key。项目级.env负责本地脚本、curl验证、SVG 渲染命令的公共变量。项目级.env示例TAOTOKEN_BASE_URLhttps://taotoken.net/api TAOTOKEN_API_KEYYOUR_API_KEY AVATAR_SIZE512注意TAOTOKEN_BASE_URL不要加 UTM 参数工具配置只认纯 Base URL。官网入口可以带 UTM用于访问控制台和文档https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentavatar_skill_ccswitch 。5.2 一键切换脚本可以在项目根目录放一个switch-taotoken.sh#!/usr/bin/env bash set -euo pipefail export TAOTOKEN_BASE_URLhttps://taotoken.net/api export TAOTOKEN_API_KEY${TAOTOKEN_API_KEY:-YOUR_API_KEY} echo Claude Code: echo ANTHROPIC_BASE_URL${TAOTOKEN_BASE_URL} echo ANTHROPIC_AUTH_TOKEN*** echo Codex: echo base_url${TAOTOKEN_BASE_URL} echo env_keyTAOTOKEN_API_KEY echo 本地脚本: echo TAOTOKEN_BASE_URL${TAOTOKEN_BASE_URL}执行chmod x switch-taotoken.sh source switch-taotoken.sh然后分别验证claude config list | grep ANTHROPIC_BASE_URL codex --version curl -sS ${TAOTOKEN_BASE_URL}/v1/messages \ -H x-api-key: ${TAOTOKEN_API_KEY} \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d {model:claude-sonnet-4-20250514,max_tokens:32,messages:[{role:user,content:ping}]}三件套的目标是任何工具出问题你都能在 1 分钟内定位是 Key、Base URL、模型名还是环境变量加载顺序的问题。6. 出图对照与可复现命令两版 IP 头像 Skill 的 SVG 输出6.1 复现命令在项目根目录执行mkdir -p .claude/skills/avatar-design/prompts cd .claude/skills/avatar-design claude在 Claude Code 交互模式中依次输入/skill avatar-design 极简线条程序员戴黑框眼镜蓝白配色圆形头像背景透明线条粗细 6px。把返回的 SVG 保存为avatar_min.svg。再输入/skill avatar-design 赛博朋克机械耳机霓虹紫青配色暗色背景圆形头像局部高光几何切面。把返回的 SVG 保存为avatar_cyber.svg。然后渲染rsvg-convert avatar_min.svg -o avatar_min.png rsvg-convert avatar_cyber.svg -o avatar_cyber.png如果没有rsvg-convert可以用浏览器打开 SVG 后截图或者用 ImageMagickconvert avatar_min.svg avatar_min.png convert avatar_cyber.svg avatar_cyber.png6.2 对照表维度极简版赛博朋克版主色蓝白紫青背景透明深色线条6px 均匀粗细混合元素数约 8 个约 18 个适用场景技术社区、简历直播、游戏、社群请求模型claude-sonnet-4-20250514claude-sonnet-4-20250514Base URLhttps://taotoken.net/apihttps://taotoken.net/api6.3 一次完整请求日志[2025-06-XX 10:24:18] POST https://taotoken.net/api/v1/messages Headers: x-api-key: *** anthropic-version: 2023-06-01 content-type: application/json Body: modelclaude-sonnet-4-20250514 max_tokens1024 messages1 systemavatar-design skill Response: HTTP/1.1 200 OK usage: input_tokens512, output_tokens1188 stop_reasonend_turn从日志可以看出请求确实经过https://taotoken.net/api模型名和 token 用量都可追踪。出图对照不是靠感觉而是靠可复现命令、固定 prompt、固定 SVG 约束和本地渲染器。7. 报错排查清单401、404、model not found、超时7.1 401 Invalid API key检查三处ANTHROPIC_AUTH_TOKEN是否等于真实 Key不是YOUR_API_KEY。TAOTOKEN_API_KEY是否在当前 shell 导出。请求头是否用了x-api-key而不是Authorization: Bearer混用。7.2 404 Not Found最常见原因是 Base URL 写成了https://taotoken.net/api/v1然后代码里又拼了一次/v1/messages。统一使用https://taotoken.net/api让工具或 SDK 自己补路径。7.3 model not found去 TaoToken 模型对话页面确认当前 Key 可用的模型名。不同套餐或不同 Key 权限可能对应不同模型列表。不要凭记忆写模型名。7.4 connection error / timeout先用curl -v看 DNS 和 TLS 握手。如果curl正常再检查 Claude Code 和 Codex 的配置文件是否被正确加载。Claude Code 可以跑claude config listCodex 可以检查~/.codex/config.toml是否在默认路径。7.5 Codex 报 env_key not found确认config.toml里的env_key和export的变量名完全一致。比如配置写env_key TAOTOKEN_API_KEY终端就必须有TAOTOKEN_API_KEY。不要把ANTHROPIC_AUTH_TOKEN写进 Codex。8. CTA模型对话 → Coding Plan → 创建 Key → Claude Code 文档如果你想先验证模型输出可以直接进入模型对话页面https://taotoken.net/models/detail/chat?utm_sourcetaotoken_aicg_blog_endutm_contentavatar_skill_chat 。在那里输入本文的极简版或赛博朋克版 prompt先看模型返回的 SVG 结构是否符合预期。当你要把 IP 头像设计 Skill 长期挂到 Claude Code、Codex 或本地脚本里建议查看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentavatar_skill_coding 。它更适合持续调用、批量生成头像草图和多工具共用 Key 的场景。接下来创建并管理你的 Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentavatar_skill_keys 。创建后把YOUR_API_KEY替换掉Base URL 始终填https://taotoken.net/api。Claude Code 的详细配置可以对照官方文档https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentavatar_skill_doc 。文档里会讲到settings.json、环境变量和常见问题。你也可以回到 TaoToken 官网总入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentavatar_skill_cta 从控制台统一管理模型、Key 和用量。整套流程跑通后你得到的不只是一个头像 Skill而是一套可复现的供应商接管方案Base URL 改成https://taotoken.net/apiKey 用YOUR_API_KEY管理Claude Code 走ANTHROPIC_*Codex 走config.tomlCC Switch 三件套负责隔离和切换。出图对照、请求日志、报错排查都有据可查。下一次再换任何 Skill只要沿用这套 Base URL 接管方式就能把排障时间压到最低。