Codex 桌宠换肤成伊蕾娜后，模型 API 改到 TaoToken 通道行不行？

给 Codex 桌宠换肤成伊蕾娜，步骤本身不复杂：把packages/ileina/pet.json和pet-runs/ileina/final/spritesheet.webp放进~/.codex/pets/ileina/，再在~/.codex/config.toml里把selected-avatar-id改成custom:ileina，重启 Codex Desktop / CodexDream 就能看到银白短发、蓝紫眼睛的伊蕾娜在桌面角落里动起来。真正需要先想清楚的是另一件事：皮肤显示正常之后，模型 API 改到 TaoToken 通道行不行？结论放前面——行，而且两条线互不干扰。桌宠皮肤只影响[desktop]和~/.codex/pets/ileina，模型请求只认model_provider和[model_providers.taotoken]里的base_url。你先打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=codex_ileina 创建 Key，再把 Codex 的 Base URL 填成https://taotoken.net/api，重启桌面端后伊蕾娜皮肤照常显示，请求也能走统一 API 通道发出去。

很多开发者卡在“以为换肤会动到模型配置”。其实 Codex 的桌宠皮肤和模型请求是两套读取逻辑：皮肤是桌面客户端的展示层，模型请求是执行层。展示层读宠物目录和[desktop]，执行层读 provider、Key、模型 ID。你完全可以在伊蕾娜皮肤不变的前提下，把 Codex 背后的请求切到 TaoToken 兼容通道。下面按原文的皮肤安装顺序走一遍，再把模型接入补上，最后给一套能复制的config.toml和排障对照。

1. 伊蕾娜皮肤和模型通道，在 config.toml 里各占一块

1.1 桌宠皮肤只认 ~/.codex/pets/ileina 和 [desktop]

Codex 桌宠皮肤的入口很固定。你从开源项目里拿到的是packages/ileina/pet.json和pet-runs/ileina/final/spritesheet.webp，安装时就是把这两个文件放到用户目录下的宠物文件夹里。pet.json描述这个宠物的元数据，spritesheet.webp是动画精灵图。桌面端启动后，会去~/.codex/pets/下面找已经被选中的自定义宠物 ID，然后把对应图片渲染到桌面上。

配置文件里与皮肤有关的，是~/.codex/config.toml的[desktop]段。原文写得很清楚：selected-avatar-id = "custom:ileina"，再加上一个叠层宽度avatar-overlay-mascot-width-px = 224。这一段只控制桌宠显示，不参与模型请求，也不负责鉴权。换句话说，哪怕你把 provider 改成别的兼容通道，桌宠皮肤仍然按这个 ID 去找~/.codex/pets/ileina/里的资源。

这也是很多人问“换肤后能不能改模型 API”的根因：他们看到两个配置都写在同一个config.toml里，就担心互相覆盖。实际上 TOML 表之间是分开的，[desktop]管显示，[model_providers.*]管请求。安装皮肤和生成皮肤的过程本身不消耗 Token；只有 Codex 真正向模型发请求时，才会产生用量。

1.2 模型请求只认 model_provider 和 [model_providers.taotoken]

模型这一侧，Codex 会先看顶层model_provider指向哪个 provider，再看对应的[model_providers.<id>]表里base_url、env_key怎么填。你要接 TaoToken 兼容通道，核心就是新增一个 provider 段，把base_url写成https://taotoken.net/api，注意末尾不要带/v1。Key 不要直接硬编码进配置文件，而是通过环境变量交给 Codex 读取。

这个结构和皮肤的[desktop]没有任何冲突。你可以在同一个config.toml里同时保留：

• [desktop]：伊蕾娜桌宠选择；
• model_provider = "taotoken"：模型请求走统一通道；
• [model_providers.taotoken]：Base URL 和 Key 环境变量名。

只要三块都写对，重启 Codex 桌面端后，皮肤显示和模型请求会各走各的。先确认这一点，后面的配置就不会畏手畏脚。

