1. 设计团队做 IP 头像设计 Skill 时先统一 Key 出口设计团队做 IP 头像设计 Skill 时最先要统一的不是风格词而是 Key 出口。建议在写 .env 前先去 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentip_avatar_skill_intro拿 Key并把 Base URL 填为 https://taotoken.net/api。否则同一个“开箱即用”的 IP 头像设计 Skill在 A 同学的 Claude Code 里能跑在 B 同学的 Codex 里报 401在 C 同学的 CC Switch 里又找不到 provider最后大家只能把问题归咎于提示词不稳定。这个场景很具体原文标题强调“一个超绝的 IP 头像设计Skill开箱即用”但团队落地时真正决定能否开箱即用的是配置文件是否统一。Claude Code 读 settings.json 里的 ANTHROPIC_*Codex 读 config.toml 里的 model_provider 和 Base URLCC Switch 需要三件套Base URL、API Key、Model。只要其中一个环节的出口地址不一致头像生成就可能出现风格漂移、请求超时、鉴权失败甚至不同成员拿到完全不同的结果。所以这篇不讨论“哪个头像风格更酷”而是把设计团队的 IP 头像设计 Skill 当成一个可复现工程先用 TaoToken 统一 Key 出口再写 .env再配置 Claude Code / Codex / CC Switch最后用同一套命令出图并做对照。目标产出有三件一份团队 .env 规范、一组可复制命令、一张出图对照表。把这三件事做完IP 头像设计 Skill 才算真正开箱即用。2. 从 TaoToken 官网拿 Key团队 .env 规范与目录约定第一步是拿 Key。不要在每个成员的本地工具里单独申请、单独保存而是由团队管理员到 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentip_avatar_skill_env创建团队统一 Key。建议流程是先登录官网进入控制台创建 API Key然后把 Key 写入团队的 .env.example 占位真实 .env 不提交仓库。注意写 .env 之前就把 Base URL 确认好https://taotoken.net/api。这个地址不带 UTM不带多余路径后面 Claude Code、Codex、CC Switch 都填同一个。目录建议这样组织避免每个成员把 Skill、输出图、密钥混在一起team-ip-avatar/ ├── .env.example ├── .gitignore ├── skill/ │ ├── SKILL.md │ ├── prompts/ │ │ ├── style.md │ │ └── negative.md │ └── refs/ │ └── palette.json └── outputs/团队 .env.example 可以写成下面这样。这里同时保留 TAOTOKEN_* 和 ANTHROPIC_*是为了让不同工具读各自需要的字段但真实 Key 只保留一份统一从 TaoToken 出口走TAOTOKEN_API_KEYYOUR_API_KEY TAOTOKEN_BASE_URLhttps://taotoken.net/api ANTHROPIC_BASE_URLhttps://taotoken.net/api ANTHROPIC_API_KEYYOUR_API_KEY.gitignore 至少要把 .env 和 outputs 排除掉避免密钥和中间产物被误提交.env outputs/ *.log成员拉取仓库后复制并加载环境变量cp .env.example .env # 手动编辑 .env把 YOUR_API_KEY 替换为真实 Key # 然后加载到当前 shell set -a source .env set a加载后先做三项最小检查确认 Key 和 Base URL 没有写错test -n $TAOTOKEN_API_KEY echo Key exists test $TAOTOKEN_BASE_URL https://taotoken.net/api echo Base URL OK test $ANTHROPIC_BASE_URL https://taotoken.net/api echo Claude Code Base URL OK团队规范要写清楚Key 只放 .env不写进 settings.json 并提交不写进 prompt不在聊天记录里粘贴。如果必须共享使用团队约定的密钥管理方式不要通过 Git 传递。很多“IP 头像设计Skill 开箱即用”失败不是 Skill 本身有问题而是 Key 和 Base URL 在第一步就分叉了。3. Claude Code / Codex / CC Switch 三端配置同一 Key 出口不同工具写法有了统一 Key 出口后接下来是三个常见入口的配置。注意它们的字段不一样不能互相套用。Claude Code 走 ANTHROPIC_*可以放在~/.claude/settings.json也可以放在项目级.claude/settings.json。示例{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: YOUR_API_KEY } }如果不想把 Key 写进 settings.json也可以让 Claude Code 从 shell 继承环境变量。只要确保当前终端已经执行过source .env并且ANTHROPIC_BASE_URL指向 https://taotoken.net/api 即可。Codex 不要用 ANTHROPIC_*它读的是~/.codex/config.toml。一个可复制的 provider 配置如下model gpt-5 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 报 provider not found。另一个常见问题是 Key 没有加载到 shellCodex 找不到TAOTOKEN_API_KEY于是报 401。处理方式很简单先source .env再启动 Codex。CC Switch 的三件套可以按表格填写配置项值ProviderTaoTokenBase URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEYModel按控制台可用模型填写三件套本质是地址、钥匙、模型名。配置完后让所有成员在 CC Switch 里选择同一个 TaoToken provider不要有人选默认 provider有人选本地 provider。切换完成后可以在终端验证工具是否可用claude --version codex --version如果工具启动后仍报鉴权失败先看环境变量是否生效env | grep -E ANTHROPIC|TAOTOKEN注意截图或发群前先打码不要把真实 Key 暴露出去。团队统一 Key 出口的意义就在这里同一个 IP 头像设计 Skill无论从 Claude Code、Codex 还是 CC Switch 进入最终都走 https://taotoken.net/api错误码和出图结果才可复现。4. IP 头像设计 Skill 的可复现目录角色卡、风格约束与出图命令现在进入 Skill 本身。先创建目录mkdir -p team-ip-avatar/skill/prompts mkdir -p team-ip-avatar/skill/refs mkdir -p team-ip-avatar/outputs cd team-ip-avatarskill/SKILL.md负责定义输入、输出和风格边界。可以写成类似下面的结构# IP 头像设计 Skill ## 目标 为团队成员生成统一风格的 IP 头像用于内部系统、文档署名和团队主页。 ## 输入 - 成员代号member-a - 角色气质冷静、可靠、偏技术感 - 主色深蓝 青绿 - 禁用元素写实照片、复杂背景、文字水印 ## 输出 - 正方形构图 - 面部占画面 60% 左右 - 透明背景或单色背景 - 文件命名outputs/成员代号.png ## 风格约束 - 扁平插画 / 柔和 3D 二选一团队内保持一致 - 线条干净边缘清晰 - 光照方向统一从左上到右下 - 不生成品牌 Logo、不生成真实人脸skill/prompts/style.md用来固定全团队风格不让每个人自由发挥到无法对照统一风格扁平插画干净线条柔和渐变正面半身圆形构图透明背景。 色彩主色深蓝辅助色青绿点缀暖黄。 禁止写实照片、复杂纹理、文字、边框、杂乱背景。skill/prompts/negative.md把常见跑偏项列出来不要出现真实人物照片、不要出现文字、不要出现水印、不要出现复杂背景、不要出现多余肢体。单成员出图命令可以这样写确保命令在team-ip-avatar目录下执行让工具能读到 Skillcd team-ip-avatar claude 读取 skill/SKILL.md、skill/prompts/style.md、skill/prompts/negative.md为 member-a 生成 IP 头像并输出到 outputs/member-a.png如果使用 Codex把命令换成codex 读取 skill/SKILL.md、skill/prompts/style.md、skill/prompts/negative.md为 member-a 生成 IP 头像并输出到 outputs/member-a.png批量生成时不要让每个人手动改文件名直接循环for m in member-a member-b member-c; do claude 读取 skill/SKILL.md 和 prompts 目录为 $m 生成 IP 头像输出到 outputs/$m.png done如果使用 Codex批量循环里的命令也换成codex。需要注意不同工具出图能力不同有的工具可能只返回设计描述有的工具可以继续调用后续流程。核心不是某个插件名而是输入、风格约束、输出命名一致并且所有工具都通过 TaoToken 的 Key 出口调用同一类模型。只要 Base URL 和 Key 出口统一Skill 的版本就可以被稳定复现。5. 出图对照与排障当头像风格漂移、401、404 时怎么查出图后不要只看“像不像”要做对照表。建议至少记录成员、角色气质、主色、输出文件和一致性结论成员角色气质主色输出文件风格一致性备注member-a冷静可靠深蓝青绿outputs/member-a.png通过面部占比 60%member-b活泼外向橙暖黄outputs/member-b.png通过背景透明member-c沉稳内敛灰蓝白outputs/member-c.png需复查光照方向偏右member-d创意跳跃紫青outputs/member-d.png通过线条干净对照检查按顺序走所有成员是否使用同一个 Base URLhttps://taotoken.net/api所有成员是否从 TaoToken 官网拿到了统一的 Key 出口至少是同一项目 KeyClaude Code 是否只读 ANTHROPIC_*Codex 是否只读 config.tomlCC Switch 是否只切 TaoTokenSkill 是否被正确读取确认启动目录在team-ip-avatar输出文件是否按outputs/成员代号.png命名常见报错与处理方式401 UnauthorizedKey 没加载、Key 写错、把YOUR_API_KEY原样提交。处理重新source .env检查 Key 是否替换。404 Not FoundBase URL 写成了带多余路径比如/api/v1或结尾多了斜杠。统一改为https://taotoken.net/api。provider not foundCodex 的model_provider与[model_providers.taotoken]不一致。429 Too Many Requests批量出图太集中。处理分批、错峰并在 Coding Plan 里看额度。风格漂移prompt 没被读取或成员切换了模型。处理固定 SKILL.md 版本输出前先跑一张样图。可以用下面的命令做最小检查不显示真实 Keytest $ANTHROPIC_BASE_URL https://taotoken.net/api echo Claude Code OK test $TAOTOKEN_BASE_URL https://taotoken.net/api echo Codex OK test -n $TAOTOKEN_API_KEY echo Key loaded如果想检查 .env 字段是否齐全可以把值隐藏掉grep -E BASE_URL|API_KEY .env | sed s/.*/***/这个命令只显示字段名不显示真实值适合在团队内排查配置问题。6. 团队协作收口模型对话、Coding Plan、API Keys 与 Claude Code 文档当 .env 规范、三端配置和 Skill 目录都准备好后团队协作要收口到同一个入口TaoToken。建议按下面顺序完成上线先用模型对话验证模型是否可用https://taotoken.net/models/detail/chat?utm_sourcetaotoken_aicg_blog_endutm_contentip_avatar_skill_chat团队需要稳定出图额度时查看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentip_avatar_skill_plan创建并管理 API Keyhttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentip_avatar_skill_keys按 Claude Code 文档配置 settings.jsonhttps://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentip_avatar_skill_claude如果还需要回到官网首页确认入口可以走https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentip_avatar_skill_final团队落地时建议确定三个负责人Key 管理员在 TaoToken 控制台创建、轮换 Key不把 Key 发到群里。配置管理员维护 .env.example、Claude Code settings.json、Codex config.toml、CC Switch 三件套模板。Skill 维护者维护 SKILL.md、prompts/style.md、prompts/negative.md并记录每次出图对照。最后给出一个最小可复现流程# 1. 拿到 Key 后写入本地 .env cp .env.example .env # 2. 加载环境变量 set -a source .env set a # 3. 检查 Base URL test $ANTHROPIC_BASE_URL https://taotoken.net/api echo Base URL OK # 4. 进入 Skill 目录 cd team-ip-avatar # 5. 出图 claude 读取 skill/SKILL.md 和 prompts 目录为 member-a 生成 IP 头像输出到 outputs/member-a.png # 6. 对照检查 ls -lh outputs/如果使用 Codex把第 5 步换成codex 读取 skill/SKILL.md 和 prompts 目录为 member-a 生成 IP 头像输出到 outputs/member-a.png如果使用 CC Switch先在面板里确认三件套Provider: TaoToken Base URL: https://taotoken.net/api API Key: YOUR_API_KEY Model: 按控制台可用模型填写然后把工作目录切到team-ip-avatar再执行出图命令。这样设计团队的 IP 头像设计 Skill 不再依赖某个人的本地环境。所有人从 TaoToken 官网拿 Key统一 Base URL 为 https://taotoken.net/apiClaude Code 走 ANTHROPIC_*Codex 走 config.tomlCC Switch 用三件套切换最后用同一套 .env 规范和命令出图。出图对照表一旦稳定就可以把 SKILL.md 和 prompts 纳入版本管理后续新增成员只需要复制 .env.example、替换 YOUR_API_KEY、跑一遍批量命令即可。