2. 照原文装好伊蕾娜皮肤：pet.json、spritesheet.webp、selected-avatar-id

2.1 手动放置 packages/ileina/pet.json 与 final/spritesheet.webp

如果你不想跑安装脚本，可以按原文的手动方式做。先创建宠物目录，再把项目里的两个关键文件复制过去。目录名要和配置里的custom:ileina对应，大小写也别随手改。推荐目录结构如下：

~/.codex/pets/ileina/ ├── pet.json └── spritesheet.webp

Windows 下路径通常是C:\Users\你的用户名\.codex\pets\ileina\。macOS / Linux 下是~/.codex/pets/ileina/。复制时注意文件名：packages/ileina/pet.json改为~/.codex/pets/ileina/pet.json，pet-runs/ileina/final/spritesheet.webp改为~/.codex/pets/ileina/spritesheet.webp。不要多套一层final，否则桌面端找不到精灵图。

原文还给了 PowerShell、Node.js 和手动安装三种方式。你如果直接用脚本，效果一样，脚本最终也是把文件放到这个目录，再改config.toml。这里建议先手动确认一次目录结构，因为后面排障时，80% 的“皮肤不显示”都是路径或文件名不对。

2.2 在 config.toml 里选中 custom:ileina 并重启

文件放好之后，打开~/.codex/config.toml，加上或修改[desktop]段。原文的配置是：

[desktop] selected-avatar-id = "custom:ileina" avatar-overlay-mascot-width-px = 224

改完后完全退出 Codex Desktop / CodexDream，再重新打开。不要只关窗口，托盘进程也退出干净，否则它可能继续读旧配置。重启后如果桌宠变成伊蕾娜，说明皮肤链路已经通了。

如果你还没准备模型 Key，这一步不着急拿。你可以先去 TaoToken 控制台 注册并创建 API Key，Key 先放好，等下一节再写进 Codex 的模型 provider 配置。这里先确保皮肤没问题，再动模型请求，排障范围会清楚很多。

3. 把 Codex 模型 API 改到统一兼容通道：先拿 Key，再写 model_providers

3.1 在控制台创建 YOUR_API_KEY，模型 ID 以模型广场为准

模型接入的第一步是拿到 Key。打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=codex_ileina_console ，在控制台里创建一把 API Key。创建后得到的字符串不要直接写进公开仓库，也不要用截图发出来。本文所有示例统一用YOUR_API_KEY占位，你实际使用时替换成自己创建的那把。

模型 ID 不要凭印象写。比如你想用某个模型，先到模型广场看当时可用的模型 ID，再填到 Codex 的model字段。不同时间模型列表会变，本文不写死某个型号，也不建议你从旧文章里抄一个带日期后缀的 ID。模型广场里显示什么，就填什么；如果填错，Codex 通常会报模型不存在或 provider 返回错误。

Key 的权限、额度和用量都在控制台里看。你后面验证请求是否走了统一通道，也是回到控制台看调用记录和用量。注意区分：官网地址用于注册、创建 Key、看模型、看用量；填进 Codex 的 Base URL 是https://taotoken.net/api，不要给接口地址加 UTM，也不要写成带/v1的路径。

3.2 在 ~/.codex/config.toml 增加 provider 段

Codex 的模型配置不要套 Claude Code 那套ANTHROPIC_*环境变量，它读的是自己的config.toml。把顶层model和model_provider放在文件靠前的位置，再保留[desktop]，最后加[model_providers.taotoken]。一个可复制的结构如下：

model = "YOUR_MODEL_ID" model_provider = "taotoken" [desktop] selected-avatar-id = "custom:ileina" avatar-overlay-mascot-width-px = 224 [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY"

这里有几个点要盯住。第一，model_provider的值taotoken要和表名[model_providers.taotoken]对得上，大小写一致。第二，base_url只写到https://taotoken.net/api，不要手痒加/v1。第三，env_key写的是环境变量名，不是 Key 本身。你的 Codex 版本如果要求显式写wire_api，按 Codex 当前配置文档和模型广场标注选择；不确定时先不要抄旧配置里的字段。

然后在终端里设置 Key。macOS / Linux 可以写进~/.zshrc或~/.bashrc：

export TAOTOKEN_API_KEY="YOUR_API_KEY"

Windows PowerShell 可以用：

setx TAOTOKEN_API_KEY "YOUR_API_KEY"

setx之后要重新打开终端和 Codex 桌面端，新环境变量才会被读到。如果你只是在当前窗口临时 export，重启桌面端后它不一定继承得到。

3.3 不要把 ANTHROPIC_* 变量套到 Codex 上

很多人同时用 Claude Code 和 Codex，容易把两边的配置混在一起。Claude Code 走的是ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL这一类环境变量，而 Codex 走~/.codex/config.toml里的model_provider和[model_providers.*]。你不能在 Codex 的配置文件里写ANTHROPIC_BASE_URL指望它生效，也不能把base_url填成 Claude Code 文档里的地址。

本篇只处理 Codex。你要接统一兼容通道，就老老实实写model_providers.taotoken。如果你同时还用 Claude Code，那是另一份配置，不要互相复制。把两条链路分开之后，伊蕾娜皮肤不会因为模型 provider 变化而消失，模型请求也不会因为桌宠换肤而中断。

4. 重启 Codex 桌面端后的验证：伊蕾娜还在，请求也出发了

4.1 看桌宠是否仍然是 custom:ileina

保存config.toml后，先彻底退出 Codex Desktop / CodexDream，再重新启动。观察两个点：桌宠是不是伊蕾娜，叠层宽度是不是接近你设置的224。如果桌宠正常，说明[desktop]和~/.codex/pets/ileina/没被破坏。此时模型 provider 的变化不会影响皮肤渲染。

如果桌宠没出现，先别怀疑统一通道。回到~/.codex/pets/ileina/检查pet.json、spritesheet.webp是否都在，检查selected-avatar-id是否写成custom:ileina，再检查是不是复制成了~/.codex/pets/ileina/final/spritesheet.webp。皮肤链路和模型链路分开排查，能省很多时间。

4.2 发一条消息，再去控制台看这次调用

皮肤确认后，在 Codex 里发一条短消息，比如让它解释一段配置或重写一段注释。如果 Codex 能正常回复，说明模型请求至少没有立刻失败。接着打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=codex_ileina_usage ，在控制台看这次调用有没有记上。用量记录对得上，基本就说明 Codex 的请求已经从你填写的base_url发出去。

也可以去 模型对话 用同一把 Key 发一条测试消息，确认 Key、模型 ID、Base URL 三者一致。模型对话适合做最小验证：如果那边能通，Codex 这边还报错，就优先查 Codex 的配置文件位置和环境变量继承；如果那边也不通，就优先查 Key 和模型 ID。

5. 排障：皮肤不显示、401、Base URL 多 /v1、模型 ID 不对

5.1 皮肤不显示，先别改模型 provider

皮肤不显示通常和模型配置无关。先查~/.codex/pets/ileina/下是否有pet.json和spritesheet.webp，再查config.toml的[desktop]段是否写了selected-avatar-id = "custom:ileina"。如果是从仓库复制，注意不要复制成~/.codex/pets/ileina/ileina/pet.json这种多套一层目录。改完重启 Codex 桌面端，而不是只刷新窗口。

5.2 401：Key 没进环境变量，或者 Key 不是这把

401 基本是鉴权问题。先在终端确认TAOTOKEN_API_KEY是否能被当前用户读到，Windows 下setx后要重开终端。再确认config.toml里的env_key写的是TAOTOKEN_API_KEY，不是别的名字。最后确认这把 Key 是在控制台创建的，没有复制漏字符。不要为了省事把 Key 直接写进config.toml，环境变量更适合本地开发，也更不容易误提交。

5.3 404 或路径错误：base_url 写成 https://taotoken.net/api/v1

填工具里的 Base URL 必须是https://taotoken.net/api，末尾不带/v1。如果你写成https://taotoken.net/api/v1，有的请求路径会拼接成重复路径，表现可能是 404，也可能被 provider 返回“路径不存在”。同样，不要给这个接口地址加?utm_source=...之类的参数，UTM 只用于官网落地页和 deep link。

5.4 模型 ID 从模型广场抄，不要凭记忆填

Codex 的model字段必须填当前可用的模型 ID。不同模型广场列表会更新，旧文章里的 ID 不一定还在。你打开官网看模型广场，把对应 ID 复制到config.toml的model字段。如果报“模型不存在”或“不支持”，先换一个模型 ID 测试，不要急着改 Base URL。

6. 自定义桌宠皮肤和 Token 消耗：皮肤不消耗，模型请求才记账

6.1 按原文的 8×9 精灵图流程做自己的角色

原文项目里保留了完整的皮肤生成记录，包括pet_request.json、基础提示词、拆帧目录和最终校验结果。如果你想做自己的角色，可以沿着这套流程走：生成绿幕角色图，按状态排出横向精灵条，合成一张 8×9 的 WebP，再写一份pet.json放进~/.codex/pets/<id>/。最后在config.toml里选择custom:<id>。这套流程和模型 API 无关，你不需要因为换了 provider 就重做皮肤。

注意，生成皮肤素材时如果用了外部模型，那属于你的素材生产流程；但“安装皮肤并在 Codex 桌面端显示”本身不会向模型发请求，也不会消耗 Codex 的 Token。不要把桌宠动画和模型调用混为一谈。皮肤文件是静态资源，模型请求是运行时行为，两者记账的地方也不同。

6.2 统一通道用量只在模型请求时产生

当你把 Codex 的模型请求接到统一兼容通道后，只有实际发起的对话、补全、代码解释等请求才会产生用量。控制台里看到的调用记录，对应的是这些模型请求，不是桌宠动画帧数。你可以把伊蕾娜皮肤一直开着，不去发消息，就不会产生模型调用。反过来，模型请求正常也不代表皮肤一定会显示，二者只是共用了一个config.toml文件。

如果你在 Codex 里让它生成代码或解释报错，注意 Codex 只能生成、解释、对照代码或 SQL。需要执行诊断 SQL、编译、运行命令时，由你在本地终端或对应客户端执行，再把输出贴回对话。AI 编程工具不应该被当成直连生产库或生产机器的执行器。这一点和桌宠换肤无关，但接模型通道后更要保持习惯。

7. 下一步：用同一把 Key 在模型对话里测一次，长期用看 Coding Plan

7.1 先在模型对话确认 Key 和模型 ID

配置写完、Codex 重启后，建议先去 模型对话 用同一把YOUR_API_KEY发一条测试消息。这里能帮你把变量缩小：模型对话通、Codex 不通，重点查 Codex 的config.toml和环境变量；两边都不通，重点查 Key、模型 ID 和 Base URL 是否写错。模型对话里也可以顺便确认模型广场里当前可用的 ID。

7.2 要长期写代码，看 Coding Plan，Key 在控制台

如果只是偶尔在 Codex 里问几句，按量用即可。如果你准备把 Codex 当成日常写代码工具，可以打开 Coding Plan 看套餐是否够用。Key 的管理和新建仍然在 控制台 API Keys 里做。若你同时也在用 Claude Code，环境变量对照可以看 接入文档 ，但不要把 Claude Code 的变量套到 Codex 上。

配完这次 Codex 的model_providers.taotoken之后，先去控制台看一眼刚才那条测试消息有没有记上用量，就能确认伊蕾娜桌宠背后的请求是不是已经从https://taotoken.net/api正常发出。